cqc0101/openwrt-proxy-skills / skills/singbox-openwrt
singbox-openwrt
Flagged在 OpenWrt、ImmortalWrt、iStoreOS 上生成、部署和排查 sing-box 1.13/1.14 配置。适用于订阅导入、FakeIP/RealIP 分流、TUN 防火墙设置及代理断网排查。
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 状态送到已关闭的监听端口。
- 自动切换只接纳参数正确且重复实际转发通过的节点。配置冷却时间和连续失败门槛,未验证的节点不进入备用池;延迟低不代表带宽高。不要为满足切换目标而在失败后连续尝试生产配置。
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: 198k | 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 |