DSH Network 插件：在局域網、Tailnet 或 HTTPS 端點訪問 DeepSeek Harness

前言¶

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。

路由設置¶

根據需求選擇不同的連接方式：

1. LAN 設置：確保設備間網絡互通，執行：

    dsh plugin --profile web exec dsh-network setup lan

2. Tailnet 設置：需要主機已安裝並登錄 Tailscale，執行：

    dsh plugin --profile web exec dsh-network setup tailscale

3. 自定義 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 的網絡可達性。查看目錄與源代碼以獲取更多詳情。