前言¶
DeepSeek Harness (DSH) 提供了基於 Web 的操作界面。本地訪問通常僅限於 localhost。dsh-plugin-remote-access 插件解決了這個問題，允許將 DSH 的 Web GUI 暴露給選定的 CIDR 範圍（默認爲 Tailscale 的 100.64.0.0/10），以便通過手機或遠程機器訪問。
插件概述¶
- 名稱：
dsh-plugin-remote-access - 作者：Mzy123l
- 許可證：MIT
- 核心價值：在 DSH 0.2.1+ 上將本機的 DSH Web GUI 暴露給選定的 CIDR 範圍（例如 Tailscale），支持可選的數字訪問代碼、僅適用於遠程頁面的手機佈局、手機端資源緩存、手機端 Enter 鍵換行以及僅適用於遠程頁面的外觀/字體偏好設置。配置僅存在於每個 Windows 用戶的
$DSH_HOME/remote-access-config中（插件不讀也不寫共享 profile）；當端口忙時會自動回退到空閒端口並記住。
核心功能¶
- 網段暴露：將 DSH GUI 暴露給選定的 CIDR 範圍（默認 Tailscale 100.64.0.0/10）。
- 安全監聽：僅監聽允許的地址；對其他地址返回 403。
- 無硬編碼：網段、監聽地址、端口、上游和文件路徑均爲可配置項，無硬編碼。
- 訪問方式：提供兩種訪問方法：複製令牌 URL 或設置數字密碼（輸入一次後 30 天免密）。
- 遠程 UI 佈局：支持移動端/桌面端/自動遠程 UI 佈局選項。
- 遠程專用設置：UI 設置僅適用於遠程頁面；外觀和字體大小僅影響遠程頁面。
- DSH 0.2.1 適配：自動讀取源、系統端口和 HTTPS；適配 DSH 0.2.1+。
- 熱重載：支持設置頁面的熱重載，無需重啓 DSH。
- 配置管理：配置來源爲
$DSH_HOME/remote-access-config.json（v1.5.0 起，僅限單用戶文件）。 - 端口自動回退：當端口忙時會自動回退到空閒端口並記住。
安裝與啓用¶
- 確保你的 DSH 版本符合要求。
- 執行安裝命令。
安裝命令：
dsh plugin --profile desktop add dsh-plugin-remote-access
版本要求：
* DSH 0.2.1+（1.4.0+ 版本）。
* DSH 0.2.0 需要插件版本 1.3.8。
配置與訪問¶
插件配置存儲在 $DSH_HOME/remote-access-config 中。更改參數通過設置頁面完成，保存後無需重啓 DSH 即可熱重載。
訪問方式：
* 令牌 URL：複製並粘貼到瀏覽器。
* 數字密碼：設置後，輸入一次即可在 30 天內免密訪問。
適用場景與注意¶
- 配置位置：配置僅存在於每個 Windows 用戶的
$DSH_HOME/remote-access-config中。插件不讀也不寫共享 profile。 - 端口衝突：當端口忙時會自動回退到空閒端口並記住。
- 版本兼容性：確保 DSH 版本匹配（0.2.1+）。
