Skip to content

cqc0101/openwrt-proxy-skills / skills/dae-openwrt

dae-openwrt

Flagged

在 OpenWrt、ImmortalWrt、iStoreOS 上生成、部署和排查原生 dae 配置。适用于 eBPF 接口绑定、routing/dns/group 规则、订阅导入与热重载;不接管 daed 面板配置。

references/troubleshooting.md

View on GitHub
# dae 排障手册、硬件依赖与新老版本兼容速查

> 集中归纳 dae eBPF 运行时的底层硬件约束、新旧版本差异、常见故障病因与针对性解法。

---

## 一、 硬件与内核门禁 (新老软路由分级矩阵)

dae 深度依赖 Linux 内核 eBPF TC 特性,不同代际软路由的适配策略如下:
1. **老款软路由(Linux < 5.15,如 OpenWrt 18.06 / 19.07 / 21.02 / 22.03 的 4.14、5.4、5.10 内核)**:不支持 eBPF CO-RE,`probe.sh -j` 会自动输出 `"dae_capable": 0, "recommended_engine": "sing-box"`,由 `singbox-openwrt`(兼容 `fw3/iptables` 与全版本内核)无损接管。
2. **中期软路由(Linux 5.15 ~ 5.16 + BTF,如 OpenWrt/ImmortalWrt 23.05)**:支持软件源内的老版本 `dae`(如 `v1.0.0-r1`),或切换 `singbox-openwrt`。
3. **新款软路由(Linux >= 5.17 + BTF,如 ImmortalWrt/OpenWrt 24.10 / 25+ 的 6.1、6.6+ 内核)**:完美支持最新原生 `dae v2.1.1+`。

---

## 二、 老版本 dae (`<= v1.0.0`) 与新版本 dae (`v2.1.1+`) 差异与自动兼容

| 差异维度 | 老版本 `dae` (`v0.3` ~ `v1.0.0-r1`) | 新版本 `dae` (`v1.1+` / `v2.1.1+`) | 技能自适应兼容方案 |
| :--- | :--- | :--- | :--- |
| **新增配置字段** | 不识别 `bpf_conn_state_map_size`、`auto_sniff_punt`、`bootstrap_resolver`、`optimistic_cache`、`optimistic_cache_ttl`(写入会报 `unexpected field`) | 原生支持上述 5 个性能与防断流字段 | `sub_to_dae.py --full` 支持 `--router <IP>` 自动探测远端版本(或显式传 `--dae-version legacy`),对老版本自动剥离上述 5 个字段 |
| **CLI 校验命令** | 支持 `dae validate -c <file>`,极早期版本支持 `dae validate <file>` | **强制要求 `-c`**:`dae validate -c <file>`(漏传 `-c` 直接报错退出) | 统一使用 `dae validate -c /tmp/config.test.dae \|\| dae validate /tmp/config.test.dae` |
| **DNS `qname()` 词法** | 宽松解析 | `addQName` 强制要求带前缀(如 `geosite:cn`、`suffix:example.com`),裸单引号域名会崩溃 | `qname()` 仅保留 `qname(geosite:cn)`,域名黑名单移入 `routing {}` 的 `domain(suffix: ...)` |

---

## 三、 核心生产事故与排障矩阵

| 故障现象 | 根本病因 | 针对性排查与自愈指令 |
| :--- | :--- | :--- |
| **启动后全屋断网** | `dnsmasq` 53 端口查询被递归拦截死锁 | 检查 `routing` 首行是否有 `pname(dnsmasq, ...) && l4proto(udp) && dport(53) -> must_direct` |
| **国内直连出海均超时** | OpenWrt 开启了 Flow Offloading (软/硬件流量分载) | 运行 `uci set firewall.@defaults[0].flow_offloading='0' && /etc/init.d/firewall reload` |
| **老版本 dae 校验报 unexpected field** | 路由器安装的 `dae <= v1.0.0` 不支持 v2.x 新增字段 | 运行 `python scripts/sub_to_dae.py "<订阅>" --full --dae-version legacy -o /tmp/config.dae` 重新生成 |
| **旁路由客户端断网/假死** | 非对称路由导致客户端 TCP RST | 运行 `sh setup_openwrt_network.sh --bypass` 开启 LAN 伪装 |
| **内存溢出 (OOM) 杀掉进程** | 弱小路由器加载了全量巨型 GeoIP/Geosite | 生成时传入 `--ram-mb 256` 自动调小 `bpf_conn_state_map_size` 并精简规则集 |

---

## 四、 支持的代理协议 URI 格式

dae 原生支持的单节点链接格式(均需使用单引号包裹):
* **VLESS Reality**: `'vless://uuid@host:port?security=reality&sni=xxx&pbk=xxx&sid=xxx&type=tcp&flow=xtls-rprx-vision#Tag'`
* **Hysteria 2**: `'hysteria2://password@host:port?sni=xxx&insecure=0#Tag'`
* **Trojan**: `'trojan://password@host:port?sni=xxx#Tag'`
* **Shadowsocks**: `'ss://base64(method:password)@host:port#Tag'`

> **注意**:dae 仅支持原生标准协议 URI,不支持带有复杂客户端扩展私有参数的非常规链接;订阅解析请统一使用 `python scripts/sub_to_dae.py "<URL>" --max 15`。

---

## 五、 新一代 `apk` 固件与无网环境 SSH 流式管道交付 (SSH Stream Pipe)

固件软件源缺包或路由器未联网时,按[离线安装说明](./runtime-checks.md#离线安装与配置发布)传输与目标架构匹配的 dae 二进制和 GeoData。校验后替换文件,GeoData 通常位于 `/usr/share/dae`。

## 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` 的候选文件需以 `.dae` 结尾,权限设为 600。网络看门狗支持 `--watchdog --watchdog-seconds=120`(范围 10~600,默认 45 秒)。只切换节点时,使用[配置级备份与回退](./runtime-checks.md#判断与回退)。

SSH 可交互输入密码,或使用已核对主机指纹的密码客户端;不要把密码放在命令行、脚本或报告里,不通过关闭主机密钥验证解决连接问题。
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall