Skip to content

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

dae-openwrt

Flagged

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

references/runtime-checks.md

View on GitHub
# 节点切换与连通性验证

## 修改链接

使用 `scripts/node_link.py input.txt output.txt --set fp=chrome` 修改 query;输入和输出应为本地受限文件,不把完整节点链接放到命令行或日志。工具拒绝覆盖已有输出,保留账号编码和 `#fragment`。更新后的链接仍须通过对应引擎校验。

Reality 链接必须显式包含非空 `fp`。`fp=chrome` 与 Dae 全局的 `utls_imitate: chrome_auto` 属于不同配置项,不可互换。`dae validate` 只覆盖配置校验;重载后还要检查目标节点是否被拒绝、代理组是否为空。日志可能保留历史错误,应以本次重载时间及后续探测为界。

## 从客户端验证

在 LAN 客户端运行:

```sh
python scripts/check_path.py --interface 192.0.2.10 --url https://example.com/
```

每次最多 8 个请求,单次最长 30 秒,默认响应大小上限 256 KiB、速率上限 256 KiB/s。保持证书校验,不跟随重定向,不使用环境代理。结果记录请求的接口、实际源地址、目标地址、HTTP 状态、耗时、接收字节及平均速度;超过响应上限或超时应报告未完成,不能当作最大带宽。

`--interface` 不绑定系统 DNS。双网卡时先分别记录默认路由、接口 metric 和 DNS 服务器;Windows 可使用 `Get-NetIPInterface`、`Get-NetRoute`、`Get-DnsClientServerAddress`。再使用 `Resolve-DnsName example.com -Server <路由器LAN地址> -Type A` 取得答案,通过 `--resolve example.com=192.0.2.20` 测试同一地址。该参数仅使用所提供的答案,不证明 DNS 服务器、加密上游或无泄漏;保留查询来源与时间作为单独证据。需比较系统解析和指定路由器解析的实际请求,不能只测试指定 IP 后宣布普通访问正常。

工具先区分本机参数/依赖错误与请求失败。测试临时代理时,先确认进程存活和监听就绪,并做直连对照;通道不可用时,本轮节点结果无效。临时进程只监听回环地址,使用 SSH 隧道;不要开放匿名代理或假定设备安装了 `nohup`。不得随意使用未知的绕过标记,否则可能测试到嵌套代理。

观察出口时,记录测试网卡索引、下一跳和直连对照。节点连接地址和代理出口地址可能不同。结合网关的实际转发路径和出口观测判断。

## 离线安装与配置发布

离线安装二进制或规则集前,按路由器架构选择文件,并按发布方提供的哈希或签名校验下载件。解包后记录实际待传输文件的 SHA-256。用 SSH 把文件传到目标目录中新建的临时文件,核对两端哈希后再设置目标权限并重命名。传输、校验或重命名失败时停止,保留原文件。更新已有文件前保留可恢复的备份。

原子发布配置前,先通过原生引擎校验 `/tmp` 中的候选文件,启动 `setup_openwrt_network.sh --watchdog` 并等待就绪。以下命令在路由器上执行。改用 dae 时,将引擎和候选文件名分别改成 `dae` 与 `config.dae`。

```sh
(
    set -eu
    umask 077
    engine=sing-box
    candidate=/tmp/proxy-config.REPLACE/config.json
    config_root=/etc
    case "$engine" in
        sing-box) name=config.json ;;
        dae) name=config.dae ;;
        *) exit 2 ;;
    esac
    state_root="$config_root/proxy-skills-network"
    state="$state_root/$engine"
    service="$config_root/init.d/$engine"
    dest="$config_root/$engine/$name"

    [ -x "$service" ]
    [ -f "$candidate" ]
    [ ! -L "$candidate" ]
    [ -f "$state_root/lock" ]
    [ ! -L "$state_root/lock" ]
    exec 9>>"$state_root/lock"
    flock -n 9
    [ "$(cat "$state_root/owner")" = "$engine" ]
    [ -f "$state/ready" ]
    [ -s "$state/pending" ]
    [ -s "$state/armed" ]
    [ "$(cat "$state/armed")" = "$(cat "$state/pending")" ]
    (cd "$state" && sha256sum -c snapshot.sha256 >/dev/null)
    [ ! -L "$dest" ]
    if [ -e "$dest" ]; then
        [ -f "$dest" ]
    fi

    mkdir -p "${dest%/*}"
    staging=$(mktemp -d "${dest%/*}/.proxy-config.XXXXXX")
    trap 'rm -f "$staging/$name"; rmdir "$staging"' EXIT
    cp "$candidate" "$staging/$name"
    chmod 600 "$staging/$name"
    case "$engine" in
        sing-box) sing-box check -c "$staging/$name" ;;
        dae) dae validate -c "$staging/$name" ;;
    esac
    mv -f "$staging/$name" "$dest"
    if [ "$engine" = dae ] && pidof dae >/dev/null 2>&1; then
        "$service" reload 9>&-
    else
        "$service" restart 9>&-
    fi
)
```

发布或启动失败时保留快照,执行 `--revert` 或等待看门狗恢复。验收通过后移除 `/tmp` 中的候选。网络快照可能来自首次接管前。日常只换节点时,应另外备份当前生效配置,并使用配置级回退。

## 判断与回退

- 进程运行、端口监听、节点认证、目标 HTTPS、LAN 转发及 DNS 路径分别报告。`doctor.sh` 的 `healthy` 仅表示未匹配到本地已知问题;`outbound_ok` 仅是路由器 HTTP 可达性,均不证明 LAN 代理健康。
- 测速使用小流量、多次同目标对照,区分首字节时间和传输速度;单次超时不等于节点永久不可用。比较同一客户端、同一参数下的不同接入网络后,才能缩小线路问题范围,不从 Ping 或中间跳无响应直接断言封锁。
- 节点切换只修改引擎配置;不顺带运行网络加固或改变 DNS、防火墙。先备份并记录原配置哈希,在 `/tmp` 生成权限为 600 的候选配置并校验。
- 自动回退必须在替换前启动并收到就绪确认,独立于当前 SSH 会话;回退与确认使用同一互斥机制。恢复失败要保留备份并明确报错。不要通过共享临时 PID 文件盲目杀进程。
- 在新 SSH 连接中核对实际配置哈希、目标节点载入、至少两个目标的 HTTPS、路由器 DNS 结果及普通客户端访问后,才确认保留。失败立即恢复并复查原配置哈希和实际访问;热重载不保证全部长连接无感。
- 如果启停会切换 DNS 重定向,在同一台 LAN 客户端上用同一个 UDP 套接字查询,切换后沿用原源端口再次查询。启用、停用和回退各做一次,并检查本地域名与公网域名。新套接字查询通过后,原连接仍可能被旧的 NAT 状态送到已关闭的监听端口。
- 自动切换只接纳参数正确且重复实际转发通过的节点。配置冷却时间和连续失败门槛,未验证的节点不进入备用池;延迟低不代表带宽高。不要为满足切换目标而在失败后连续尝试生产配置。
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