在使用 DeepSeek Harness (DSH) 進行開發或調試時,通過反向代理訪問 Web GUI 常會遇到一些限制。例如,設置面板無法打開、WebSocket 連接中斷,或者移動端訪問時因缺少認證憑證而報錯。爲了解決這些問題,社區開發者 xchannel1987 提供了 dsh-reverse-proxy-xc 插件。
下面介紹該插件的功能、安裝與使用方法。
是什麼¶
這是一個爲 DSH 0.1.7 及以上版本設計的局域網反向代理插件。它運行一個獨立服務,監聽 0.0.0.0:3090 端口,將來自局域網設備的請求轉發到 DSH 主服務,並自動處理必要的 Header 改寫和認證注入,使手機或平板等設備能獲得與本地 127.0.0.1:3080 完全一致的體驗。
核心功能¶
- 完整功能訪問:側邊欄、會話列表、設置面板、憑據管理均正常可用;WebSocket 支持實時事件推送。
- 兼容性修復:自動注入環境標誌以通過前端環境檢測;自動注入
randomUUIDpolyfill;自動處理移動端訪問時的認證憑證。 - 請求處理:獨立服務監聽 0.0.0.0:3090;請求轉發到 DSH 主服務;Header 改寫爲迴環地址;HTML 注入必要的腳本。
- 安全與控制:局域網限定;配置可控,支持端口、認證等參數調整。
安裝與啓用¶
安裝插件需要使用 DSH CLI。安裝完成後,請重啓 DSH 服務。
dsh plugin --profile web add dsh-reverse-proxy-xc
安裝成功後,在 DSH 設置頁面的「局域網反向代理」分區中打開「啓用代理」開關即可啓動服務。
典型用法¶
- 確保目標設備(如手機或平板)與 DSH 主機在同一局域網內,或已通過 VPN 連接。
- 在目標設備的瀏覽器中訪問代理地址:
http://<主機內網IP>:3090
- 示例:
http://10.100.50.125:3090
適用場景與注意¶
- 環境要求:DSH 版本需 >= 0.1.7。僅適用於內網或 VPN 環境。
- 網絡安全:不要將服務暴露到公網。涉及敏感操作,請確保網絡安全。