dsh-lan-proxy

dsh 局域网/公网反向代理插件，运行在 dsh 进程内：对外监听 HTTP/HTTPS，转发到 dsh 回环服务。

dsh 禁止 --host 0.0.0.0；本插件即在 dsh 进程内套一层代理。纯 ESM、零构建、卸载自动清理（ctx.effect()）。

兼容 dsh 开发者预览版（web profile）。dsh 尚未 1.0、有破坏性变更，请按版本锁定 #v1.1.0。

安装

# 本地目录（用 file:，勿用 link:——link: 不装 bundle 依赖）
dsh plugin --profile web add file:/path/to/dsh-lan-proxy
# 或 GitHub
dsh plugin --profile web add github:mariGoIds/dsh-lan-proxy#v1.1.0
# 装完重启 dsh

默认仅服务本机；按「配置」开放局域网/公网。

功能

访问入口

• 双栈监听 ::（IPv4 + IPv6）：公网 IPv6 直连，免 NAT 配置
• IP 白名单（前缀/精确）：可信网段免密直进
• TLS :3443：证书缺失或端口占用只跳过对应监听，不杀 dsh

登录码

• 一次性登录码：本机手动生成、有租期、用一次即作废
• 生成入口两处：dsh 的「设置 → 插件 → 插件配置 → Lan Proxy」卡片，或本机网页 http://127.0.0.1:3080/__lan_code
• 登录码只在本机可见（公网访问该页面返回 404）
• 失败限流：按 IP + 全局双重计数，全局超限后指数退避锁定

已授权设备

• 每台设备一个独立令牌，可在设置页单独撤销
• 设备列表显示：设备标签 · IP · 授权时间 · 最近使用
• 设备表只存令牌的 sha256，明文令牌只在浏览器 cookie 里
• 令牌有服务端有效期，到期自动失效

与 dsh 的适配

• 客户端 bundle 补丁：让 dsh 把经反代访问的页面视作本机，否则设置页只写内存、刷新即丢
• 自动登录 dsh 网页 token：token 不进浏览器地址栏、历史、截图或访问日志

日志

• 每请求一行，403 也记，可落盘
• URL 里的 token 等敏感参数自动脱敏

配置

Schemastery schema；安全默认（白名单/登录码/日志全空）。在 profile 的 cordis.patch.yml 覆盖：

- id: lan-proxy
  config:
    listenHost: '::'
    httpListenHost: '127.0.0.1'
    listenPort: 3080
    tlsPort: 3443
    backendHost: 127.0.0.1
    backendPort: 3081
    allowedPrefixes: ['192.0.2.']   # 免密可信网段
    allowedIps: [198.51.100.25]
    cookieName: dsh_auth
    accessLog: true
    accessLogFile: ''               # '' = 仅进 dsh 日志器；非空则落盘
    certDir: ''                     # '' = $DSH_HOME/certs 或 ~/.dsh/certs
    forwardUntrusted: false         # true = 非白名单放行给 dsh
    patchClientBundle: true
    autoLogin: 'trusted'            # 'off' | 'trusted' | 'always'
    codeLogin: false
    codeLength: 6
    codeLeaseMinutes: 5
    codeMaxFails: 5
    codeGlobalMaxFails: 20
    codeLockMinutes: 10
    codeSessionDays: 30
    maxDevices: 20
    deviceStateFile: ''             # '' = $DSH_HOME/lan-proxy-devices.json

访问判定

① 白名单 IP（本机 / allowedIps / allowedPrefixes）→ 直接放行。

② 非白名单 + 开启 codeLogin → 校验设备会话 cookie，无有效 cookie 则给登录页。

③ 非白名单 + 未开 codeLogin → 看 forwardUntrusted：false 返回 403，true 放行给 dsh。

一次性登录码

手机等非白名单设备打开 dsh 时，输入本机生成的登录码即可进入。

生成 / 查看（两处同一功能）：

• dsh 界面：「设置 → 插件 → 插件配置 → Lan Proxy」卡片，带「生成登录码 / 重新生成 / 立即作废」按钮与剩余时间
• 本机网页：http://127.0.0.1:3080/__lan_code

- id: lan-proxy
  config:
    codeLogin: true
    codeLength: 6            # 纯数字，1/10^codeLength 单次命中率
    codeLeaseMinutes: 5      # 租期，逾期作废
    autoLogin: 'always'      # 过了码这道门后，dsh token 由代理代取

限流：码是纯数字且租期内有效，必须配合失败限流。限流分两层 —— codeMaxFails 按 IP 计数，codeGlobalMaxFails 按全部来源合计计数。只有单 IP 那层时，攻击者轮换代理即可把额度成倍放大。

达到全局上限后全局上锁，且反复触发会让锁指数变长（10min→20min→40min…上限 24 小时），长时间安静后级别自动归零。

全局限流代价：攻击者可借此把合法远程用户挡在门外。故 codeGlobalMaxFails 不要调得过低。

已授权设备

每台通过登录码授权的设备各持一个独立令牌，可单独撤销。

• 设置页卡片列出全部已授权设备，每行一个「撤销」按钮，底部有「全部撤销」
• 设备上限 maxDevices，超出时挤掉最久未使用的
• 设备表落盘只存令牌的 sha256（$DSH_HOME/lan-proxy-devices.json），明文令牌只存在于浏览器 cookie
• 令牌有服务端有效期 codeSessionDays，到期即失效
• 重启不掉线：校验走哈希比对，设备表持久化

客户端 bundle 补丁（patchClientBundle）

dsh 0.1.2+ 在客户端按页面主机名判定「本页是否本机」：

isLoopback: transport?.ownsHost === true || pageLocation === void 0
            || isLoopbackHostname(pageLocation.hostname)

该值只被设置页消费（persistence = isLoopback ? 'host' : 'memory'）。经反代访问主机名必然不是 127/8，于是设置只写内存、刷新即丢。

插件在转发时把该判定替换为 true。实现要点：

• 不改磁盘文件，每次请求实时改写 ⇒ dsh 升级后无需重打补丁
• 定位方式：dsh 把 bundle 合并成一次请求下发（/plugins/??a/client.js,b/client.js&rev=<内容哈希>），按查询串是否含 dsh-client-connection/client.js 判定
• 保留 gzip（解压→替换→回压）：该 bundle 未压缩约 11.5MB、gzip 后约 4.0MB
• 保留上游 cache-control，只在正文变化时去掉 ETag
• 任一环节出错都退回原包；锚点失配时静默透传

自动登录 dsh token（autoLogin）

dsh 0.1.2+ 的首页要求先经 /?token=<进程token> 换取 cookie，否则一律 401。该 token 由 dsh 启动时随机生成、只存在内存。

autoLogin 开启后由代理代为完成这次交换，token 不进浏览器地址栏、历史、截图或访问日志。

⚠️ 'always' 会让 dsh 的 token 门对来访者完全透明。此时必须有另一道闸门（IP 白名单或 codeLogin），否则等价于无认证——任何人都能驱动 agent 执行命令。

访问日志

accessLog: true 时每请求一行，403 也记：

2026-08-17T04:00:00.000Z https ip=2001:db8::99 "GET /" 200 12ms 48213b

URL 里的敏感查询参数会自动脱敏（token / access_token / auth）：

2026-08-17T04:00:00.000Z https ip=2001:db8::99 "GET /?token=<redacted>" 303 3ms 0b

已知限制

• 白名单是免密通道：别放不可信网段（如移动宽带）
• 登录码只在本机可见。人在外网看不到本机屏幕时，改用白名单（如虚拟局域网）
• 访问日志无轮转：accessLogFile 只增不减，需自行清理
• 全局限流可被用于 DoS：攻击者故意输错可把合法远程用户挡在门外
• bundle 补丁依赖 dsh 内部写法：锚点失配时静默透传（功能降级、不报错），dsh 大版本升级后建议复查设置页是否仍能保存
• 设备标签由 UA 粗略推断（仅作展示，不参与任何判定）

证书与公网 IPv6

:: 默认已监听 v6，公网访问 https://<IPv6>:3443。证书 SAN 必须含该 IPv6（或域名），否则浏览器报名称不匹配；SLAAC 地址会变，优先 DNS/DDNS。无 IPv6 时用 listenHost: '0.0.0.0' + 路由器端口转发。

生成证书（文件固定 certDir/key.pem、certDir/cert.pem）：

openssl req -x509 -newkey rsa:2048 -nodes -keyout key.pem -out cert.pem -days 3650 \
  -subj "/CN=DeepSeek-Harness-LAN" \
  -addext "subjectAltName=DNS:example.com,IP:192.0.2.10,IP:127.0.0.1,DNS:localhost"

证书缺失只禁用 HTTPS，HTTP 照常（记 warning）。

开发

npm test   # node:test，fake request 驱动，无需运行 dsh

License

MIT