前言¶

智能体开发过程中，本地调试和实时状态监控是高频操作。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 仓库