dsh-lan-gate
让局域网内的手机、平板、电脑用浏览器访问本机 DeepSeek Harness
首次访问需本机批准 · 设备令牌绑定 · 请求限流 · 手机排版适配 · 单文件零依赖
[!WARNING] 本项目已停止维护。 请改用 dsh-public-gate。
- 本仓库不再更新,不接收 issue / PR,也不会有功能更新或安全修复。
- 新项目覆盖局域网 + 公网两种场景:四种登录组合(密码 / TOTP / 邮箱验证码)、暴破锁定、HTTPS 反向代理、dsh 设置页内的配置面板;同样是进程内插件、零依赖。
- 迁移:先按新项目文档完成安装,再
dsh plugin --profile web remove dsh-lan-gate,删掉cordis.patch.yml里对应的行,最后重启 dsh。- 已适配 dsh 0.2.x(run-from-source 与桌面版 web profile),文档里的安装/配置步骤可用;但本项目不再接受新功能,仅保持可用。
Deprecated — superseded by dsh-public-gate. No further updates or security fixes.
一个自包含的单文件插件(lan-gate.mjs),进程内反向代理 + 首页注入,无外部依赖、无子进程。
特性
| 能力 | 说明 | |
|---|---|---|
| 内网访问 | 进程内反向代理 0.0.0.0:3088 → 127.0.0.1:3080,局域网设备打开 http://<电脑IP>:3088 即可用 |
|
| 首次访问批准 | 新设备第一次访问看到「等待本机批准」,本机在页面右下角「内网访问」浮层点允许后才放行 | |
| 每台设备指定排版 | 自动 / 手机 / 电脑 三种;手机档强制紧凑排版,电脑档即使窗口很窄也保持桌面版 | |
| 本机管理浮层 | 页面右下角常驻按钮,点开即用:状态、启停、批准/拒绝、切换排版、撤销、复制访问地址;也可直接访问 /lan-gate/admin |
|
| 状态持久化 | 批准记录写入 $DSH_HOME/lan-gate-state.json,重启 DSH 后仍有效 |
|
| 安全边界 | 管理接口仅放行本机请求;转发时把 Host 重写为回环地址并通过 DSH 的信任栅栏;撤销后已建立的连接数秒内断开 | |
| 设备令牌 + Cookie 绑定 | 每次批准签发 32 位随机令牌,设备用一次性认领链接换 lg_token(HttpOnly + SameSite),后续请求必须携带匹配 Cookie |
|
| 请求限流 | 每来源 IP 每分钟 120 个请求(滑动窗口),超限返回 429 + Retry-After |
|
| 监听地址可配 | 默认 0.0.0.0;放在前置代理/隧道后面时可收紧为 127.0.0.1 |
|
| 移动端兼容 | 门禁页手机适配、浮层在小屏自适应、crypto.randomUUID polyfill(内网 HTTP 非安全上下文) |
架构
请求进来后按三种状态分流:
| 状态 | 处理 |
|---|---|
| 未批准 | 返回门禁页 / 拒绝页,不转发任何内容 |
| 已批准但无有效 Cookie | 下发一次性认领链接,换取 lg_token Cookie |
| 已批准且 Cookie 匹配 | 转发(Host 重写 + WebSocket 升级转发) |
插件通过 webServer.tapIndex 向首页注入:crypto.randomUUID polyfill、设备排版 CSS,以及右下角「内网访问」浮层(原生 JS、零依赖,仅本机可见)。浮层不依赖 DSH 的界面结构,DSH 改版也不会影响它。
安装(跟着做,三步完成)
第 1 步:把插件文件放到 DSH 数据目录
DSH 的数据目录(DSH_HOME)里存放着你的配置,插件就放这里。先确认它在哪:
Windows(PowerShell),复制执行:
echo $env:DSH_HOME
# 如果上面输出为空,则默认在:C:\Users\你的用户名\.dsh
macOS / Linux(终端),复制执行:
echo "${DSH_HOME:-$HOME/.dsh}"
确认目录后,把插件放进去:
Windows(PowerShell)(把下面第一行换成你实际的 DSH 数据目录):
$dsh = "C:\Users\你的用户名\.dsh"
New-Item -ItemType Directory -Force -Path "$dsh\lan-gate" | Out-Null
Copy-Item ".\lan-gate.mjs" "$dsh\lan-gate\lan-gate.mjs" -Force
macOS / Linux:
DSH_DIR="${DSH_HOME:-$HOME/.dsh}"
mkdir -p "$DSH_DIR/lan-gate"
cp ./lan-gate.mjs "$DSH_DIR/lan-gate/lan-gate.mjs"
执行完,你应该能看到这个文件:<DSH数据目录>\lan-gate\lan-gate.mjs
第 2 步:注册插件(改一行配置文件)
打开文件:<DSH数据目录>\profiles\web\cordis.patch.yml
- 如果文件不存在,就新建一个;
- 如果文件里是
[](空配置),把[]整个替换成下面内容; - 如果文件里已经有内容,把下面这段追加到末尾。
- insert:
- id: lan-gate
name: 'file:///C:/Users/你的用户名/.dsh/lan-gate/lan-gate.mjs'
把 name: 里的路径换成你第 1 步实际放置的完整路径,规则如下:
| 系统 | 写法 | 例子 |
|---|---|---|
| Windows | file:///盘符:/完整路径 |
file:///C:/Users/你的用户名/.dsh/lan-gate/lan-gate.mjs |
| macOS / Linux | file:///完整路径 |
file:///home/me/.dsh/lan-gate/lan-gate.mjs |
最容易踩的坑(Windows):必须写
file:///D:/...,不能写D:/...。DSH 的插件加载器不会自动把 Windows 路径转成 URL,裸写会报错ERR_UNSUPPORTED_ESM_URL_SCHEME。
改完保存即可,不用改任何源码。
第 3 步:重启 DSH 并验证
完全退出正在运行的 DSH(终端里 Ctrl+C 结束),再重新启动:
pnpm dsh web # 从源码运行时 # 或你平时启动 DSH 的命令验证插件已加载(二选一):
- 浏览器打开
http://127.0.0.1:3080/lan-gate/status,看到类似{"state":"running","port":3088,...}就成功了; - 或者打开 DSH 网页 → 左下角齿轮进入设置,左侧导航出现「内网访问」。
- 浏览器打开
之后的日常使用见下方「使用」。
常见问题(按症状查)
| 现象 | 原因与解决 |
|---|---|
启动时报 ERR_UNSUPPORTED_ESM_URL_SCHEME |
第 2 步的路径没写成 file:/// 形式,改过来再重启 |
/lan-gate/status 打不开或 404 |
插件没加载成功,检查第 2 步配置,重启后看启动日志 |
| 面板显示「出错:EADDRINUSE」 | 3088 端口被占用:打开 lan-gate.mjs,把顶部 PROXY_PORT = 3088 改成其它端口(如 3089),重启 DSH |
手机打不开 http://<电脑IP>:3088 |
① 确认手机和电脑在同一网络;② 系统防火墙放行:Windows 管理员 PowerShell 执行 netsh advfirewall firewall add rule name="DSH LAN" dir=in action=allow protocol=TCP localport=3088 |
| 右下角看不到「内网访问」按钮 | 浮层只在本机可见,内网设备看不到是正常的;本机也看不到说明插件未加载(回第 3 步验证)。可先直接打开 http://127.0.0.1:3080/lan-gate/admin 判断 |
| 重启后手机又要重新批准 | 批准记录在 <DSH数据目录>\lan-gate-state.json,文件被删除或 DSH_HOME 变了才会丢;从旧版(临时插件)升级的用户需重新批准一次 |
| 手机显示「已绑定到其他浏览器」 | 该设备的令牌已发放给另一个浏览器(例如换浏览器、清了 Cookie、或同 IP 的别的设备抢先认领了)。在本机面板撤销该设备再重新批准,手机会自动重新认领 |
| 页面出现 429(请求过于频繁) | 该 IP 超过每分钟 120 个请求上限,等一分钟自动恢复;正常使用不会触发(网页应用远比这个频率低) |
| 用反向代理/隧道转发到本插件时全部被拒 | 前置代理过来的请求源 IP 不是本机局域网地址,需要在前置代理上配置登录认证后放行;然后把 LISTEN_HOST 改为 127.0.0.1 只让本机代理接入 |
使用
- 在电脑上打开 DSH 页面,点右下角的「内网访问」按钮:浮层显示运行状态与全部访问地址(点击可复制)
- 不想用浮层时,也可以直接访问
http://127.0.0.1:3080/lan-gate/admin
- 不想用浮层时,也可以直接访问
- 把地址发给手机(微信/QQ 发给自己即可),手机浏览器打开
- 手机显示「等待本机批准」,在浮层的待批准设备里选择 自动/手机/电脑 → 点允许,手机自动进入 DSH
- 随时在浮层里切换每台设备的访问方式、撤销、或停止服务
配置
插件顶部常量可按需修改(改完重启 DSH),也可以用环境变量覆盖(推荐,改文件升级时不易丢):
| 常量 | 默认值 | 环境变量 | 说明 |
|---|---|---|---|
PROXY_PORT |
3088 |
LAN_GATE_PORT |
内网访问端口 |
LISTEN_HOST |
0.0.0.0 |
LAN_GATE_HOST |
监听地址;放在前置代理/隧道后建议改为 127.0.0.1 |
RATE_LIMIT_PER_MIN |
120 |
— | 每 IP 每分钟请求上限,超限返回 429 |
TARGET_HOST |
127.0.0.1 |
— | DSH 服务地址 |
TARGET_PORT |
3080 |
— | DSH 服务端口 |
卸载
删除 cordis.patch.yml 中的 lan-gate 行(或整段 - insert:),重启 DSH。批准记录如需清除,删除 $DSH_HOME/lan-gate-state.json。
安全提示
- 本插件是内网转发:传输没有加密,请只在可信的局域网内使用,不要把
3088端口直接暴露到公网(端口映射到公网 = 裸奔) - 要上外网(WAN)必须先加 HTTPS + 登录认证,推荐方案(二选一):
- Cloudflare Tunnel + Cloudflare Access(免费,不需要公网 IP):Access 的登录与 MFA 挡在所有流量前面,再到本插件
- Caddy(自动 HTTPS)+ Authelia / basic_auth:有公网 IP/域名时的自托管方案
- 用了前置代理后,把
LISTEN_HOST改成127.0.0.1(或设LAN_GATE_HOST=127.0.0.1),只让本机代理接入 - 更省事的做法:直接用继任项目 dsh-public-gate,自带 HTTPS 与登录认证
- 本插件的自带防线(v1.1):每 IP 限流、设备令牌 + Cookie 绑定、管理接口仅本机、撤销即断开
- 已知限制(请了解):令牌绑定按 IP + Cookie 实现,同一个 IP 后面的多个设备(例如同一 NAT / 同一路由后的多台手机)共享一次批准;极端情况下同 IP 的攻击者理论上可在认领瞬间抢先换取 Cookie。真正的多设备/多用户隔离,请用上面推荐的「前置代理 + 登录认证」方案
- 撤销 = 立即断开对应设备(含已建立的连接),且撤销后重新批准会签发全新令牌,旧 Cookie 立即失效
兼容性
| 项 | 值 |
|---|---|
| 实测版本 | @deepseek-ai/dsh 0.2.2-rc.1(Node 24) |
| 声明支持 | dsh 0.2.x |
| 不兼容 | dsh 0.1.x(v1.2.0 起管理面板不再依赖 0.1.x 的设置页结构) |
| 未验证 | dsh 0.3 及以上 |
| 运行形态 | run-from-source 的 web profile;桌面版的 web profile 同样可用 |
| Node | ≥ 18(仅使用内置模块,实测 24) |
支持的浏览器:现代浏览器(Chrome / Safari / Firefox / 微信内置浏览器)。
依赖的 dsh 接口面 —— 大版本升级后重点核对:
| 接口 | 用途 |
|---|---|
webServer.register({ kind: 'exact', path, handler }) |
注册 /lan-gate/status、/lan-gate/action、/lan-gate/admin 三个路由 |
webServer.tapIndex(fn) |
往首页注入 polyfill、设备排版 CSS、右下角「内网访问」浮层 |
ctx.effect(fn, label) |
插件生命周期 |
升级 dsh 后如果右下角按钮消失、或
/lan-gate/status404,先确认这三处接口是否还在。
联系
本项目已归档,不再接收问题反馈。新项目相关问题请到 dsh-public-gate issues 提交。
许可证
MIT © 2026 xianyiliang
项目已归档;新需求请到 dsh-public-gate。
No comments yet. Be the first to write one.