dsh-trusted-host-is-loopback:解決反向代理環境下 Host-backed 設置失效的問題

前言

DeepSeek Harness (DSH) 的 Web UI 通常通過 127.0.0.1 訪問。當用戶通過反向代理(而非直接訪問本地地址)訪問經過身份驗證的 Web UI 頁面時,DSH 會將其歸類爲遠程請求,導致部分依賴 Host 的功能無法正常工作。dsh-trusted-host-is-loopback 插件通過修改客戶端的判定邏輯,使這些頁面在反向代理場景下被識別爲本地訪問,從而恢復相關功能的可用性。

插件介紹

這是一個由 Exagone313 維護的 DSH Bundle。它的核心作用是將經過身份驗證的 Web UI 頁面視爲 loopback(本地迴環)。這使得 Host-backed 設置(如設置中的模型配置、首次運行的 API-key 步驟、預覽通知等)能夠在通過反向代理訪問 dsh 時正常工作。

核心功能

  • 將經過身份驗證的 Web UI 頁面標記爲 loopback。
  • 啓用 Host-backed 設置,使其在通過反向代理而非 127.0.0.1 訪問時生效。

安裝與啓用

安裝插件後需要重啓 DSH 進程。

dsh plugin --profile web add @exagone313/dsh-trusted-host-is-loopback

安裝完成後,重啓 dsh 即可生效。

注意事項

  • 無需配置:該插件不需要任何額外的配置文件。
  • Host/Origin 信任邊界:這是安全邊界。只有你通過 --trusted-host 或 trustedHosts 聲明爲受信任的權威機構才能訪問 Web UI。
  • Hook 來源:webserver/index-inject hook 屬於 @deepseek-ai/dsh-host-webserver 插件,如果未來該 hook 名稱變更,需要等待此插件更新。
  • 測試版本:該插件在 dsh 0.2.0-rc.2 版本上經過測試。

總結

該插件僅修改了客戶端對 Host 的分類(ownsHost),並不改變服務端的認證邏輯或 Host/Origin 信任邊界。它爲需要通過反向代理訪問 DSH Web UI 的場景提供了一個簡單的解決方案。源碼地址:https://github.com/Exagone313/dsh-trusted-host-is-loopback

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜