DeepSeek Harness Relay：爲 Web 配置文件提供安全遠程訪問的插件

DeepSeek Harness (DSH) 默認將 Web 服務器綁定在迴環地址上，並拒絕監聽 0.0.0.0，以避免網絡暴露。這限制了從手機或外部網絡訪問 Harness Web UI 的能力。deepseek-harness-relay 插件作爲第二層監聽器運行，在未觸發的 Harness 前端終止 TLS 並處理認證。

插件簡介¶

名稱：sorsama/deepseek-harness-relay
所有者：sorsama
類別：admin-security
許可證：MIT

該插件爲 DSH Web 配置文件提供認證遠程訪問。它位於 Harness 之外，允許通過 TLS 連接訪問 Harness，並處理設備配對、密碼登錄和設備撤銷，而無需修改 Harness 的核心配置或開放原始端口。

核心功能¶

TLS 終止：在轉發流量到 Harness 前端終止 TLS。
設備配對：支持 QR 碼和密碼兩種配對方式，生成可撤銷的 Bearer Token。
密碼登錄：使用 scrypt 哈希和按地址鎖定機制進行密碼登錄。
設備管理：提供設備列表，支持按設備撤銷和“註銷所有設備”功能。
網絡發現：通過 _dsh._tcp mDNS 廣告廣播，方便客戶端發現 Relay 服務。
透明代理：透明代理 Web UI，無需修改 Harness 前端代碼。

安裝與啓用¶

檢查現有配置：如果 Harness 當前已通過 0.0.0.0 綁定（例如通過 DSH Mobile LAN 補丁），請先編輯 ~/.dsh/profiles/web/cordis.patch.yml 移除該行。Relay 插件在 Harness 已綁定 0.0.0.0 時拒絕啓動。
安裝插件：

    dsh plugin --profile web add dsh-relay

啓動 Harness：

    dsh web

設置密碼：在運行 Harness 的機器上打開 https://127.0.0.1:3443/relay/password 並設置密碼。此頁面在密碼設置前僅限迴環訪問。

典型用法¶

設備配對¶

在 Harness 機器上打開 https://127.0.0.1:3443/relay/pair。
使用手機掃描二維碼，或在手機上打開相同 URL 並輸入顯示的代碼。
命名設備後，設備即會出現在 /relay/devices 列表中。

使用 DSH Mobile¶

DSH Mobile 0.8.0 實現了完整的客戶端集成協議。在 DSH Mobile 的界面中選擇 Relay → Pair a relay 即可完成配對。

注意事項¶

非官方項目：該插件基於 DeepSeek Harness 構建，並非 DeepSeek 官方項目。
啓動限制：如果 Harness 服務器已綁定 0.0.0.0，Relay 插件將拒絕啓動。
本地訪問：來自 Harness 機器迴環地址的請求被視爲操作員，無需登錄。
Token 機制：Bearer Token 爲單次使用且有效時間短。
認證機制：源地址驗證非真正的認證方式，主要用於舊版客戶端兼容。
客戶端版本：DSH Mobile 低於 0.8.0 的版本無法直接訪問自簽名監聽器，且無法在請求中攜帶憑證。

總結¶

deepseek-harness-relay 通過在 Harness 之外增加一層 TLS 和認證中間件，解決了在保持 Harness 安全策略（拒絕 0.0.0.0）的前提下，從移動端或網絡遠程訪問 Harness Web UI 的需求。它遵循 DSH 插件生態的慣例，提供直觀的設備管理和撤銷機制。

GitHub 倉庫：https://github.com/sorsama/deepseek-harness-relay
插件目錄：https://www.skillhub.cn/plugins/sorsama/deepseek-harness-relay