DeepSeek Harness (DSH) 的 dsh web 默認將 Web 服務器綁定到本地迴環地址,這限制了訪問範圍。當需要在同一臺機器或其他網絡節點上訪問 Web 界面時,就需要修改綁定地址。dsh-remote 插件通過將綁定地址從 127.0.0.1 改爲 0.0.0.0,實現了這一功能。
是什麼¶
dsh-remote 是一個由 anthony1x6000 維護的插件,它通過修改配置層,將 DeepSeek Harness 的 Web 服務器的監聽地址從本地迴環 (127.0.0.1) 切換爲所有網絡接口 (0.0.0.0),從而允許遠程網絡訪問。
核心功能¶
- 啓用
dsh web的遠程網絡訪問。 - 將 Web 服務器綁定到
0.0.0.0。 - 自動發現局域網內的非內部 IPv4 地址。
- 生成包含認證令牌的局域網訪問 URL。
- 提供驗證測試(selfcheck)。
安裝與啓用¶
安裝前需確認當前使用的 profile 包含 webserver 行(例如默認的 web profile)。
- 執行安裝命令:
dsh plugin --profile web add "github:anthony1x6000/dsh-remote#main"
- 驗證配置是否生效(無需重啓):
dsh --profile web --dump-config | grep -B 1 -A 4 webserver
- 重啓
dsh web。打包安裝需要重啓才能生效,倉庫插件無需重啓。
典型用法¶
安裝並重啓後,直接啓動 dsh web 即可:
dsh web
啓動成功後,終端會輸出當前訪問地址及局域網訪問地址,包含認證 Token:
dsh web: http://127.0.0.1:3080?token=... (LAN: http://192.168.x.x:3080?token=...)
若不想修改持久化配置文件,可使用臨時補丁參數啓動:
dsh web --patch <path-to>/cordis.patch.yml
適用場景與注意¶
- Profile 限制:插件必須安裝到
webprofile,且該 profile 必須包含webserver行。在僅包含基礎 bundle 的 profile 上安裝會報錯。 - 環境依賴:安裝過程需要
pnpm。 - 重啓要求:打包安裝需要重啓進程才能加載新的配置層。
- 許可證:MIT License。
總結¶
dsh-remote 通過極小的配置變更,解決了 DSH Web 界面無法被局域網訪問的問題。適合需要在本地開發機或同一局域網內其他設備上調試 DeepSeek Harness 的場景。