dsh-plugin-lan-gateway
v0.1.1
Published
内网/隧道网关:让手机等设备访问 dsh 网页(dsh 仍只监听 loopback),自带登录口令,口令仅本机可改
Maintainers
Readme
dsh-plugin-lan-gateway
让手机等设备通过内网或隧道访问 dsh 的网页,而 dsh 自己仍然只监听 127.0.0.1。
手机 ──(网关登录口令)──▶ 网关 :3081 ──(网关代持 token / cookie)──▶ dsh @127.0.0.1:<dsh端口>安装
CLI="/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh"
"$CLI" plugin --profile desktop add dsh-plugin-lan-gateway或在插件市场里搜 dsh-plugin-lan-gateway 点安装。装完重启 DSH 生效。
为什么要这么绕
dsh web --host 0.0.0.0 被刻意拒绝:
--host 0.0.0.0 is intentionally not supported yet for safety:
it would expose remote code execution to the network; use 127.0.0.1 instead这个界面能执行 shell、读写文件,所以上游选择不让它绑到所有网卡。本插件不去绕那个闸: dsh 依旧只听 loopback,暴露面由插件自己控制——默认关闭、地址白名单、自带登录、卸载即恢复。
安全设计(默认值都是刻意的)
| 机制 | 说明 |
|---|---|
| 默认关闭 | 必须在本机 node lib/cli.js enable(或设 DSH_GATEWAY_ENABLE=1)才监听任何端口 |
| 无口令不启动 | 状态文件里没有口令记录时拒绝监听(fail closed) |
| 地址白名单 | auto 只取私有段 IPv4,并排除 utun*/tun*/tap*/ppp* —— 免得把界面顺手暴露到 VPN 网段;绑 Tailscale 地址要显式写出 |
| 公网地址需显式放行 | 绑非私有地址还要求 --allow-public(或 DSH_GATEWAY_ALLOW_PUBLIC=1) |
| token 不外泄 | 网关在服务端用 launch token 换取 dsh cookie 并自己持有;手机只拿网关自己的会话 cookie,URL 里从来没有 dsh token |
| 口令只存哈希 | scrypt + 随机盐,状态文件 0600,无明文 |
| 改口令即吊销 | 换口令同时轮换签名密钥,所有已登录设备立即失效 |
| 配置可在本机改 | 选项与口令同存一个 0600 状态文件,CLI 改完插件 3 秒内生效,不依赖环境变量、不用重启 App |
| 爆破防护 | 同一来源连续失败达阈值后锁定(默认 5 次锁 15 分钟) |
| 反 DNS rebinding | 网关自己校验 Host 必须属于它公告的权威集合(dsh 那层围栏只护 loopback,护不到网关) |
| 管理面本机独占 | 管理页挂在 dsh 自己的 loopback 服务器(/plugins/lan-gateway/admin),物理上无法从外部到达;网关还会显式拒绝转发该前缀 |
两个必须处理对的细节(都是实测踩出来的)
Origin必须跟着Host一起改写。dsh 的信任围栏要求「Origin 若存在就必须等于 Host」。 真实浏览器在 WebSocket 握手与 POST 上一定会带Origin(值是手机看到的网关地址);只改 Host 会得到 403,表现是"页面能打开、但 RPC 与实时流全坏"。curl 默认不带 Origin,所以这个坑 只有沙箱对照实验才暴露。- WebSocket upgrade 必须转发。GUI 的实时流走
/api/remote.mux;只做普通 HTTP 反代会半残。
配置:两种来源
优先级 环境变量 > 状态文件里的 options > 内置默认。两条路都在,是因为两种启动方式:
dsh web从终端起,环境变量顺手;- 桌面版 App(双击启动)拿不到终端的环境变量,所以配置用
node lib/cli.js enable …写进状态文件 (0600,和口令同一个文件),插件看门狗每 3 秒读一次,改完不用重启应用。
| 环境变量 | 对应的文件键 | 默认 | 说明 |
|---|---|---|
| DSH_GATEWAY_ENABLE | enabled | 关 | 置 1 启用网关 |
| DSH_GATEWAY_ADDRESSES | addresses | auto | 逗号分隔的监听地址;auto 按上表规则自动选,可以和固定地址混用(auto,100.x.y.z) |
| DSH_GATEWAY_PORT | port | 3081 | 监听端口 |
| DSH_GATEWAY_USER | user | dsh | 登录用户名 |
| DSH_GATEWAY_STATE | — | $DSH_HOME/lan-gateway.json | 口令/密钥状态文件(0600) |
| DSH_GATEWAY_AUTHORITIES | authorities | 空 | 额外允许的 Host 值(如 tailscale serve 的域名) |
| DSH_GATEWAY_SESSION_DAYS | sessionDays | 7 | 登录会话有效期 |
| DSH_GATEWAY_MAX_FAILURES | maxFailures | 5 | 连续失败几次后锁定来源 |
| DSH_GATEWAY_ALLOW_PUBLIC | allowPublic | 关 | 允许绑定非私有地址(公网 IPv6 等) |
用法
1. 设登录口令 + 启用(都在本机命令行,不经过任何浏览器)
cd ~/dsh-dingtalk-workspace/dsh-plugin-lan-gateway
# 设口令(交互输入、不回显、不进 shell 历史);换口令会立刻吊销所有已登录设备
node lib/cli.js set-password
# 启用:绑内网地址(auto = 私有段 IPv4,自动排除 VPN/隧道接口)
node lib/cli.js enable --addresses auto --port 3081
# 其它命令
node lib/cli.js status # 看配置、口令状态、实际会绑的地址
node lib/cli.js disable # 关掉监听(保留口令)桌面版 App 不需要重启:插件会在 3 秒内读到这份配置并开始监听。
也可以在本机管理页设置口令(http://127.0.0.1:<dsh端口>/plugins/lan-gateway/admin,
只在 loopback 上、外部不可达),但 CLI 更省事。
启动日志会给出手机能直接打开的地址,例如 http://192.168.1.10:3081/。
2. 手机打开 → 登录 → 用
手机会先看到网关登录页(这里没有 dsh token),登录后即是完整 GUI:会话列表、实时输出流
(/api/remote.mux 的 WebSocket)、输入框发任务,全都走这一条通道。
两个前置条件:
- 手机与电脑在同一个内网(下面的 Tailscale 章节解决"不在同一个内网");
- 电脑不能睡。合盖睡眠会让所有连接断掉,长任务期间建议:
caffeinate -s(或系统设置 → 锁定屏幕 → 显示器关闭时防止自动进入睡眠)。
外网:走 Tailscale(推荐)
dsh 网关天然适配 Tailscale:不开公网端口、不动路由器、隧道自带加密。
A. 直连 tailnet 地址(最省事)
# 1) 启动并登录 Tailscale(一次性,开浏览器授权)
open -a Tailscale
# 或命令行:/Applications/Tailscale.app/Contents/MacOS/Tailscale up
# 2) 取 tailnet 地址(形如 100.x.y.z)
/Applications/Tailscale.app/Contents/MacOS/Tailscale ip -4
# 3) 同时绑内网与 tailnet 地址(100.64/10 属于私有段,不需要 allowPublic)
node lib/cli.js enable --addresses auto,100.x.y.z --port 3081手机装 Tailscale 并登录同一 tailnet 后,访问 http://100.x.y.z:3081/ 即可。
传输由 Tailscale 的 WireGuard 加密;只有 tailnet 内设备能连。
注意:这种访问是
http://,浏览器不视为"安全上下文",个别 Web API(剪贴板、crypto.subtle) 可能不可用。要拿到真正的 HTTPS 用下面 B。
B. 用 tailscale serve 提供 HTTPS(推荐给外网)
Tailscale 能签发真实证书并终止 TLS,于是浏览器看到的是 https://<machine>.<tailnet>.ts.net/
——安全上下文,且外部仍无法直连。
# 网关只需监听本机,由 Tailscale 转发进来
node lib/cli.js enable --addresses 127.0.0.1 --port 3081 \
--authorities <machine>.<tailnet>.ts.net
# 另一终端:把 tailnet 的 HTTPS 转到网关
/Applications/Tailscale.app/Contents/MacOS/Tailscale serve --bg 3081DSH_GATEWAY_AUTHORITIES 填 Tailscale 转发时送进来的 Host。不确定填什么就看日志:
网关遇到没在白名单里的 Host 会打印
[lan-gateway] 拒绝未知 Host: "xxx.ts.net"(如属预期,请加入 DSH_GATEWAY_AUTHORITIES)照抄那个值即可(必要时带 :443)。
关于"直接用公网 IPv6"
本插件也支持,但要清楚代价(不推荐,除非你确实需要):
- 家用路由器默认禁止入站 IPv6,要手动加放行规则(有些固件没有这个开关);
- 运营商下发的前缀会变,接口的临时地址还会按 RFC 4941 轮换 → 需要 DDNS 才能稳定访问;
- 明文 HTTP 暴露在公网不合适,得自己解决 TLS。
# 说明:非私有地址必须显式放行
DSH_GATEWAY_ENABLE=1 DSH_GATEWAY_ALLOW_PUBLIC=1 \
DSH_GATEWAY_ADDRESSES=2001:db8:xxxx:xxxx::1 dsh web卸载 / 停用
- 停用监听:
node lib/cli.js disable(几秒内生效,不用重启);彻底不加载则从dsh.profile.bundles里去掉本包; - 卸载:
dsh plugin --profile web remove dsh-plugin-lan-gateway,再从 profile 的dsh.profile.bundles里删掉dsh-plugin-lan-gateway; - 想立即吊销所有已登录设备:在管理页换一次口令。
自检
node scripts/verify.mjs # 33 项:认证单元 + 配置来源 + 地址选择 + 真起服务的网关集成集成部分会真起一个假上游与一个网关,覆盖:登录页不含 token、口令错误 401、登录成功下发网关 cookie、
转发时 Host/Origin/Referer 改写与上游 cookie 替换、上游 401 自愈、管理路径不被转发、Host 白名单 403、
WebSocket upgrade(未登录拒绝 / 已登录 101 + 数据)、失败锁定 429;以及配置来源(默认 / 状态文件 / 环境变量
优先级、签名、setOptions 不动口令与密钥)、auto 与固定地址混用。
