远程接入网关baixianger/dsh-network

DSH Network

English · 简体中文

npm License: MIT DSH plugin

从局域网、Tailnet 或已有的 HTTPS 入口连接 DeepSeek Harness。客户端完成配对后，同一主机可以保留多条访问路径。

一台主机，多种连接方式

| 路径 | 地址 | 设置方式 |
| --- | --- | --- |
| 局域网 | 可达的本地网关地址 | 选择 LAN，扫描配对二维码。 |
| Tailnet | Tailscale Serve MagicDNS HTTPS 地址 | 在已登录的主机上选择 Tailscale。 |
| 自定义 HTTPS | 已运行的反向代理地址 | 创建二维码时提供该地址。 |

DSH 保持监听 loopback；插件在前面提供认证网关，使用短时配对票据、轮换的设备凭证和持久主机 ID。

快速开始

dsh plugin --profile web add dsh-network@latest
dsh web

打开 设置 → Network 查看主机并生成配对二维码，也可以在另一个终端运行设置向导：

dsh plugin --profile web exec dsh-network setup

选择 LAN、Tailscale 或 自定义地址，再用兼容客户端扫码。未指定模式时，向导会询问，不会自行选择。

默认网关端口是 3081。底层 DSH Web 服务仍在其配置端口监听 loopback。

选择连接路径

局域网：两台设备需要互相可达
dsh plugin --profile web exec dsh-network setup lan

Tailnet：需要先安装并登录 Tailscale
dsh plugin --profile web exec dsh-network setup tailscale

已有、可正常工作的 HTTPS 网关
dsh plugin --profile web exec dsh-network setup custom --url https://dsh.example.com

LAN 自动探测选错网卡时，可以用 --url http://HOST:3081 指定地址。Tailscale 设置会配置 Serve 转发到认证网关。公网自定义路径需要已有可信 HTTPS 和 HTTP/WebSocket 转发；本插件不配置 DNS、证书、防火墙或反向代理。

清晰的设置状态

Network 页面把主机身份和设备配对分开，提供字段标签、等待状态和就地错误提示，适配中英文与浅深色主题。离开设置页会取消仍在等待的请求。

配置有效的 HTTPS iosAppDownloadURL 后，可以显示可关闭的 App 下载卡片；未配置时不显示。

配置

| 字段 | 默认值 | 用途 |
| --- | --- | --- |
| gatewayPort | 3081 | 认证网关端口。 |
| bindHost | 0.0.0.0 | 网关监听接口；127.0.0.1 仅监听本机。 |
| hostName | 系统主机名 | 主机显示名称。 |
| statePath | $DSH_HOME/network/state.json | 配对与设备状态。 |
| historyChunkTrim | true | 移除历史响应中已完成步骤的冗余流式片段。 |
| historyTrustedHosts | [] | 历史路由允许的额外直连 Web Host 值。 |
| iosAppDownloadURL | 未设置 | 可选下载卡片的 App Store 或 TestFlight HTTPS 地址。 |

DSH_HOME 默认是 ~/.dsh。历史裁剪保留已显示消息、首 token 时间和当前未完成输出，减少重复增量，具体收益取决于会话；这些路由继续执行宿主的 origin 与跨站检查。

配对与凭证

配对票据一次有效，五分钟后过期。配对成功后，客户端获得刷新凭证和一小时有效的访问 token，刷新时两者一起轮换。主机仅保存哈希，不保存原始凭证；配对链接按需生成，不主动广播。

局域网 HTTP 依赖可信本地网络。公网应通过 HTTPS 暴露认证网关，不要暴露底层 DSH Web 端口。详见公网部署边界。

常见问题

| 现象 | 检查方向 |
| --- | --- |
| LAN 地址打不开 | 设备可达性、私有接口防火墙规则和选中的 IP。 |
| Tailscale 设置失败 | tailscale status 和已有登录状态。 |
| 公网路径失败 | 可信 TLS，以及 HTTP/WebSocket 反向代理转发。 |
| 二维码过期 | 重新生成一次性配对票据。 |

设置页的完整设备列表与撤销控制仍属后续工作；当前面板提供主机状态、已配对设备数量和配对入口。

开发与反馈

npm ci
npm run check

提交问题 · 版本记录 · MIT 许可证