前言¶
DeepSeek Harness（DSH）默認的 Web 訪問方式需要啓動時打印的 Token 鏈接，且僅監聽本機地址。在本地開發或多設備協作場景下，這種方式不夠便捷。dsh-lan-web-access 插件通過在 DSH 的登錄檢查前增加一層邏輯，爲本機提供了免 Token 通道，並獨立開啓了一個局域網端口，允許在局域網或異地組網環境下，多臺設備通過瀏覽器同時訪問同一臺 DSH 主機。
插件定位¶
這是一個由 Colin900726 維護的聯網工具類插件，開源協議爲 MIT。它不替換或拆除 DSH 的任何部件，不兼容時會自動退回官方認證機制。
核心功能¶
- 本機免 Token：在安裝插件的電腦上，瀏覽器直接打開即可使用，無需 Token。
- SSH 隧道免密：通過 SSH 隧道訪問時，視同本機訪問，免 Token、免密碼。
- 局域網訪問（默認關閉）：獨立監聽端口，通過允許列表和管理密碼進行訪問控制。
- 設備管理：支持添加允許列表、設置管理密碼、查看設備狀態表、踢出設備。
- 登錄頁狀態：提供五種登錄頁狀態（正常、密碼錯誤、鎖定、設備不在列表、未就緒）。
- 訪問記錄：記錄登錄、拒絕、退出等事件，最多保留 200 條。
- 運行檢查與安全退出：啓動時進行五項檢查，不兼容時自動停用並交還官方認證。
- 一鍵更新：支持在插件設置中檢查並更新到最新版本。
- 雙端雙系統：同時支持 Desktop 和 Web 兩種模式，以及 macOS 和 Windows 系統。
安裝與啓用¶
確保電腦上已安裝 DSH。通過命令行安裝：
# Desktop 模式
dsh plugin --profile desktop add dsh-lan-web-access@latest
# Web 模式
dsh plugin --profile web add dsh-lan-web-access@latest
或者在 DSH 界面中：設置 → 插件 → 添加插件，輸入包名 dsh-lan-web-access。
安裝後，進入「插件」頁確認插件開關已打開，並在「設置 → 局域網 web 訪問」中進行配置。
典型用法¶
DSH 默認端口爲主端口（Desktop 19387, Web 3080），局域網默認端口爲主端口 + 1。
- 主機本機訪問
打開http://127.0.0.1:<主端口>，無需 Token。 - 局域網訪問
打開http://<主機IP>:<局域網端口>。若設備不在允許列表，需先在主機設置中添加該設備 IP 到允許列表，並輸入管理密碼。 - SSH 隧道訪問
在訪問端建立 SSH 隧道：
ssh -N -L <主端口>:127.0.0.1:<主端口> <主機用戶名>@<主機IP>
然後訪問 `http://127.0.0.1:<主端口>`，無需密碼。
注意事項與安全¶
- 網絡安全性：局域網模式使用 HTTP，憑據明文傳輸，同網段設備可能抓包。建議僅在可信內網或使用異地組網（如 Tailscale）時使用。
- 配置安全：密碼僅存儲 scrypt 散列，配置文件權限爲 0600，不會出現在日誌或對話中。
- 只讀限制：局域網設備只能查看「連接」和「關於」兩段設置，無法修改配置或密碼。
- 密碼重置：忘記管理密碼需刪除配置文件（
~/.dsh/remote-access.json，Windows 路徑略有不同）並重啓 DSH。 - 衝突提示：同一臺電腦上不要同時運行 Desktop 和 Web，否則設置可能互相覆蓋。
結語¶
該插件解決了 DSH 在本地和多設備場景下的訪問痛點，提供了從本機免登錄到局域網安全管理的完整方案。代碼與文檔詳見 GitHub。
