dsh-hub-plugin
Verifieddsh-hub-plugin · v0.3.0 · MIT · Web UI
把 DSH 安全地发布到局域网/公网:访问密码、二维码、设备导航、cloudflared 隧道,全部在设置页里管理。
Install
dsh plugin add dsh-hub-plugin Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
DSH Hub 远程访问(dsh-hub-plugin)
把本机 DSH(DeepSeek Harness)安全地发布到局域网 / 公网:访问密码、二维码、设备导航页、cloudflared 隧道,全部在 DSH 设置页里管理,不需要命令行。
适合:用手机/平板/另一台电脑,通过浏览器远程使用这台电脑上的 DSH 会话。
特性
- 访问密码:URL 不含密码,打开后必须输入;登录后 30 天 HttpOnly Cookie
- 局域网 + 公网:同一 WiFi 直连;公网用 cloudflared(免费随机域名,或命名隧道固定域名)
- 设备导航页:二维码、分享链接、访问密码,一键复制
- 桌面版直连:直接发布 Electron 桌面版宿主,不额外起第二个宿主
- 多宿主冲突提示:检测到桌面版与
dsh web同时运行会提醒(避免会话写租约互相锁) - 插件形态:随 DSH 启停,设置页开关,无需单独开终端
- 安全默认:默认关闭;密码至少 8 位;管理接口仅宿主同源可写
工作原理
手机 / 平板 / 另一台电脑(浏览器)
│ https://xxxx.trycloudflare.com(访问密码)
▼
cloudflared 隧道
▼
┌──────────────────────────────┐
│ 本机 DSH Hub 反代 :19388 │
│ - 密码页 / 30 天 Cookie │
│ - Host 改写(绕过 Host 栅栏)│
│ - 设备导航页 / 二维码 │
└──────────────┬───────────────┘
│ 127.0.0.1:<DSH 端口>
▼
┌──────────────────────────────┐
│ DSH 宿主(桌面版或 dsh web) │
│ - 会话、工作区、插件 │
└──────────────────────────────┘
设置页 ── 同源路由 /dsh-hub/* ──> 宿主插件 ──> 反代子进程
DSH 默认只监听 127.0.0.1,并对 Host 有校验。Hub 在本机做反向代理:把 Host 改写成 127.0.0.1:<port>,同时用本机密钥签发 DSH 认可的会话 Cookie,再把入口保护在访问密码之后。
安装
从 GitHub 安装(推荐)
https://github.com/dbssAlan/dsh-hub-plugin
- 桌面版:设置 → 插件 → 添加插件,填上面的仓库地址
- 命令行(web profile):
dsh plugin --profile web add -w https://github.com/dbssAlan/dsh-hub-plugin
安装后打开:Ctrl + , → 远程访问。
本地目录(开发)
git clone https://github.com/dbssAlan/dsh-hub-plugin.git
桌面版:设置 → 插件 → 安装 → 选择本地目录。
桌面 profile 由 Electron 管理,不能用
dsh plugin --profile desktop直接安装,请走桌面端插件页。
从源码运行(web profile)
DSH_HOME=/path/to/home dsh plugin --profile web add -w /path/to/dsh-hub-plugin
快速开始
- 打开 设置 → 远程访问
- 勾选「启用远程访问」
- 填访问密码(至少 8 位)
- 选隧道模式:
off(仅局域网)/quick(免费随机域名)/named(固定域名) - 点「保存并重启」
- 点「打开设备导航页」看二维码,手机扫码 → 输入密码 → 进入 DSH
手机打开公网地址后输入密码,30 天内免登录。
配置项
首次启动时,Cordis 配置会写入 %DSH_HOME%/dsh-hub-plugin/config.json;之后以设置页 / 该文件为准(JSON 覆盖 YAML)。
| 字段 | 默认 | 说明 |
|---|---|---|
enabled |
false |
启用远程访问 |
password |
"" |
访问密码,至少 8 位 |
listenPort |
19388 |
本机反代端口 |
tunnel |
quick |
off / quick / named |
tunnelToken |
"" |
命名隧道 Token(Cloudflare Zero Trust) |
publicUrl |
"" |
命名隧道对外地址,如 https://dsh.example.com |
targetPort |
0 |
目标 DSH 端口;0 = 自动(当前宿主) |
命名隧道(固定域名)
- Cloudflare Zero Trust → Networks → Tunnels → Create a tunnel
- Public Hostname 指向
http://127.0.0.1:19388(与listenPort一致) - 复制 Tunnel Token
- 设置页:隧道模式选
named,填入 Token 和你的域名(如https://dsh.example.com) - 保存并重启
快速隧道的域名每次重启会变;固定域名请用命名隧道。
安全模型
- 访问密码是唯一门槛,且不在 URL 里;链接被转发也无法直接进入
- 登录 Cookie:30 天、
HttpOnly、SameSite=Lax - 登录失败限速:5 次 / 60 秒
- 设置页写接口走宿主同源路由
/dsh-hub/*,校验同源Origin - 公网入口由 cloudflared 提供 TLS,本机端口不直接暴露
注意:DSH 可以执行本机命令,密码泄露等于电脑控制权。密码明文保存在 config.json(权限 0600),建议用 16 位以上随机串;公网长期使用建议叠加 Cloudflare Access。
更多见 SECURITY.md。
与同类方案的区别
| 本插件 | dsh-pocket | dsh-remote | dsh-mobile | |
|---|---|---|---|---|
| 形态 | DSH 插件 | DSH 插件 | DSH 插件 + 云端 | 手机 App |
| 桌面版宿主 | ✅ 直接发布 | 兼容模式 | 需 dsh web |
需 dsh web |
| 公网通道 | cloudflared | cloudflared | 自建/云端中继 | relay / SSH |
| 移动端 UI | 原生 Web | 专门适配 | 完整 Web | 原生 |
| 额外账号/服务 | 无 | 无 | 有 | relay 服务 |
| 多宿主冲突检测 | ✅ | — | — | — |
本插件的取舍:零第三方账号、直连桌面版、设置页一体化;移动端 UI 与原生 App 不是它的目标(可作为后续迭代)。
排错
| 现象 | 处理 |
|---|---|
| 设置页显示「连不上宿主管理路由」 | 确认插件已启用、桌面版已重启;必要时 Ctrl + R 刷新页面 |
公网 401 dsh web authentication required |
直接访问了不带密码的 URL;先打开登录页输入密码(或用带口令链接登录一次) |
error 1033 / 隧道连不上 |
本机代理/VPN 的 TUN 模式可能掐断隧道;关 TUN,或给 trycloudflare.com、argotunnel.com 加直连规则 |
session/writer-held |
另一个 DSH 宿主占着会话;只保留一个宿主(桌面版或 dsh web) |
| 端口 19388 被占用 | 设置页改 listenPort,或先在 /_health 确认是否已有实例 |
| 桌面版重启后公网地址变了 | 快速隧道特性;改用命名隧道固定域名 |
日志与状态:
- 日志:
%DSH_HOME%/dsh-hub-plugin/hub.log - 状态:
%DSH_HOME%/dsh-hub-plugin/status.json - 健康检查:
http://127.0.0.1:<listenPort>/_health
常见问题
Q:为什么不用 SSHJ 或 VPN? 本插件面向「手机/平板随手打开浏览器」;SSH/VPN 在鸿蒙/移动网络下的体验和配置成本更高。需要网格组网可以用 Tailscale,本插件也兼容(把地址换成 tailnet 地址即可)。
Q:要装 cloudflared 吗?
不需要手动装:插件首次建立隧道时会自动下载到 %DSH_HOME%/bin(约 53 MB)。也可以提前用 winget install --id Cloudflare.cloudflared 安装。
Q:会话会和其他设备冲突吗? 不会——所有设备访问的是同一个宿主,共享同一批会话。冲突只发生在「两个 DSH 宿主同时打开同一会话」时,插件会提示并支持停掉 extra 宿主。
Q:能同时用桌面版和 dsh web 吗?
可以,但每个会话只能有一个宿主写入(DSH 的跨进程租约)。建议只保留一个宿主。
Q:手机能免密吗? 首次输入密码后发 30 天 Cookie,期间免密;换浏览器/清 Cookie 需要重新输入。
开发
git clone https://github.com/dbssAlan/dsh-hub-plugin.git
cd dsh-hub-plugin
node --check index.js
node --check client.js
node --check lib/hub-cli.mjs
目录:
index.js # host 半:Config、/dsh-hub/* 同源路由、子进程生命周期
client.js # 浏览器半:设置页(settings.section)
lib/hub-cli.mjs # 反代/密码页/设备页/隧道(可独立运行)
lib/vendor/ # 离线二维码库
locale/ # 插件市场显示用
独立运行(不经插件,便于调试):
node lib/hub-cli.mjs --port 19388 --no-tunnel
路线图
- v0.1 插件骨架 + 设置页入口
- v0.2 设置页开关/密码/隧道,保存即生效
- v0.3 同源路由
/dsh-hub/*,不再跨端口 - v0.4 PWA 与移动端样式注入
- v0.5 设备级令牌与撤销、登录审计
许可
MIT。二维码库使用 qrcode-generator(MIT),见 lib/vendor/。
English
DSH Hub is a DeepSeek Harness plugin that exposes your local DSH instance to LAN or the public internet behind an access password. It reverse-proxies the DSH host (desktop Electron or dsh web), rewrites the Host header, mints a valid session cookie, and optionally starts a cloudflared quick or named tunnel. Everything is configured from the DSH settings page (Ctrl + , → Remote Access).
Install:
https://github.com/dbssAlan/dsh-hub-plugin
Use DSH's plugin page (desktop) or dsh plugin --profile web add -w <url>. MIT licensed.