DeepSeek Harness (DSH) 運行在 Node.js 環境中,默認不讀取操作系統的代理設置,也不信任系統證書庫。這導致即使你的瀏覽器通過加速器正常上網,DSH 也會因爲路由和證書信任兩個獨立屏障而無法連接網絡。
dsh-system-net 是一個插件,旨在解決上述問題。它讓 DSH 在運行時讀取操作系統的代理配置併合並其證書存儲,從而無需設置環境變量或導出證書文件。
核心功能¶
該插件主要解決以下問題:
- 路由流量經過操作系統代理:DSH 不再依賴環境變量,而是直接讀取 Windows 系統代理設置。
- 信任操作系統證書存儲:DSH 會合並操作系統的證書庫,解決因自簽名 CA 導致的 TLS 校驗失敗。
- 零配置與免維護:無需導出證書、無需設置環境變量、安裝後無需重啓,每次啓動都會重新檢測。
安裝與啓用¶
該插件通過 GitHub 分發,使用 github: 前綴進行安裝。
dsh plugin --profile web add github:chickmat/dsh-system-net
如果環境中沒有全局 dsh 命令,可以使用:
npx -y @deepseek-ai/dsh plugin --profile web add github:chickmat/dsh-system-net
插件在 DSH 加載時自動應用。後續每次啓動都會重新檢測並應用配置,無需手動干預。
前置要求與適用場景¶
環境要求¶
- DSH 版本:>= 0.2.0-rc.2
- Node.js 版本:>= 22.19 或 >= 24.5(不支持 23.x)
- 平臺:僅支持 Windows
- 加速器模式:加速器必須以“系統代理模式”運行(即寫入 Windows Internet Options 的代理地址)
適用場景¶
- 使用 Watt Toolkit、Steam++、dev-sidecar 等開啓 TLS 中間人代理的加速器。
- 瀏覽器能正常上網,但 DSH 出現連接超時或證書驗證錯誤的情況。
注意事項¶
- 啓動順序:必須先啓動加速器,再啓動 DSH。插件會在啓動時探測系統代理。
- 模式限制:插件不支持 PAC 自動配置解析。如果加速器使用 hosts 重寫或 TUN 虛擬適配器模式,通常無需此插件。
- 單代理衝突:系統代理通常只有一個全局槽位。如果同時運行多個聲稱系統代理的工具,可能會互相沖突。
驗證與狀態¶
安裝並重啓 DSH 後,檢查狀態文件 $DSH_HOME/system-net-status.json(默認 ~/.dsh/system-net-status.json)。
關鍵字段說明:
proxy.source:代理來源。system-proxy表示成功讀取系統代理。cert.systemCount:從操作系統證書庫讀取的證書數量。selfCheck:自檢請求結果。200 表示鏈路通暢。
卸載¶
卸載時使用以下命令:
dsh plugin --profile web remove dsh-system-net
插件無殘留文件,重啓後恢復 Node.js 默認行爲。
總結¶
dsh-system-net 通過在運行時接管路由和證書信任鏈,解決了 Node.js 默認行爲與系統加速器不兼容的問題。它簡化了配置流程,適合需要在 Windows 環境下使用系統級代理工具的開發者。