DeepSeek Harness 本質是本地開發工具，默認依賴 127.0.0.1 綁定和請求頭校驗。在 Docker、反向代理或公網部署場景下，這種基於 Host/Origin/Sec-Fetch-Site 的信任校驗機制會失效。dsh-auth-gate 插件旨在解決這些場景下的未授權訪問風險，爲 Harness 提供網絡層面的安全防護。
插件定位¶
dsh-auth-gate 是 DeepSeek Harness 的認證與安全加固插件，由 zephaniahwang94-cmyk 維護。它通過在 HTTP 和 WebSocket 路由上增加認證層，防止未授權的 API 訪問，並對審批流程增加限制。
核心功能¶
該插件提供以下能力：
- Bearer token + session login：爲 HTTP 和 WebSocket 路由提供基於 Token 的認證和會話登錄。
- Prepended per-session waterfall limiter：在審批流程的水印流中增加前置限制，防止審批過載。
- Fail-closed authentication gateway：當認證配置生效時，未通過認證的請求將被直接拒絕（Fail-closed），而不是允許訪問。
安裝與啓用¶
安裝過程會自動構建插件並註冊到指定的 Harness 配置中。憑證通過環境變量傳遞，不會寫入配置文件。
Linux / macOS¶
export DSH_AUTH_USERNAME=admin
export DSH_AUTH_PASSWORD=Read-Host 'Enter a private password (12+ characters)'
./install.sh --protection Full
Windows PowerShell¶
$env:DSH_AUTH_USERNAME = 'admin'
$env:DSH_AUTH_PASSWORD = Read-Host 'Enter a private password (12+ characters)'
.\install.ps1 -Protection Full
安裝完成後，後續啓動 Harness 時需要指定 Patch 文件：
dsh --profile web --patch C:\path\to\dsh-auth-gate\presets\full.yml
重要限制與注意事項¶
在使用前需瞭解以下限制：
- 無用戶隔離：所有通過認證的用戶共享同一個 Agent 實例和會話池，沒有用戶級別的沙箱隔離。
- 無審計日誌：該插件不記錄誰進行了認證或用戶的具體操作行爲。
- 不修復 ACP / SDK 通道：這些通道通過 stdio (stdin/stdout) 運行，不在 HTTP 網絡範圍內，因此不受此插件保護。
- 信任校驗頭而非網絡來源：插件驗證請求頭（如 Host/Origin），並不驗證請求的實際網絡來源。
- 反向代理登錄桶：登錄嘗試基於 TCP peer address 計數。如果部署在反向代理（如 Nginx）之後，用戶將共享代理的登錄桶限制。此時建議在邊緣層（反向代理）配置限流，因爲插件無法信任被代理轉發的頭信息。
生態鏈接¶
- 目錄頁：dsh-auth-gate - SkillHub
- GitHub 倉庫：zephaniahwang94-cmyk/dsh-auth-gate
