dsh-egress-router

它解决什么问题

github.com 连不上、pip install 卡住、Agent 抓不到网页——但你又不想让所有流量都绕道境外。 这个插件做的是选择性出海：导入你自己的 vless / vmess / trojan / ss 节点，然后只让该走节点的流量走节点，其余保持直连，直连失败时自动回退。

装完在 设置 → 网络代理 里粘贴链接即可；Agent 侧会多出一个 net_proxy 工具，终端里的 curl / git / pip / npm 也会自动按同一策略走，不用每条命令加 -x。

特性

• 三种模式：关闭（全直连）/ 智能（名单内走节点，其余直连，失败自动回退）/ 全局（都走节点）
• 按实测速度选路，而不是按名单猜（默认开启「测速优先」，可在面板关掉）：
  • 竞速：名单内的域名，直连与节点同时起跑，谁先送回首字节谁赢，输的那条立刻拆掉，客户端已发出的 TLS 字节被补发到赢家 —— 所以"名单内但直连更快"再也不会被硬塞进节点
  • 名单外的域名先给直连 700ms 独跑，没动静才拉节点来比（不惊动节点，也不白等）
  • 决策记忆：赢家记入内存（直连赢 10 分钟、节点赢 5 分钟），不是每个请求都竞速；面板「重新探测」可随时清空
  • 吞吐惩罚：首字节快但随后被限速的路由，会在建立后 1.2 秒的采样里暴露（采样不足 8KB 即降级 2 分钟），期间让另一条路先起跑 —— "能连但很慢"的直连会被换成节点，反之亦然
  • 两条路都建不起来时，客户端会在 12 秒内收到明确失败，而不是一直挂着
• 节点有状态：正常 / 失效 / 本机不可用（例如本机没有 IPv6 出口时的 IPv6 单栈节点）。绝不自动删除节点；失效只改状态并让后续调用避开，删除只在你手动点击时发生
• 注释可见：你给节点写的备注，Agent 调用时也能看到（list 返回备注与状态）
• 四种链接：vless://（含 Reality）、vmess://、trojan://、ss://，可多行批量导入
• 内核随用随取：sing-box 以 Release 附件分发，首次需要时自动下载并校验 SHA-256，不占仓库体积
• 不碰 Harness 的出站策略：只注入子进程的代理环境变量，从不替换 Harness 自己的网络 dispatcher，模型调用不会被代理拖累或中断

安装

# 推荐：直接从 GitHub 安装（插件名 dsh-egress-router）
dsh plugin --profile web add github:gswenxue/dsh-egress-router

装完后重启一次 DSH Web（或让 profile 就绪后重新打开页面），设置里就会出现 网络代理。

# 用仓库地址（等价）
dsh plugin --profile web add https://github.com/gswenxue/dsh-egress-router

# 从 Release 的源码压缩包安装
dsh plugin --profile web add https://github.com/gswenxue/dsh-egress-router/archive/refs/tags/v0.1.0.tar.gz

# 本地开发：把工作副本 link 进 profile
#   package.json: "dsh-egress-router": "link:/path/to/dsh-egress-router"
#   并加入 dsh.profile.bundles

快速上手

1. 导入节点：设置 → 网络代理 → 粘贴一条或多条分享链接 → 导入（备注取链接里的 # 片段，可再改）
2. 测一下：点节点上的「测试」，或工具条的「测试全部」，状态会变成 正常
3. 选模式：默认就是 智能，通常不用改；需要全部走节点时切 全局
4. 用起来：Agent 直接干活即可

界面

设置 → 网络代理：内核状态与端口、三种模式、本地代理地址、导入区，一屏看全。

内核（sing-box）

内核不放在仓库里（每个平台 50–65 MB），而是作为 Release 附件 提供：

• 设置页点 「下载内核」 即可自动完成：下载 → 校验 SHA-256 → 落盘 <DSH_HOME>/integrations/dsh-net-proxy/bin/sing-box → 启动
• 下载地址与哈希固定在 lib/core-manifest.js，可自行核对
• 本机访问 GitHub 受限？ 两种办法：
  1. 把 「镜像地址」 指向任何能提供同名文件的地址（例如某个 GitHub 加速前缀：https://<mirror-host>/https://github.com/gswenxue/dsh-egress-router/releases/download/v0.1.0），插件会在其后拼接附件名
  2. 手动下载后放到 <DSH_HOME>/integrations/dsh-net-proxy/bin/sing-box（Windows 为 sing-box.exe），插件会直接使用；也可以放在插件包内的 bin/ 目录
• 用的是未修改的上游构建，来源与许可见 THIRD_PARTY_NOTICES.md

给 Agent 的能力

权限与安全（请先读）

• 插件在本机以你的用户权限运行，会：
  • 监听 127.0.0.1 上的三个端口（默认 30810 本地代理 / 30811 内核 mixed / 30812 内核 Clash API，均只绑定回环地址）
  • 启动一个 sing-box 子进程，并按需下载该可执行文件（仅在你点击「下载内核」或首次需要时）
  • 读写 <DSH_HOME>/integrations/dsh-net-proxy/（state.json 节点库、sing-box.json 生成配置、sing-box.log 内核日志）
  • 按设置覆盖当前进程的代理环境变量，使 Agent 启动的子进程走本地代理（卸载时会还原）
• 节点信息只存在本地：state.json 含节点链接（内含 UUID/密码等凭据），请勿把该文件分享出去；本仓库不含任何节点数据
• 不收集遥测、不访问除你配置的节点与内核下载地址之外的任何服务
• 插件不修改 Harness 的全局 dispatcher：Harness 自身的 web_fetch 按设计豁免进程级代理，模型调用与遥测也不受影响

配置项

实测输出（本机真实结果）

$ curl -sS -o /dev/null -w "%{http_code} %{time_total}s\n" https://github.com
200 4.410922s

$ curl -sS https://api.github.com/rate_limit | head -c 60
{"resources":{"code_search":{"limit":60,"remaining":56,"r

$ git clone --depth 1 https://github.com/octocat/Hello-World /tmp/hello && git -C /tmp/hello log --oneline -1
7fd1a60 Merge pull request #6 from Spaceghost/patch-1

$ net_proxy test
节点测试结果：
- 节点A · 203.0.113.10:443 · 正常 713ms
- 节点B · node.example.com:443 · 正常 1530ms

被阻断域名的自动回退（路由器决策日志，via 为最终走向）：

github.com              → proxy
ghproxy.com             → fallback（直连 4000ms 无回应）→ proxy
registry.npmjs.org      → direct

兼容性

• DSH：实测于 0.2.0-rc.2（Web profile）。插件不声明强制 DSH peer 范围，安装不会被版本检查拦下
• Node：随 DSH 运行时（实测 Node 22）
• 平台：Linux / macOS / Windows，见上文内核表；其他架构需自行准备内核
• 不支持的输入：订阅链接（http(s)://）、hysteria / tuic / wireguard 等协议暂不支持

已知限制

• Harness 自带的 web_fetch 不走代理：DSH 的这个调用点故意把请求钉在已校验地址上，官方设计上豁免进程级 dispatcher。要取被阻断站点，请用 net_proxy 工具或终端里的 curl
• ws 路径里的查询串：path=/xxx?ed=2048 中的 ed 是 Xray 的客户端早发数据指令，不属于 HTTP 请求行；本插件已把它翻译成 sing-box 的 max_early_data（否则会被转义成 %3F 导致服务端 404）
• 本机没有 IPv6 出口时，IPv6 单栈节点标为「本机不可用」并跳过：不算失效、不会被删除，换台有 IPv6 的机器即可用
• 路由记忆是进程内的：dsh-web 重启后重新测量，首个请求会付一次竞速开销（通常几百毫秒）
• 端口被占用时可换：插件热重载时旧实例可能短暂占着 routerPort；新版会先强制断开旧连接并退避重试， 仍失败则面板会显示「本地代理未在监听：…EADDRINUSE」，把 state.json 里的 routerPort 换成别的端口 即可立即恢复（重启 dsh-web 会彻底清理）
• 吞吐采样有窗口：只观察建立后的 1.2 秒，本身响应就慢的站点可能被误判；降级 2 分钟后会自动重测
• 插件不支持自动更新：升级请卸载后重装
• 节点数上限 200，单次 fetch 默认截断 60000 字节

第三方组件

内核为 sing-box（SagerNet/sing-box，GPL-3.0-or-later，附加上游许可条款）的未修改上游构建，按 Release 附件分发。详见 THIRD_PARTY_NOTICES.md。

License

MIT © 2026 gswenxue