dsh-plugin-reverse-proxy
llifco/dsh-plugin-reverse-proxy
Reverse proxy for the DSH Web UI that forwards a LAN port to 127.0.0.1:3080 with Host/Origin rewriting and token-free login. Listens on 127.0.0.1 by default; exposing it to the LAN requires an explicit switch with a security confirmation.
インストール
dsh plugin --profile web add github:llifco/dsh-plugin-reverse-proxyREADME
dsh-plugin-reverse-proxy
简体中文 | English
一条命令装上,局域网里的手机、平板、另一台电脑就能直接打开你的 DSH 网页界面, 而且不用再从启动日志里抄那串随机 token。
三个能力
1. 反向代理(默认启用)
局域网浏览器 ──▶ 0.0.0.0:8080 (本插件,开关开启后才会监听)
│ 改写请求头:
│ Host → 127.0.0.1:3080
│ Origin → http://127.0.0.1:3080
│ Sec-Fetch-Site → same-origin
│ Referer → 清空
│ 补充:X-Real-IP / X-Forwarded-For / X-Forwarded-Proto
▼
127.0.0.1:3080 (dsh web 本体)
dsh web 只监听回环,且会校验 Host / Origin 是否「像本机访问」,直接暴露到局域网会被 403。
以前靠 nginx 改写请求头,现在这段逻辑跑在插件里。
- 流式不缓冲(SSE、大文件下载不卡)
- WebSocket 用
net.connect手写 101 透传 - 长连接超时对齐 nginx 的 3600s,请求体上限 200 MiB
- 端口被占每 5 秒重试,加载期绝不抛异常
2. 局域网访问开关(默认关闭)
默认只监听 127.0.0.1:8080,也就是只有跑 DSH 的这台机器自己能打开后台。
要把后台共享给同一个 Wi-Fi / 局域网里的手机、平板、另一台电脑,必须在两个入口之一显式确认:
- 设置页:设置 → 局域网访问,点开关 → 弹安全提示 → 点「确定」才生效。
- 命令行(斜杠命令):在 DSH 输入框里发
/lan看状态,/lan yes开启(先给出同一份安全提示),/lan no关闭。 - 命令行(终端):
reproxy-lan status看状态,reproxy-lan enable需敲yes确认后才开,reproxy-lan disable直接关。
两个入口读写同一份状态文件 <DSH_HOME>/plugin-reverse-proxy/lan-access.json,
所以永远同步;切换后立即重建监听,重启 dsh 也不会丢,不需要重新打开。
⚠️ 开启后,同一网络里的任何设备直接访问
http://<这台机器的IP>:8080就能进入完整后台 (会话、终端、设置),不需要 Token、不需要登录。只在信任当前局域网时开启。
怎么用(三个入口,改的是同一份状态)
① 设置页
设置 → 局域网访问 → 点开关 → 弹「对局域网开放访问?」→ 点「确定」才生效。 左侧会同时显示「已开启 / 已关闭」,下面带状态与上次修改时间。
② 对话输入框里的斜杠命令
/lan 看当前状态
/lan status 同上
/lan yes 开启(打 yes 即确认)
/lan no 关闭
③ 终端命令(SSH 上机器)
reproxy-lan status # 看状态
reproxy-lan enable # 先打安全提示,输入 yes 才真正开启
reproxy-lan disable # 直接关闭
reproxy-lan --help
终端示例(status → enable → 输入 yes 确认 → 立刻监听 0.0.0.0:8080):

切换后立刻重建监听(旧连接会断开,重新打开即可),systemctl restart dsh 也不会丢,
因为状态存在 <DSH_HOME>/plugin-reverse-proxy/lan-access.json,一条 JSON 而已:
{ "lanAccess": true, "updatedAt": "2026-11-15T06:06:33.690Z", "updatedBy": "cli" }
想彻底关闭又不点开关?reproxy-lan disable 或 /lan no 都行;想手动改文件也可以,
插件用 fs.watch 盯着它,改完一两秒内自动生效(updatedBy 可以写 manual)。
3. 免 Token 登录(版本门控,命中才启用)
替换官方 @deepseek-ai/dsh-client-connection 提供方,跳过 BrowserAuth:
浏览器直接打开 Web 地址就能用。
- web-only:desktop 宿主一律休眠(多进程树判别),官方行为不受影响
- 精确版本白名单:runtime 与 connection 包必须成对命中已知版本,否则自动休眠、官方 connection 原样保留
- 不改 DSH 本体:只通过官方插件 patch 机制替换那一行,卸载/禁用即完全恢复
- 当前覆盖:
0.1.2-rc.10.1.5-rc.1/rc.20.1.7-rc.1/rc.20.2.0-rc.1/rc.20.2.1-rc.1~rc.50.2.2-rc.1/rc.2/rc.3
这部分参考并内联自
@iasiv5/dsh-skip-browser-auth(MIT), 在vendor/skip/下,保留其 LICENSE 与 NOTICE。
适用范围
| 场景 | 能不能用 |
|---|---|
Web UI 版(浏览器打开 http://<局域网IP>:8080,需先开启局域网访问) | ✅ 就是给它用的 |
| 桌面版 / 客户端版 | ❌ 用不上,也不建议用 |
桌面版本来就在本机跑,直连 127.0.0.1:3080 即可,不需要反代,也不需要跳过认证。
安装
git clone https://github.com/llifco/dsh-plugin-reverse-proxy.git
cd dsh-plugin-reverse-proxy
dsh plugin --profile web add .
或用 Release 里的包:
dsh plugin --profile web add ./dsh-plugin-reverse-proxy-0.3.3.tgz
装完重启一次宿主:
systemctl restart dsh
默认只监听 127.0.0.1:8080,所以装完先在本机打开 http://127.0.0.1:8080 确认能用。
要让手机 / 平板 / 别的电脑进来,先开「局域网访问」开关(见上一节三种入口),
再打开 http://<这台机器的局域网IP>:8080,无需 token。
第一次开启建议用终端,确认提示看得清清楚楚:
reproxy-lan enable # 读完提示,输入 yes
配置
反向代理(cordis.patch.yml 里 dsh-plugin-reverse-proxy 行):
| 配置项 | 默认值 | 对应原 nginx |
|---|---|---|
listenHost | 由「局域网访问」开关决定(默认 127.0.0.1) | listen 127.0.0.1:8080 |
listenPort | 8080 | 同上 |
listenIpv6 | false | listen [::]:8080 |
upstreamHost / upstreamPort | 127.0.0.1 / 3080 | proxy_pass |
upstreamHostHeader | 127.0.0.1:3080 | proxy_set_header Host |
upstreamOrigin | http://127.0.0.1:3080 | proxy_set_header Origin |
maxBodyBytes | 209715200 | client_max_body_size 200m |
retryMs | 5000 | —(端口冲突重试间隔) |
免 Token 登录(dsh-plugin-reverse-proxy-trusted-connection* 行)的 trustedHosts
由 DSH 的 Web 运行时配置自动注入,一般不用手改。
目录结构
dsh-plugin-reverse-proxy/
├── index.js # 入口:按 cordis 行 id 分发(反代 / 免登录)
├── lan-access.js # 局域网访问开关:状态读写 + 监听重建
├── cordis.patch.yml # 官方插件 patch:版本门控 + 插入两条能力行
├── assets/logo.jpg # 仓库头像
├── vendor/skip/ # 免 Token 登录实现(MIT,来自 dsh-skip-browser-auth)
│ ├── host.js gate.js compatibility.js
│ ├── trust-fence.js trusted-auth.js bridge.js
│ ├── connection-runtime.js
│ ├── adapters/ # carrier-neutral / -017 / -021
│ └── client.js # 浏览器端 bundle(已注入)
├── dist/*.tgz # 打包产物(离线安装用)
├── CHANGELOG.md
├── README.md / README.en.md
└── LICENSE
卸载 / 回退到 nginx
dsh plugin --profile web remove dsh-plugin-reverse-proxy
systemctl restart dsh
退回 nginx 反代:
ln -sf /etc/nginx/sites-available/dsh /etc/nginx/sites-enabled/dsh
nginx -t && systemctl reload nginx
常见问题
Q:只能本机打开,手机/局域网里的设备打不开?
这是 0.3.2 起的新默认:只监听 127.0.0.1。用 /lan yes 或 reproxy-lan enable 开启,
或者去 设置 → 局域网访问 点开关。开完 ss -ltnp | grep 8080 应该看到 0.0.0.0:8080。
Q:装完 8080 还是打不开?
ss -ltnp | grep 8080 看占用者。还是 nginx 的话,旧的 sites-enabled/dsh 软链没删,两个会抢端口。
Q:打开又要 token 了?
说明免登录那半休眠了——多半是 DSH 升级后版本不在白名单里。看日志有没有
BrowserAuth has been skipped;没有就是休眠,官方行为,功能上等价。
Q:能穿透公网吗? 不能,也不建议。它只把「局域网可访问」做对;公网请自己加隧道并做鉴权。
Q:桌面版能用吗?
用不上——桌面版本机直连 127.0.0.1:3080 即可。
反馈
- 问题反馈 / 功能建议 / 装不上的报错:QQ 3538638569(3538638569@qq.com)
- 反馈时带上
dsh --version、dsh plugin --profile web list和你看到的日志,能快很多。
许可
MIT(vendor/skip/ 内代码来自 @iasiv5/dsh-skip-browser-auth,同样 MIT)