baixianger/dsh-network

DSH Network

English · 简体中文

从局域网、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 许可证