Files
op-packages/luci-app-dae/README.md
T

14 KiB
Raw Blame History

luci-app-dae

dae 内核的 OpenWrt / ImmortalWrt 软件包与 LuCI 页面。面板(doona)的源码在 szwjp/doona,但它的包在这里构建:本仓库的发布从 doona 的发布归档重新打包,三个包(引擎、面板、LuCI 页面)同一条发布、同一组版本。

仓库产出五个包:

包 内容
dae 守护进程,来自 szwjp/dae 的发布二进制(带 native HTTP 控制面),加上 OpenWrt 侧的 init/UCI/配置模板与手动 Geo 数据更新脚本。
luci-app-dae LuCI 入口页与服务后端(rpcd):状态、启停、API 密钥、打开面板、手动更新 Geo 数据。依赖 dae 与 doona。
luci-i18n-dae-zh-cn / luci-i18n-dae-zh-tw LuCI 页面的简体 / 繁体中文翻译。
doona 面板本体:把 szwjp/doona 发布的归档(摘要固定在 doona/digests.txt)装到 /usr/share/doona。字体归档不在本仓库打包。

面板由 dae 自己托管:dae 把 /usr/share/doona 挂在 /ui/,API 仍要 Token。

安装

系统要求

需要带 apk v3 的系统,例如 ImmortalWrt 25.12 及更新版本;仍用 opkg 的 OpenWrt 24.10 及更早版本装不上这些包。内核需要带 BTF(见「架构」一节)。

apk --version   # 需要 apk-tools 3.x

下载并安装

apk v3 的 apk add 只认本地文件,不接受 URL,所以先把包下载下来再装。 luci-app-dae 依赖 doona,三个文件要在同一条命令里交给 apk。三个包全部由本仓库 的发布产出——面板由本仓库从 szwjp/doona 的发布归档重新打包(版本与摘要固定在 doona/digests.txt),所以不需要再去另一个仓库挑版本:

cd /tmp
# 引擎:按设备架构选一个
wget -O dae.apk \
  https://github.com/szwjp/luci-app-dae/releases/latest/download/dae-2.1.1-r15-x86_64.apk
# 面板
wget -O doona.apk \
  https://github.com/szwjp/luci-app-dae/releases/latest/download/doona-0.1.0-r18.apk
# LuCI 页面
wget -O luci-app-dae.apk \
  https://github.com/szwjp/luci-app-dae/releases/latest/download/luci-app-dae-2026.11.14-r8.apk
apk add --allow-untrusted ./dae.apk ./doona.apk ./luci-app-dae.apk

从旧版本升级时,doona 包会被同样包名的本仓库构建替换;面板文件仍装在 /usr/share/doona,dae 的 ui 设置不用改。

守护进程按架构分发:

设备架构 包
x86_64 dae-<ver>-x86_64.apk
arm64 dae-<ver>-aarch64_generic.apk
riscv64 dae-<ver>-riscv64_generic.apk

可选包:

# LuCI 中文翻译,界面语言随浏览器 Accept-Language 走
apk add --allow-untrusted ./luci-i18n-dae-zh-cn-<ver>.apk

面板不带字体归档(Noto Sans TC/SC),缺少时回退系统字体。需要自带字体时,仍可从 szwjp/doona 的发布里装 doona-fonts-<ver>.apk。

启用服务

服务默认禁用。先按设备改好配置再启用:/etc/dae/config.dae 是入口文件, 模块放在 /etc/dae/config.d/,LAN/WAN 接口在 /etc/dae/config.d/global.dae 里指定。

uci set dae.main.enabled=1
uci commit dae
/etc/init.d/dae start

也可以直接在 LuCI 页面上点「启动」,它会一并把 enabled 置为 1、设为开机自启并 启动服务。要关掉开机自启而不停服务,用 系统 → 启动项 里的开关(或 /etc/init.d/dae disable)。

API 监听地址与密钥放在 UCI 里,不写进配置文件。首次成功启动时服务会自动生成一个 密钥并写回:

uci get dae.main.api_secret

注意:密钥只在服务真正启动时生成。enabled=0 时启动会被拒绝,也就不会生成。

UCI 选项 默认值 含义
enabled 0 是否启用服务
config_file /etc/dae/config.dae 运行的配置文件
api_listen 0.0.0.0:9527 native API 监听地址
api_secret 首次启动自动生成 API 的 Bearer 令牌
api_write 1 允许面板写配置。默认打开,装完面板即可用;页面「服务」标签上有同名开关,改完会自动重启服务
lan_interface 空 覆盖 LAN 接口名,默认从 config.d/global.dae 读取

面板访问地址也可以直接在 LuCI 页面上改:页面的「面板访问地址」一行填好后点「确定」,会立即保存并重启服务; 新地址起不来时会自动恢复旧地址并重启,不会把面板留在不可达的状态。等价的 UCI 写法:

uci set dae.main.api_listen='192.168.1.1:9527'
uci set dae.main.api_write='1'
uci commit dae
/etc/init.d/dae restart

api_listen 必须是数值地址加端口(0.0.0.0:9527、192.168.1.1:9527)。 localhost 会被改写成 127.0.0.1,其它主机名不接受——dae 自己要求数值地址。

LuCI 页面显示和编辑的是面板访问地址(如 http://192.168.1.1:9527/ui/);api_listen 是其背后的 bind 地址,普通使用不需要关心。面板由 dae 托管时,doona 的后端网址固定为当前页面地址,随它一起变化。

安全:API 监听与明文 HTTP

api_listen 默认是 0.0.0.0:9527,dae 的 native API 与面板都是明文 HTTP: api_secret 和面板使用的 Bearer 令牌在局域网里明文传输,浏览器还会把它存下来。 默认保留 0.0.0.0 是为了装完就能从 LAN 打开面板,代价是:

  • 密钥等同于 dae 的控制权。 api_write=1(默认)时,拿到密钥的人可以改分流配置。 只想要只读面板就关掉「面板写入」:uci set dae.main.api_write='0'。
  • OpenWrt 默认防火墙拒绝 WAN 入站,所以暴露面主要是 LAN。
  • 只在本机用面板时,把监听改成回环(本机浏览器还需要 SSH 端口转发): uci set dae.main.api_listen='127.0.0.1:9527'。
  • 需要 LAN 内多台设备访问时,建议监听 LAN 地址并用 HTTPS 反代,不要把 9527 直接放到公网。

面板

  • LuCI 入口:服务 → dae。页面有两个标签:
    • 服务:运行状态、开机自启状态、启动/停止/重启、面板访问地址(可编辑并立即生效)、API 密钥(显示/复制)、打开面板;
    • Geo 数据:两个数据文件的文件名/大小/修改时间,手动更新与进度日志。
  • 直接访问:http://<路由器地址>:9527/ui/。
  • 面板首次打开时会要求填写密钥,之后由浏览器记住;后端地址固定为当前页面地址。密钥也可以 uci get dae.main.api_secret 读取。
  • 面板的「出站模式」(规则/直连/全局)写在含 routing 段的文件里,也就是 config.d/routing.dae;入口文件 config.dae 只读,面板不会去改它。
  • 面板能不能改配置取决于 api_write,默认是开的。关掉后 doona 会把整个配置、 节点、组与规则显示为只读(「配置为只读」),只能在面板里看。开关就在页面的 面板写入 一行:切换后服务会重启一次,面板需要刷新页面才能看到新的写入状态。来源是 UCI 的 dae.main.api_write,由 init 脚本写进 /etc/dae/api.dae,所以别直接改那个文件 ——每次启动都会被 UCI 的值覆盖。

菜单对任何已登录的 LuCI 用户可见,实际能做什么由 rpcd ACL 决定:只授 luci-app-dae-read 的账号只能看状态与 Geo 信息,luci-app-dae-admin 才能启停、 更新 Geo 数据、读取密钥。

LuCI 页面通过 rpcd 的 exec 后端读取状态。软件包安装后会自动 reload rpcd; 如果页面报"读取 dae 服务状态失败",执行 /etc/init.d/rpcd reload 即可。

启动项页面

服务在 LuCI 的系统 → 启动项里以 99 dae 出现,页面上的启用/禁用按钮就是 开机自启开关(LuCI 页面本身不再放这个开关,避免两处状态源)。

「服务」标签上的「开机自启 / 不自启」徽标读的就是 S99dae 这个启动链接, 和上面的开关保持同一状态源;它不影响已经启动的服务。

rpcd 读取 init 脚本时只看开头若干行里的 USE_PROCD、START、STOP, 所以这三行必须留在脚本的前 11 行内。

Geo 数据

规则里的 geosite: 与 geoip: 用到的数据文件是 geoip.dat 与 geosite.dat, 位于 /usr/share/v2ray(v2ray-geoip / v2ray-geosite 两个包提供)。dae 只在 启动时读取它们,所以更新后要重启 dae。

更新是手动的:LuCI 页面的「Geo 数据」标签点「立即更新」,或命令行:

/usr/bin/dae-geo-update

脚本先解析上游 release 分支到具体 commit,再按 commit 取两个文件和它们的 .sha256sum,保证两者来自同一快照:

https://cdn.jsdelivr.net/gh/Loyalsoldier/v2ray-rules-dat@<commit>/geoip.dat
https://cdn.jsdelivr.net/gh/Loyalsoldier/v2ray-rules-dat@<commit>/geosite.dat

行为要点:

  • 下载带 Range 头(实测普通 GET 只有 16KB/s,显式 Range 是 MB/s 级);中断后 下一轮用 curl -C - 续传。
  • 完整性靠上游同目录的 <file>.sha256sum 判定——CDN 的 content-length 和 content-range 不可信。校验不过会丢掉重下,最多三轮;仍不过就放弃本次更新、 保留旧文件。只有上游没提供 sha256 时,才在一次完整传输之后按大小和文件头放行。
  • 换文件是先在目标目录写临时文件再改名,掉电不会留下半个文件。之后重启 dae; 没起来就只把本次换过的文件放回去再重启一次。
  • 上一版文件备份在 /etc/dae/geo-backup/。
  • 日志在 /var/log/dae-geo-update.log,同时进 syslog(logread | grep dae-geo-update)。 /var 是 tmpfs,重启后日志不保留。
  • 进度写在 /var/run/dae-geo-update.state,LuCI 页面靠它显示「更新中/成功/失败」。
  • 这两个文件归 apk 包所有,apk upgrade v2ray-geoip v2ray-geosite 会用 feed 里的版本覆盖它们;下一次手动更新会装回更新的版本。

ICMP 重定向

dae 拒绝挂到会发送 ICMP 重定向的接口上,重定向会和 dae 装的规则打架。启动 脚本会在 dae 运行期间把 all 与 LAN 接口的 send_redirects 置 0,停止时按启动 前的值恢复,所以不用手工改 sysctl。LAN 接口名取自 UCI 的 lan_interface,没有 设置时从 config.d/global.dae 里读。

架构

dae 包发布的是预编译二进制,所以每个架构一个包:x86_64、arm64、riscv64。 二进制来自 szwjp/dae 的发布产物,CI 取下来校验 摘要后重新打包,不重复编译。LuCI 包、翻译包与面板包都是纯静态构建,各架构通用。

riscv64 的二进制按 RISC-V 2023 profile(rva23u64)构建,若设备内核太老跑不起来, 需要换用上游的其它 profile 或自行编译。

eBPF 程序需要内核带 BTF。ImmortalWrt 与 OpenWrt 24.10+ 的内核自带 (/sys/kernel/btf/vmlinux);更老的内核需要先装 vmlinux-btf 包。

接口配置

/etc/dae/config.d/global.dae 里的两个接口按设备形态填:

  • lan_interface:客户端所在的网桥,OpenWrt 默认是 br-lan。
  • wan_interface:出方向流量离开的网卡。默认写 auto,由 dae 按默认路由解析; 单网口设备(唯一那个口就是 LAN 口,没有 WAN 口)要把它留空。

开机时 dae 会先等默认路由出现(最多 30 秒)再启动,避免 PPPoE 还没拨上时就挂住 LAN;wan_interface 留空的单网口设备不等待。

构建

软件包用 apk-tools 直接打包,不走 OpenWrt SDK:.github/build-pkg.sh 组装 staging 目录,apk mkpkg 写出容器格式。各包的 Makefile 只是这个脚本读取的 元数据,没有 include luci.mk,不能直接放进 OpenWrt 的 package/ 目录参与官方构建。

守护进程二进制不在本仓库里,构建前从引擎发布取。dae/digests.txt 固定了三个 架构归档的 sha256,构建会拒绝不匹配的归档;升级引擎时该文件里的 tag 行和 .github/workflows/build.yml 的 DAE_BINARY_TAG 必须一起改:

DAE_TAG=v2026.11.14-nativeapi-r15   # 以 dae/digests.txt 的 tag 行为准
curl -fsSL -o dae.tar.xz \
  "https://github.com/szwjp/dae/releases/download/$DAE_TAG/dae-linux-x86_64.tar.xz"
tar -xJf dae.tar.xz
mkdir -p dae/assets/x86_64
install -m0755 usr/bin/dae dae/assets/x86_64/dae

然后打包(PKG_ASSET_DIR 指向取下来的那一份):

PKG_ASSET_DIR=assets/x86_64 PKG_ARCH_OVERRIDE=x86_64 \
  fakeroot bash .github/build-pkg.sh dae
fakeroot bash .github/build-pkg.sh luci-app-dae
fakeroot bash .github/build-pkg.sh doona   # 先取面板归档到 doona/assets

需要 apk (apk-tools v3) 与 po2lmo(翻译包);CI 里两者都编译好后使用。

面板从 szwjp/doona 的发布归档打包:doona/digests.txt 固定发布 tag 与该归档的 sha256,CI 校验后解到 doona/assets/,再由 build-pkg.sh doona 装到 /usr/share/doona。面板界面本身仍在上游仓库开发。

包里的文件归 root。在 macOS 上本地打包时没有 fakeroot,chown 会失败,包会带上 构建者的 uid(安装后显示为 nobody);构建脚本会对此告警。正式出包走 CI(Linux + fakeroot),或者手动在 Linux 上跑。

许可

  • dae:AGPL-3.0-only。本仓库分发的二进制来自 szwjp/dae 的发布,对应源码就是 该发布 tag 的源码树。
  • luci-app-dae:GPL-3.0-only。
  • doona:GPL-3.0-only,许可证与第三方声明随包安装在 /usr/share/doc/doona/。

AGPL 与 GPL 兼容。各包是独立的程序,通过 HTTP 通信。