前言¶
DeepSeek Harness (DSH) 的 Web 服務默認通常僅監聽本地地址。要在局域網內的其他設備直接訪問或調試，往往需要修改配置文件或設置 SSH 隧道。dsh-web-lan 插件通過包裝 Web Server 請求處理，提供了一個無需額外配置的解決方案，將局域網流量轉換爲迴環訪問，並增加了密碼登錄門以控制訪問權限。
插件簡介¶
dsh-web-lan 是一個爲 DSH Web 服務提供的局域網訪問層插件，由開發者 yes8080 維護。它解決了純 HTTP 局域網環境下的兼容性問題，提供了密碼認證入口，並支持在設置頁面直接管理訪問密碼。
核心功能¶
crypto.randomUUID補丁：修復明文 HTTP 局域網環境下crypto.randomUUID is not a function導致的 API 層失敗問題。- 密碼登錄門：未認證的請求只能看到登錄頁，認證成功後以迴環身份獲取完整權限（包括 Agent 工具）。
- 客戶端
isLoopback修復：補丁強制將瀏覽器端的isLoopback設爲true，修復了局域網頁面中”設置 → 插件配置”標籤頁顯示空白的問題。 - 密碼管理：支持在 Web 界面的”設置 → 插件 → 插件配置”中的”局域網訪問”卡片修改密碼，修改立即生效並持久化到
~/.dsh/settings.yaml。
安裝與啓用¶
執行以下命令安裝並重啓服務：
dsh plugin --profile web add 'git+https://github.com/yes8080/dsh-web-lan.git'
npm exec @deepseek-ai/dsh web
啓動後，終端會輸出局域網訪問地址（通常爲 http://<ip>:3080）。
典型用法¶
- 訪問與登錄：在局域網內的其他設備訪問
http://<ip>:3080，使用默認密碼123登錄（建議首次登錄後立即修改）。 - 環境變量設置密碼：在啓動前設置環境變量
export DSH_LAN_PASSWORD='strong_password'。 - 設置頁管理：登錄後進入”設置 → 插件 → 插件配置”卡片，在”局域網訪問”區域修改密碼。
安全與注意事項¶
- 默認密碼風險：默認密碼
123弱且公開，安裝後請立即通過設置頁面修改或使用環境變量覆蓋。 - 傳輸方式：密碼及數據通過 HTTP 明文傳輸，僅適用於可信的局域網環境。
- 權限範圍：登錄用戶擁有與本地用戶相同的完整權限。
- 環境依賴：運行需要
pnpm，若未啓用需先執行corepack enable pnpm。
卸載¶
若需移除插件，執行：
dsh plugin --profile web remove dsh-web-lan
npm exec @deepseek-ai/dsh web
卸載後會自動恢復默認的 127.0.0.1 監聽，局域網訪問功能關閉。可選清理殘留數據：
# 編輯 ~/.dsh/settings.yaml，刪除 lan-access 段
rm ~/.dsh/dsh-lan-sessions.json
結語¶
dsh-web-lan 通過插件化的方式簡化了 DSH Web 在局域網內的訪問流程，解決了兼容性缺陷並提供了一層基本的安全門。適合需要在本地網絡內快速部署和調試 DSH 應用的場景。
