前言¶
DeepSeek Harness（DSH）默认绑定在本地回环地址上，限制了从局域网或远程服务访问的能力。DSH Network 插件位于 DSH 之前，提供认证网关，支持通过 LAN、Tailnet 或自定义 HTTPS 端点连接。该插件允许一次配对并绑定多个路由。
安装与启用¶
使用官方命令安装并启动 DSH Web 服务：
dsh plugin --profile web add dsh-network@latest
dsh web
核心功能¶
该插件提供以下能力：
* 多路由支持：支持 LAN、Tailnet 和自定义 HTTPS 连接。
* 连接管理：一次配对，多路由绑定。
* 认证网关：提供带有短期配对票据、轮换设备凭据和持久主机 ID 的认证网关。
* 界面组件：可选 iOS 应用下载卡片。
配置与使用¶
安装后，可在设置页面的 Network 面板查看主机状态或创建配对二维码。也可在终端使用设置助手：
dsh plugin --profile web exec dsh-network setup
配置参数¶
默认网关监听端口为 3081。DSH 的底层 Web 服务器保持绑定在回环地址。关键配置项包括：
gatewayPort：认证网关端口（默认3081）。bindHost：网关监听地址（默认0.0.0.0，限制为127.0.0.1仅允许回环）。hostName：主机显示名称。statePath：配对和设备状态存储路径。iosAppDownloadURL：iOS 应用下载卡片展示的 HTTPS URL。
路由设置¶
根据需求选择不同的连接方式：
- LAN 设置：确保设备间网络互通，执行：
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
注意事项¶
- 运行机制：DSH 保持在 loopback 上，插件在其前方提供认证网关。
- 网络依赖：
- LAN HTTP 依赖受信任的本地网络。
- 自定义公共路由必须已提供受信任的 HTTPS 和 HTTP/WebSocket 转发，本插件不配置 DNS、证书、防火墙或反向代理。
- 配对安全：配对票据为一次性且 5 分钟后过期。主机存储凭据哈希值，不存储原始凭证。
- 面板功能：当前设置面板仅显示主机状态、配对设备数量和配对操作。完整设备列表和撤销控制为未来工作。
该插件扩展了 DSH 的网络可达性。查看目录与源代码以获取更多详情。
