dsh-phone-tunnel

把正在运行的 DeepSeek Harness 网页界面挂到组网网卡上 —— 在服务进程内部完成， 不需要第二个实例，不需要 SSH，也不用碰路由器。

中文 | English

它做什么

dsh web --host 只接受一个具体的网卡地址，并且拒绝通配。所以只监听 127.0.0.1:3080 的实例， 手机看不见；而开机之后才出现的 TAP（星空组网的 StarVPN）或 utun 网卡，也不在它启动时的那一份地址表里。

这个插件在已经在跑的那个进程内部多开一个组网端口：

手机 ──▶ 192.168.188.1:3081 ──▶（插件反代）──▶ 127.0.0.1:3080（你正在用的这个 dsh）

一个实例、一份会话列表：不会出现 task-board ledger is already owned by …，也不会出现两台服务状态不同步。

安装

dsh plugin --profile web add dsh-phone-tunnel

不方便用 npm，或者你的 npm 指向国内镜像？用 Release 里的 tgz：

dsh plugin --profile web add \
  https://github.com/SilverKurali/dsh-phone-tunnel/releases/latest/download/dsh-phone-tunnel.tgz

从本地目录装（改代码的人用这个）：

dsh plugin --profile web add link:/绝对路径/dsh-phone-tunnel

完整的四种装法、验证步骤、卸载与故障表见 INSTALL.md。

装完重启 profile，左侧导航会多出**「组网访问」**：

功能块	内容
当前状态	反代是否在跑、DSH 自己的监听端口、找到几张组网网卡
动作	在组网地址上开端口 / 关闭 / 刷新
手机地址	给手机打开的地址，带复制按钮
第一次用星空组网？	邀请注册链接 + 成员账号规则

HTTP 接口

面板只是两个接口的外壳，故意做得极小：

GET  /api/dsh-phone-tunnel/status   → { ok, host:{upstream,port}, interfaces[], mesh[], proxy{...}, referral }
POST /api/dsh-phone-tunnel/proxy    → { action:'start' | 'stop', port? }

不开浏览器也能排查：

curl -s http://127.0.0.1:3080/api/dsh-phone-tunnel/status

配置（可选）

写在 profile 的 patch 层里，每一项都有默认值：

- id: mesh
  name: dsh-phone-tunnel
  config:
    interfacePattern: '^(StarVPN|utun\d+|tap\d+|tun\d+|wg\d+|gpd\d+|ppp\d+|ipsec\d+)$'
    addressPrefix: '192.168.'
    proxyPort: 3081
    upstream: 127.0.0.1

addressPrefix 的作用是别把 tun* 上的公网地址当成组网地址。

为什么 cookie 能一直用

带 ?token= 的请求返回 303 并种下 dsh-auth-*（HttpOnly、SameSite=Strict、Max-Age=2592000， 即 30 天）。cookie 载荷里写死了签发时的 authority：

{"version":1,"authority":"192.168.188.1:3081","issuedAt":…,"expiresAt":…}

签名密钥存在持久的凭据记录里（不是每进程随机），所以重启也在。反代每次请求都把 Host 改写成上游 authority，于是 cookie 里的 authority 与服务端期望的一致 —— 这就是换个端口访问还能继续用 同一份 cookie 的原因。

反过来也成立：换了组网 IP 或端口，就得重新点一次 token 链接。

限制

• 插件动不了自己进程的监听地址。组网端口是反代，不是把主服务再绑一次。
• 只考虑 IPv4 组网地址。
• 仍然依赖隧道本身的质量。星空组网走中继时实测单向约 0.4 MB/s，[SN-RTT] 会抖到几秒， 长回答可能中途停住，刷新一下能接回来。
• 同一份 ~/.dsh 只允许一个实例持有 task-board 锁；这是刻意的，本插件就是为避开它而存在。

配套

命令行版（在 DSH 还没启动、或者机器上没有 Node 插件环境时使用： 起第二个实例绑到组网 IP，附带防火墙规则与二维码）： dsh-mesh-kit，支持 Linux / macOS / Windows。

设计取舍与实测数据见 docs/architecture.md。

许可

MIT。