cqc0101/openwrt-proxy-skills / skills/dae-openwrt
dae-openwrt
Flagged在 OpenWrt、ImmortalWrt、iStoreOS 上生成、部署和排查原生 dae 配置。适用于 eBPF 接口绑定、routing/dns/group 规则、订阅导入与热重载;不接管 daed 面板配置。
dae OpenWrt 配置与排障
管理原生 dae 的配置、接口绑定、DNS 规则与服务重载。生成器区分 legacy 与 modern 字段,部署时仍需由目标设备的 dae validate 校验。
支持边界:本技能管理原生 dae(
dae二进制 / procddae服务 +/etc/dae/config.dae,注意:Web 面板版daed使用/etc/daed/daed.db数据库,不读取/etc/dae/config.dae)。eBPF 需要 Linux 5.15+(现代dae v2.x推荐 5.17+)与 BTF 支持;若为老软路由(Linux < 5.15 或无 BTF),探针会自动识别并建议改用全内核通用的singbox-openwrt。
部署约束
- 严禁直接在路由器
/etc下裸改配置:一切修改必须先写入/tmp沙盒并执行chmod 600(dae强制要求配置文件权限不宽于0600/0640),经远端dae validate -c <file>通过后再备份原配置并原子替换。 - 硬件与网络设置:
global中lan_interface: br-lan+wan_interface: auto+auto_config_kernel_parameter: true;部署前关闭流量分载(Flow Offloading,否则报文绕过 eBPF);dropbear/sshd 需做 OOM 保护。 - 先采集诊断信息:网络异常先运行
scripts/probe.sh -j探针和scripts/doctor.sh dae --json诊断,再进行针对性修复。 - dae validate -c 强制参数规范与新旧版本兼容:原生
dae官方 CLI(含 v2.1.1+)强制要求传入-c/--config指定配置文件,标准格式为dae validate -c /path/to/config.dae(漏传-c会报Argument "--config" or "-c" is required);若需同时兼容极早期版本,可使用dae validate -c /tmp/config.test.dae || dae validate /tmp/config.test.dae。同时,针对老版本dae(<= v1.0.0),生成配置时通过--router <IP>自动探测或显式指定--dae-version legacy剥离 v2.x 新增字段。 - procd 托管与 daed 区分及强互斥检查:ImmortalWrt 官方源的原生
dae包由 procd 管理,启用与热重载使用uci set dae.config.enabled='1' && uci commit dae && /etc/init.d/dae reload(裸二进制模式使用dae reload);而daed是 Web 面板独立包(端口 2023,读取/etc/daed/wing.db,不读取/etc/dae/config.dae)。若probe.sh -j检出daed_conflict: true,必须严禁下发原生配置,提示用户先执行/etc/init.d/daed stop && /etc/init.d/daed disable。
参考资料
| 任务 | 优先查阅 |
|---|---|
| dae 配置约束、路由语法与配置规范 | dae-rules-and-syntax.md |
| 常见故障排查手册与日志分析 | troubleshooting.md |
| OpenWrt 专用基准模板 | openwrt.dae |
工作流程
根据用户拓扑选择配置;探针、校验和诊断结果作为部署依据。流程如下:
- 确认主路由或旁路由拓扑,以及 FakeIP/RealIP 或 dae 接口绑定需求。
- 运行
probe.sh -j,核对内核、引擎版本、资源和冲突服务。 - 解析订阅、生成配置;按所需分流规则修改配置。
- 运行静态检查,并在目标设备执行原生校验。
- 备份配置,再替换文件、重载服务。
- 按拓扑执行
setup_openwrt_network.sh,保留自动恢复直到验证完成。 - 检查管理连接、DNS 和客户端流量,必要时读取诊断 JSON。
OpenWrt 必须遵守的 配置约束
在为软路由生成或调整 .dae 规则时,必须 严格遵循以下约束:
1. 单引号词法规范
在 .dae 规范中,除 ext:"xxx.dat:tag" 外部文件引用外,所有包含冒号 :、斜杠 /、正则表达式或复合协议的字符串,统一使用单引号 '...' 包裹,避免解析歧义。
- 推荐:
tcp_check_url: 'http://cp.cloudflare.com'
2. must_direct 防 DNS 死循环约束
dae 默认拦截所有发往 53 端口的请求。宿主 DNS 查询被拦截后若递归返回自身,会形成回环。以下是独立 DNS 解析模式的防环写法;若由 dae 接管 dnsmasq,按下文「DNS 拓扑与节点验收」选择规则,不可一概旁路或接管:
routing {
pname(dnsmasq, odhcpd, netifd, uhttpd) && l4proto(udp) && dport(53) -> must_direct
dip(224.0.0.0/3, 'ff00::/8') -> direct
dip(geoip:private) -> direct
...
}
3. 布尔取反(!)合并约束
两行独立的取反规则在 dae 中是 OR 语义:
!domain(geosite:a) -> my_group
!domain(geosite:b) -> my_group # 实际含义:非 a 或 非 b 都走代理,大量流量被误送
表达“既不属于 A 也不属于 B”时必须合并写在同一行内:
!domain(geosite:a, geosite:b) -> my_group
4. 路由短路 (First-Match) 六层匹配顺序
规则自上而下匹配,一旦命中立即终止后续规则:
- [第 1 层] 核心宿主进程与私网广播保护:
pname(dnsmasq, ...) -> must_direct及dip(geoip:private) -> direct - [第 2 层] 大流量下载与 P2P 绕行:
pname(aria2c, qbittorrent-nox) -> must_direct及dscp(0x4) -> direct - [第 3 层] 海外 QUIC/UDP 443 抑制:
l4proto(udp) && dport(443) && !domain(geosite:cn) -> block(规避运营商 UDP 降速) - [第 4 层] 重点海外服务专属分流:
domain(geosite:google, geosite:openai, ...) -> 专属组 - [第 5 层] 大陆大盘双向白名单直连:
domain(geosite:cn) -> direct及dip(geoip:cn) -> direct - [第 6 层] 终态回落兜底:
fallback: 默认代理组
5. DNS 污染重查闭环与 qname 词法前缀约束
- response 防环:在
dns.routing.response中配置私网 IP 投毒重查时,首行必须加入upstream(googledns) -> accept白名单放行,防止无限递归。 - qname 词法陷阱规避:
dae v2.1.1的dns.routing.request中qname(...)解析器 (addQName) 强制要求每个参数必须带匹配前缀(如geosite:cn、full:example.com、suffix:example.com),严禁写入无前缀单引号域名(如qname('use-application-dns.net'),会触发addQName: unsupported key:崩溃)或复杂geosite:category-ads-all;所有域名黑名单与 Canary 阻断一律置于routing {}的domain(suffix: ...)中处理。
response {
upstream(googledns) -> accept # 首行必须放行可信上游!
ip(geoip:private) && !qname(geosite:cn) -> googledns
fallback: accept
}
软路由网卡绑定(global 必填项)
软路由作为局域网网关,在 global 块中必须显式声明局域网网桥与外网出口:
global {
lan_interface: br-lan # 绑定局域网网桥,代理整个内网终端
wan_interface: auto # 自动识别物理外网出口(PPPoE / DHCP)
auto_config_kernel_parameter: true # 自动开启 net.ipv4.ip_forward=1 并关闭 ICMP redirects
}
环境检查
部署 dae 前必须先调用探针确认软路由内核、BTF 符号及已安装的 dae 版本:
# 目标软路由本地或 SSH 管道执行探针 (输出结构化 JSON,含 kernel_ge_515/517 与 dae_version)
ssh root@192.168.1.1 "sh -s -- -j" < scripts/probe.sh
维度二:dae 配置生成与订阅脱水 (Config Engine)
使用 scripts/sub_to_dae.py 支持将机场 HTTP/HTTPS 订阅一键清洗并转换为 dae 配置(支持自动探测路由器上的新旧 dae 版本):
# 方式 A:一键合成完整 config.dae(通过 --router 自动探测远端 dae 版本是 modern 还是 legacy,或手动传 --dae-version legacy 适配 <= v1.0.0)
python scripts/sub_to_dae.py "https://sub.domain.com/link?token=..." --max 15 --full --router 192.168.1.1 --out /tmp/config.dae
# 方式 B:仅导出 node { ... } 节点池语法块
python scripts/sub_to_dae.py "https://sub.domain.com/link?token=..." --max 15 --out /tmp/nodes.dae
维度三:Agent 自主部署与平滑热重载 (Autonomous Deployment)
dae 的优势在于重载配置时无需重启内核 eBPF 程序,已有连接完全不断流。Agent 自主执行标准发布命令:
# 0. [可选:针对 apk 缺包或路由器初始无网死锁] 宿主机 SSH 流式管道 (SSH Stream Pipe) 直灌二进制与 GeoData
# 当 ImmortalWrt 24/25+ (apk) 软件源未收录最新原生 dae 或路由器断网无法拉取时,直接从宿主机流式灌入:
# ssh root@192.168.1.1 "mkdir -p /usr/bin /usr/share/dae /etc/dae && cat > /usr/bin/dae && chmod +x /usr/bin/dae" < ./dae-linux-${ARCH}
# ssh root@192.168.1.1 "cat > /usr/share/dae/geoip.dat" < ./geoip.dat
# ssh root@192.168.1.1 "cat > /usr/share/dae/geosite.dat" < ./geosite.dat
# 1. 上传配置到 /tmp 临时沙盒并锁定 0600 权限(dae 强制要求配置文件权限不宽于 0640/0600)
ssh root@192.168.1.1 "cat > /tmp/config.test.dae && chmod 600 /tmp/config.test.dae" < /tmp/config.dae
# 2. 远端沙盒严格语法校验(优先使用原生 dae v2.1.1+ 强制要求的 -c 参数,并兼容早期版本回退)
ssh root@192.168.1.1 "dae validate -c /tmp/config.test.dae || dae validate /tmp/config.test.dae"
# 3. 启动路由器本地 45 秒防失联看门狗 (必须在替换配置与 reload 前启动,防止 eBPF 规则异常导致 SSH 锁死)
ssh root@192.168.1.1 "sh -s -- --watchdog" < scripts/setup_openwrt_network.sh
# 4. 备份快照、原子替换配置并执行无感平滑热重载
# - OpenWrt/ImmortalWrt procd 管理(原生 dae 包):使用 /etc/init.d/dae reload
# - 官方裸二进制(非 procd 管理):使用 dae reload
ssh root@192.168.1.1 "[ -f /etc/dae/config.dae ] && cp /etc/dae/config.dae /tmp/config.dae.bak; mv /tmp/config.test.dae /etc/dae/config.dae && chmod 600 /etc/dae/config.dae && ( [ -x /etc/init.d/dae ] && uci set dae.config.enabled='1' 2>/dev/null && uci commit dae 2>/dev/null && /etc/init.d/dae reload || dae reload )"
# 5. 执行网络闭环脚本并在全新 SSH 连接确认连通后解除看门狗
ssh root@192.168.1.1 "sh -s" < scripts/setup_openwrt_network.sh
ssh root@192.168.1.1 "sh -s -- --confirm" < scripts/setup_openwrt_network.sh
故障诊断
当网络出现异常时,Agent 调用诊断脚本排障:
# 1. 结构化日志与运行状态体检 (输出机器可读 JSON,含 status/issues/suggested_actions)
ssh root@192.168.1.1 "sh -s -- dae --json" < scripts/doctor.sh
# 2. 专项 DNS 深度防污染与防泄漏健康体检
ssh root@192.168.1.1 "sh -s -- --json" < scripts/diagnose_dns.sh
测试与回归(改动任何脚本/模板后必须执行)
# 仓库根目录(两个技能共用)
python run_tests.py
网络事务与恢复边界(R2S 真机复核)
网络脚本要求 root、flock、sha256sum、tar、mktemp 与 UCI。修改前在 /etc/proxy-skills-network 的 0700 私有目录保存完整 firewall/dhcp、受影响 sysctl 文件、引擎配置、运行参数与服务状态。自动启动 45 秒恢复计时器;必须通过新 SSH 连接和实际业务检查后执行 --confirm。确认只解除自动回滚,完整基线保留供 --revert 使用。两套引擎共享设备锁;先回滚当前引擎,才能切换另一套网络配置。
没有完整基线时 --revert 不修改现有配置;备份校验失败或恢复失败时返回非零并保留现场。不要使用旧版 .network_baseline.bak 与新版混合部署。开机恢复使用持久化的独立 init 脚本,不依赖 /tmp 或已安装的技能脚本。恢复验证覆盖配置、sysctl 与进程状态;完整流量路径和 DNS 泄漏仍需独立实测,不能只凭该脚本成功判断业务正常。
网络接管前,已运行的裸二进制引擎必须先纳入 /etc/init.d/dae 或 /etc/init.d/sing-box 服务管理;否则脚本会拒绝接管,因为无法可靠恢复服务生命周期。基线原先停止的引擎在回滚后仍有未托管进程时,恢复会返回失败并保留快照,不能把配置文件恢复当作服务恢复。部署后若 firewall/dhcp 或相关 sysctl 文件被其他工具修改,自动/手动恢复均会拒绝覆盖,需根据保留的快照协调差异。
节点切换与实际访问验证
修改节点、诊断断网、双网卡测试或配置自动切换时,先阅读 节点切换与连通性验证。使用 scripts/node_link.py 安全更新链接参数,使用 scripts/check_path.py 从客户端执行有界请求。配置校验和进程存活不能替代节点载入、LAN 转发与 DNS 路径验证。未验证的备用节点不进入自动切换池。
DNS 拓扑与节点验收
must_direct 是旁路规则,不是可信 DNS 保证。默认模板保留 dnsmasq 防环规则以兼容现有部署,但必须核对 dnsmasq 的 resolvfile、server 和实际查询出口;私网上级路由器与公网明文解析器都不自动可信。
- dnsmasq 独立解析:保留
pname(dnsmasq, odhcpd, netifd, uhttpd) && l4proto(udp) && dport(53) -> must_direct,由已验证的独立解析链路保证可信与可用。 - dae 接管 dnsmasq:生成配置时显式指定
--dnsmasq-mode intercept,保留其他宿主组件防环规则,移除 dnsmasq 的旁路。先确认 dae 上游不回指 dnsmasq、本机 53 或上级回流服务,再验证 LAN 查询、节点冷启动、重载及回退。不能无条件删掉 dnsmasq 保护。
离线静态检查无法证明实际无环,所以两种模式均提示运行期核查,不把规则缺失直接判为必然死循环。执行 sh scripts/diagnose_dns.sh --json --compare-server=8.8.8.8 可比较本机与指定端点;这只是端点对照,不能假定后者一定经过 dae 或两者路径独立。CDN、缓存、策略也会产生不同答案,不能凭某个 IP 段直接断言污染或封锁。
配置含多个节点不代表有多个可用备用;只将实际认证、转发成功的节点加入组。多个 filter 行会扩大候选集合,但不能取代健康验证。未测得延迟的 0ms 记录不是可用证明;日志里的临时选择也不证明该节点已经承载成功请求。单节点组可以是主动隔离测试或用户固定选择,报告单点风险,不自动添加未验证节点。
dae validate 示例使用 /tmp/config.test.dae,候选文件必须以 .dae 结尾并先设权限 600。网络看门狗支持 --watchdog --watchdog-seconds=120(范围 10~600,默认 45 秒)。仅切换配置时使用备份、看门狗及确认子流程,不运行不带参数的网络加固操作;该流程仍会写回退快照与启动恢复钩子,不是完全只读。
SSH 可交互输入密码,或使用已核对主机指纹的密码客户端;不要把密码放在命令行、脚本或报告里,不通过关闭主机密钥验证解决连接问题。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |