前言¶

智能體開發過程中，本地調試和實時狀態監控是高頻操作。DSH 的 Web UI 提供了直觀的界面，但通常需要在本地機器上打開。在缺乏共享網絡或需要遠程接入時，直接訪問本地界面往往需要配置複雜的端口轉發或 VPN。

dsh-remote-tailscale 插件利用 Tailscale 建立的虛擬網絡，將本地 DSH Web UI 發佈給同一 tailnet 下的其他設備。它不依賴公網，僅使用 Tailscale 的安全通道進行連接。

插件簡介¶

dsh-remote-tailscale 是一個 DSH 插件，由 hxt9805 維護。它將本地 DSH Web UI 完整發布到同一 Tailscale tailnet 下的其他設備上。

該插件的核心價值在於：不需要共享 LAN 或 Wi-Fi，只要兩臺設備登錄了同一個 Tailscale 賬戶，即可通過 HTTPS 端口訪問本地 DSH 界面。

核心功能¶

• 跨設備訪問：通過 Tailscale 跨設備打開本地 DSH Web UI。
• 安全通道：僅使用 HTTPS 端口（默認 8455），不啓用 Funnel 或公開互聯網。
• Loopback 代理：在本地啓動反向代理（默認 127.0.0.1:3091）。
• 賬戶認證：基於 Tailscale 賬戶認證，無額外密碼。
• 可選啓用：提供設置界面開關，默認關閉，提供“自動啓用”選項。
• 狀態監控：提供本地狀態端點，方便其他工具檢測插件狀態。

安裝與啓用¶

在已安裝 DSH 和 Tailscale 的機器上，執行以下命令安裝插件：

dsh plugin --profile web add github:hxt9805/dsh-remote-tailscale

安裝後需要重啓 DSH 進程以加載插件：

dsh web

典型用法¶

1. 環境準備：在當前機器和另一臺目標設備上分別安裝 DSH 和 Tailscale，並使用相同的 Tailscale 賬戶登錄。兩臺設備無需處於同一局域網。
2. 開啓遠程訪問：在本地 DSH Web UI 中進入 設置 -> 遠程訪問，點擊開關啓用功能。
3. 連接：在另一臺設備上，使用頁面顯示的 URL（格式如 https://<machine>.<tailnet>.ts.net:8455/）直接訪問，或掃描頁面提供的 QR 碼。

注意事項¶

• 端口占用：插件默認使用 8455 端口，不會佔用 Tailscale 的默認 HTTPS 端口 443。
• 環境變量覆蓋：
  • Loopback 端口可通過 DSH_TS_PORT 環境變量覆蓋。
  • HTTPS 服務端口可通過 DSH_TS_SERVE_PORT 環境變量覆蓋。
• WSL 環境：在 WSL 下使用時，需要鏡像網絡支持，以便 Windows 的 Tailscale 進程能連接到 WSL 內的 DSH 進程。
• Windows 防火牆：Windows 系統需要確保防火牆允許 Tailscale 的入站連接，否則 tailnet 下的其他設備無法連接。
• 訪問權限：插件僅允許登錄了同一 Tailscale 賬戶的設備訪問。
• 許可證：本項目使用 MIT 許可證。

結語¶

dsh-remote-tailscale 爲 DSH 用戶提供了一個無需額外配置端口轉發即可遠程訪問本地 Web UI 的方案。它通過 Tailscale 的現有連接建立安全通道，適合需要在多臺設備間無縫切換調試環境的開發者。

插件目錄頁 | GitHub 倉庫