DeepSeek Harness 插件：dsh-https-fix

前言¶

DeepSeek Harness (DSH) 的 Web GUI 默認配置不支持從公網訪問。dsh-https-fix 插件通過內置的 HTTPS 反向代理和運行時熱補丁，解決了外網訪問和安全配置的問題。

插件簡介¶

dsh-https-fix 是一個聯網工具類插件，由 MingYU-kalo 維護，遵循 MIT 許可證。它的核心作用是讓 DSH 的 Web GUI 能夠通過 HTTPS 從外網訪問，同時提供證書管理、域名註冊和訪問控制功能。

核心功能¶

該插件主要提供以下能力：

• HTTPS 反向代理：插件自行監聽 TLS，將流量轉發至本地 HTTP 端口。
• 受信域名註冊：在運行時將域名或 IP 註冊進受信列表，無需修改 DSH 啓動參數。
• 客戶端熱補丁：修改 @deepseek-ai/dsh-client-connection/lib/client.js，放行經域名/IP 訪問的設置頁。
• TLS 證書管理：支持自動自簽證書、自有證書（含 IP 證書）以及無域名使用 IP 的場景。
• Web 賬密登錄：提供獨立的 Web 認證（默認 admin/admin），會話 7 天。
• 訪問與安全：可關閉外部 HTTP 訪問、配置端口、開啓自動 Token 模式。
• 診斷工具：提供“校驗 HTTPS 可用性”功能，包含 12 項檢查。

安裝與啓用¶

安裝前請務必確認插件版本與 DSH 版本嚴格一致。安裝命令如下：

dsh plugin --profile web add github:MingYU-kalo/dsh-https-fix#dsh-<版本>

若從本地路徑安裝，必須帶 file: 前綴：

dsh plugin --profile web add file:/path/to/dsh-https-fix

安裝完成後，重啓 DSH Web 服務，瀏覽器訪問 https://<域名或IP>:<端口>，默認使用 admin / admin 登錄。

典型用法¶

1. 登錄後進入 設置 → 插件配置 → Https Fix。
2. 在配置頁填寫域名或 IP，並選擇證書類型：
   - 兩個路徑留空：使用自動自簽證書。
   - 填寫路徑：使用自有證書。
3. 點擊 「一鍵打熱補丁」。
4. 點擊 「校驗 HTTPS 可用性」，確保 12 項檢查全部顯示爲綠色。

注意事項¶

高危插件：該插件通過運行時熱補丁修改了 DSH 的源碼文件 @deepseek-ai/dsh-client-connection/lib/client.js，具有以下風險：

1. 版本嚴格綁定：插件版本必須與 DSH 版本完全一致。裝錯版本會導致 DSH 直接無法啓動。
2. 升級衝突：DSH 升級後，舊版插件會覆蓋熱補丁導致 DSH 起不來。升級 DSH 前，必須先卸載或禁用插件。
3. 安全風險：插件將 DSH 暴露到公網，默認賬密爲 admin / admin。請務必在登錄頁修改密碼，並配置防火牆白名單。
4. 本地安裝限制：本地路徑安裝必須使用 file: 前綴，否則會被識別爲鏈接依賴導致啓動失敗。

總結¶

dsh-https-fix 通過熱補丁技術實現了 DSH 的外網 HTTPS 訪問能力，適合需要通過公網訪問 DSH Web 界面的場景。但因其直接修改核心源碼，對版本兼容性和升級流程有較高要求，使用時需格外謹慎。

• 插件目錄頁：dsh-https-fix
• 源碼地址：github.com/MingYU-kalo/dsh-https-fix