分流代理路由yangzhe1991/dsh-proxy-router

dsh-proxy-router

npm downloads
license
dsh-plugin

DSH(DeepSeek Harness)分流代理插件:只有规则命中的被墙域名走上游代理,其余(国内站点、内网地址、未知域名)一律直连,配置项直接放在 Web 设置页里。

起因很实际:启动 dsh 时 export https_proxy=... http_proxy=... all_proxy=... 之后,连 api.deepseek.com、www.baidu.com 都绕一圈代理。这个插件把「什么时候该走代理」变成一张可维护的规则表,把「上游是谁」变成一个能随时改的设置项。

覆盖范围

装上之后,下面这些出网全部先经过插件的本地分流代理,再按规则决定去向:

| 出网来源 | 说明 |
| --- | --- |
| 主进程 fetch() | LLM API(api.deepseek.com)、web_search、MCP、插件自己的 HTTP 请求 |
| web_fetch 工具 | 宿主 proxyRouteFor() 与主进程同一口径 |
| bash 子进程 | curl、git、npm/pnpm 等,经 http_proxy + NODE_USE_ENV_PROXY 继承同一路由 |

工作原理

DSH 主进程 fetch / web_fetch / bash 子进程
│  插件把宿主代理策略里的 http(s) 代理指向本地分流代理
▼
本地分流代理(插件内置,只监听 127.0.0.1:17890)
├── 命中 proxy 规则 → 上游代理(设置页里配的那个地址)
└── 其余(默认)     → 直连

规则三层优先级,先命中者生效:

1. 本地规则文件(~/.dsh/proxy-router/rules.txt)—— 你按实际经验增删,改完即时生效
2. 远程被墙清单(默认 Loyalsoldier/clash-rules 的 gfw.txt + greatfire.txt,经 jsDelivr,带缓存与 24h 刷新)
3. 内置种子清单 —— 离线首启时的兜底(约 140 个高频被墙域名)
4. 都不命中 → defaultRoute(默认 直连)

另外:回环地址与内网地址永远直连(127.0.0.0/8、10/8、172.16/12、192.168/16、169.254/16、100.64/10、IPv6 ULA/链路本地、以及 nas 这类单标签主机名),不会被丢给上游代理。

安装

dsh plugin --profile web add @yangzhe1991/dsh-proxy-router

然后重启 dsh web。

本地开发用 link: 装:在 ~/.dsh/profiles/web 下把依赖改成 "@yangzhe1991/dsh-proxy-router": "link:/path/to/repo",然后 pnpm install 并重启。

设置页(推荐用法)

重启后打开 设置 → 插件 → 插件配置,展开「代理分流(proxy-router)」卡片:

| 字段 | 说明 |
| --- | --- |
| 上游代理 | 例如 http://192.168.3.47:12801;留空则沿用启动环境里的 https_proxy / http_proxy |
| 未命中任何规则时 | 直连(推荐)或 走上游代理 |
| 远程被墙清单 | 一行一个 URL;清空即不加载任何远程清单 |
| 清单刷新周期 | 小时;0 表示只用手上已有的缓存 |
| 本地分流代理监听地址 | 形如 127.0.0.1:17890 |
| 连接超时 | 毫秒;只作用于建立连接阶段,不影响流式响应 |
| 上游失败时回退直连 | 走上游的连接失败时自动改用直连 |
| 打印每次请求的分流日志 | 排查时打开,日志进宿主 stderr |

卡片底部是运行状态:监听地址、上游及其来源、宿主策略是否已接管(以及 bash 子进程走没走分流)、规则条数、命中统计、本地规则文件路径、每条远程清单的条数与更新时间。

几个要点:

- 改完保存即时生效,不用重启 dsh:上游、默认走向、超时、回退、调试开关都是现读的;改监听地址会立即重新绑定,并把宿主策略重新指过去。
- 设置写到 $DSH_HOME/settings.yaml(默认 ~/.dsh/settings.yaml)的 proxy-router: 分节;每个字段旁边有「恢复默认」,点了就把该字段从用户层删掉、回到组合配置/默认值。
- 字段是否「已覆盖」只看它在不在用户层,与值本身无关;并发改动靠 revision 栅栏拒绝,不会静默覆盖。

⚠️ 在设置页配好上游之后,启动命令里就不要再 export http_proxy/https_proxy/all_proxy 了。
宿主在启动阶段就把那三个变量的值定格成「bash 子进程要用」的一份快照,子进程会优先用它,
于是 curl/git/npm 会绕过插件直接连你 export 的上游。插件检测到这种情况会在日志里明确告警,
并在状态面板里把 bash 子进程标成「直连上游(绕过分流)」。

组合配置(部署默认值)

设置页里的值是用户层,它盖在 profile 组合配置(部署默认值)之上。适合写在这里的是「这台机器上就长这样」的默认值,例如:

~/.dsh/profiles/web/cordis.patch.yml
- id: proxy-router
config:
upstream: http://192.168.3.47:12801
debug: false

组合配置里还认两个只在部署层有意义的路径字段(不进设置页):

| 字段 | 默认值 | 说明 |
| --- | --- | --- |
| stateDir | ~/.dsh/proxy-router | 缓存与默认规则文件所在目录 |
| rulesFile | /rules.txt | 本地规则文件路径 |

设置页里的每个字段都可以写在组合配置里作为默认值;lists 在组合配置里既可以是 URL 字符串数组,也可以是 { name, url, route } 对象(设置页会把它压平成 URL 列表)。

本地规则:按经验增删

文件默认在 ~/.dsh/proxy-router/rules.txt,首次运行会自动生成带注释的模板。改完立即生效,不用重启 dsh(路径在设置页的状态面板里也能看到,但文件本身只能用编辑器改)。

每行一条,# 开头是注释;自上而下匹配,先命中者生效
proxy: some-blocked-site.com     # 该域名及其所有子域 → 走上游代理
direct: cdn.example.cn           # 该域名及其所有子域 → 强制直连
example.com                      # 裸域名等价于 proxy:

- 本地规则优先级最高:远程清单误伤了某个国内站点,加一条 direct: 就纠正了。
- 兼容写法:*.example.com、.example.com、+.example.com、DOMAIN-SUFFIX,example.com、DOMAIN,example.com(精确匹配)、DOMAIN-KEYWORD,ads;顺手也认 dnsmasq 的 server=/example.com/114.114.114.114。
- 中文域名会自动转 punycode 再匹配。

调试

本地分流代理自带一个只监听本机的调试接口:

总览:监听地址、上游、规则条数、命中统计、策略自检结果
curl -s http://127.0.0.1:17890/__proxy-router/status

问某个域名会怎么走
curl -s "http://127.0.0.1:17890/__proxy-router/why?host=www.google.com"
→ {"host":"www.google.com","route":"proxy","reason":"list:gfw:google.com"}

手动重载规则(本地 + 远程)
curl -s http://127.0.0.1:17890/__proxy-router/reload

设置页那张卡片读的是同一个状态快照,走宿主 Web 服务器的同源只读路由 GET /dsh-proxy-router/status。

直接用 curl 验证分流效果:

curl -x http://127.0.0.1:17890 -sI https://www.google.com   # 走上游
curl -x http://127.0.0.1:17890 -sI https://www.baidu.com    # 直连

启动日志会打印上游来源、监听地址、规则条数、策略自检结果、设置页入口,以及「bash 子进程是否也走分流」。

健壮性

- 不会自我递归:目标指向本代理监听地址的请求一律拒绝转发(明文 421、/favicon.ico 204、根路径给人话提示)。
否则「在浏览器里打开 http://127.0.0.1:17890/... 看状态」这类无害操作会引爆自我循环
—— 0.1.0 曾因此刷出上亿次请求,故 0.1.1 起强制拦截。
- 上游填成自己会被忽略:上游等于本插件监听地址时按「未配置上游」处理,并在日志与状态面板里明确告警,避免 CONNECT 回自己。
- 告警限流:同一类失败每 5 秒最多一行,并汇总被抑制的条数,任何异常放大都不会刷屏终端。

兼容性

- 自 0.1.0 起在 dsh 0.1.5-rc.2 上验证通过(0.1.1 的防自环修复同样验证于该版本)。
- 宿主半只依赖 @deepseek-ai/dsh-http-proxy、@deepseek-ai/schemastery、undici 的公开导出与 cordis 的 ctx.get / ctx.effect / ctx.inject;
浏览器半只 require react,不依赖任何 UI 包。
- 设置页用的是官方设置体系(ctx.settings.installSection + settings.plugin.item 槽位);
部署没挂设置提供方时,插件自动退回组合配置,其余功能不受影响。

已知边界

- 上游只支持 HTTP 代理(http:// / https://)。all_proxy=socks5://… 会被忽略并告警;如果你的代理同时提供混合端口(mihomo/clash 的 mixed-port),把 http://host:port 配给上游即可。
- 不做 TLS 中间人:https 只按 CONNECT 里的域名分流,不解析内容 —— 所以也无法按 URL 路径分流。
- 规则只支持域名后缀、精确域名、关键字与 IP 字面量,不支持正则表达式。
- 本地分流代理只监听 127.0.0.1,不对局域网暴露;本地规则文件不能在设置页里编辑(只显示路径)。

License

MIT