本地運行 DeepSeek Harness 時,想在手機上查看或調試,通常需要同步文件或截圖。dsh-remote 解決了這個問題,它通過中繼(SSH 或 Cloudflare)將本地 DSH 暴露到網絡,手機訪問的是同一個運行時,而非副本。
這是什麼¶
由 Guuu16 維護的 DSH 插件,通過 SSH 反向隧道或 Cloudflare 隧道將本機 DSH 接入網絡。手機瀏覽器訪問的是同一份工作區和聊天記錄,使用 dsh 自身的 Web GUI,無額外 UI 層。
核心功能¶
- 雙模式遠程接入:支持 SSH 反向隧道和 Cloudflare 隧道兩種方式。
- 同一份運行時:手機訪問的是同一份工作區和聊天記錄,不是第二份副本。
- 原生 GUI:直接使用 dsh 自身的 Web GUI,無額外封裝層。
- 側邊欄補齊:設置頁提供“側邊欄漏掉的項目”補齊功能,利用
sessionQuery和workspaceRegistryAPI 算出差集。 - 零配置 Cloudflare:無需服務器、無需賬號,自動下載
cloudflared到~/.dsh-remote/bin/。 - 移動端體驗:手機掃碼訪問,支持添加到主屏全屏使用。
- 本地免密:支持 Loopback 本地免密訪問。
安裝與啓用¶
安裝插件需要 Node.js >= 22.15。
dsh plugin --profile desktop add github:Guuu16/dsh-remote
安裝完成後重啓 dsh。
典型用法¶
- 打開 dsh 設置中的“遠程訪問”頁面。
- 選擇接入方式並配置:
- Cloudflare 隧道:選擇該模式並保存,插件會自動建立連接。
- SSH 反向隧道:填寫服務器地址、用戶名和密碼,保存後插件會自動部署公鑰並建立隧道。
- 在手機上掃描設置頁顯示的二維碼即可訪問。
配置細節與注意事項¶
- Cloudflare 模式:流量經過 Cloudflare 邊緣,域名每次重連會變,首次加載 GUI 可能較慢。
- SSH 模式:需要服務器在
sshd_config中開啓GatewayPorts clientspecified,且雲平臺安全組需放行對應端口。 - Loopback 訪問:無需密鑰,本機進程可直接訪問。
- 連接維護:SSH 隧道斷線後會自動重撥。
- 安全性:訪問密鑰是唯一門禁,換密鑰會令所有已配對設備失效。
生態背景¶
DeepSeek Harness 理念是“一切皆插件”,該插件由社區開發者維護,旨在讓本地智能體環境更易觸達。