Liu-Bot24/dsh-tunnel-client

DSH Tunnel

简体中文 | English

Stars Forks Views 14d Clones 14d Version macOS Windows License

用于启动本机 DeepSeek Harness（DSH），并通过系统 OpenSSH 安全连接远程 DSH 的桌面工具。

DSH Tunnel

界面预览

主题选择
深海鲸歌

航海图纸
夜视终端

包豪斯信号
柔雾器物

DSH Tunnel 可以启动本机 DSH，也可以为远程 DSH 建立本地 SSH 隧道，并在默认浏览器中打开对应的 WebUI。

功能

- 启动、停止并打开本机 DSH
- 保存和管理多个远程 DSH 主机
- 通过 SSH 本地端口转发安全访问远程 WebUI
- 同时连接多个 DSH，并为每个连接分配独立的本地端口
- 在连接可用后自动打开默认浏览器
- 通过 macOS 菜单栏或 Windows 系统托盘快速操作
- 提供深海鲸歌、航海图纸、夜视终端、包豪斯信号和柔雾器物五套主题
- 使用系统 SSH 配置、密钥和 SSH Agent；首次连接可在界面核对指纹并生成应用专用密钥

支持平台

- macOS Apple Silicon
- Windows x64

安装

macOS

1. 下载 DSH.Tunnel--macos-arm64.dmg。
2. 打开 DMG，将 DSH Tunnel.app 拖入 Applications。
3. 从“应用程序”打开 DSH Tunnel。

当前 macOS 安装包采用 ad-hoc 签名，尚未经过 Apple 公证。首次启动时，macOS 可能要求在“系统设置”→“隐私与安全性”中确认打开。

安装包旁提供同名的 .sha256 文件，可用于校验下载完整性：

shasum -a 256 -c DSH.Tunnel--macos-arm64.dmg.sha256

Windows

1. 下载 DSH-Tunnel-Setup--x64.exe，运行安装程序并按向导完成安装。
2. 也可以下载 DSH-Tunnel-Portable--x64.exe，无需安装即可运行。
3. 从开始菜单、桌面快捷方式或便携版文件打开 DSH Tunnel。

当前 Windows 安装包尚未使用受信任的代码签名证书，系统可能显示“未知发布者”提示。

远程产物预览插件

DSH Artifact Preview 是 DSH Tunnel 的配套插件，不是独立应用。DSH Tunnel 负责建立 SSH 隧道并标记远程 WebUI，插件安装在实际运行 DSH 的设备上，负责安全读取会话生成的 HTML、HTM、SVG、PNG、JPG、JPEG、WebP、GIF 和 AVIF 产物。点击远程会话底部的“产物”文件名，或收尾回复中由 DSH 识别出的同一产物文件名，都会在当前操作设备的浏览器中打开预览。
插件不会改变本机 DSH 页面，也不会接管普通网址、任意文本或未被 DSH 识别为产物的文件提及；未支持的文件继续使用 DSH 原有行为。新版 DSH 已提供对应格式的原生文档预览时，文件点击优先进入原生右侧栏，读取与渲染遵循 DSH 的规则。旧版或缺少对应原生能力时使用兼容预览：文本限制为 5 MiB，图片限制为 20 MiB；插件会校验图片文件头，并且只允许读取会话工作目录内的普通文件。兼容预览内容不能访问外部网络、提交表单、打开弹窗、跳转顶层页面或触发下载。

安装位置

插件必须安装在运行目标 DSH 的设备上，而不是只安装在当前操作设备上。例如：

- 在 Mac 上通过 DSH Tunnel 连接 Windows DSH：插件安装到 Windows。
- 在 Windows 上通过 DSH Tunnel 连接 Mac DSH：插件安装到 Mac。
- 只使用本机 DSH：无需为产物预览安装该插件，本机页面保持 DSH 原有行为。

安装

客户端在“设置 → 远程产物预览插件”中显示本机安装状态。本机 DSH 停止后，可以点击“安装插件”或“更新插件”；客户端只会修改当前设备的 DSH web profile，不会静默改写远程设备。

需要安装到另一台设备时，优先在那台设备上打开 DSH Tunnel 并点击“安装插件”。也可以手动安装：

1. 从与 DSH Tunnel 版本对应的 GitHub Release 下载 dsh-plugin-artifact-preview-0.1.9.tgz。
2. 在运行目标 DSH 的设备上执行：

dsh plugin --profile web add ./dsh-plugin-artifact-preview-0.1.9.tgz

3. 重启该设备上的 DSH。

卸载插件：

dsh plugin --profile web remove dsh-plugin-artifact-preview

插件源码随主项目维护在 plugins/artifact-preview 目录中。

使用要求

- 系统中存在可用的 OpenSSH 客户端
- 如需使用默认启动命令，系统需安装 Node.js 并提供 npx；使用自定义命令时，该命令必须在当前设备上可运行
- 远程主机已启用 SSH，并允许使用现有密钥登录，或在首次配对时使用该账户的登录密码
- 远程 DSH 可从该主机自身的 127.0.0.1: 访问

首次连接时，DSH Tunnel 会显示目标设备的 SSH 主机指纹。请通过可信方式核对该指纹；确认后可以输入目标设备账户的登录密码，客户端将生成应用专用密钥并安装其公钥。DSH Tunnel 不会关闭或绕过主机密钥校验。

启动本机 DSH

“本机 DSH”固定显示在主机列表第一项。

1. 选择“本机 DSH”。
2. 点击“启动并打开”。
3. DSH Tunnel 启动 DSH，并在服务就绪后打开 WebUI。

默认端口为 3080。可以通过“编辑”修改显示名称和启动端口；新的端口会在下次启动时生效。客户端只会停止由自身启动的 DSH，不会终止由其他程序启动的实例。

“设置 → 本机 DSH 启动命令”默认填写 npx --yes @deepseek-ai/dsh。客户端会自动追加 web、本机端口，并在当前 DSH 版本支持时追加 --no-open。用户可以改成 dsh、指定版本的 NPX 命令或绝对可执行文件路径；修改前需要停止本机 DSH。启动命令只保存在当前设备，请勿在其中填写密码或 token。

连接远程 DSH

点击“添加主机”，填写：

- 显示名称：仅用于主机列表显示
- SSH 地址：IP 地址、域名或 SSH config 中的 Host 别名
- SSH 用户：可留空，留空时使用 SSH config
- SSH 端口：可留空，留空时使用 SSH config 或默认端口 22
- DSH 端口：远程主机上的 DSH 监听端口，默认为 3080
- 本地端口：本机浏览器访问该 DSH 时使用的端口

保存后点击“连接并打开”。如果现有 SSH 密钥已经可用，客户端会直接连接；否则会显示首次配对窗口，要求核对主机指纹并输入一次目标设备账户的登录密码。配对完成后，后续连接将使用应用专用密钥，不再询问密码。

DSH 0.1.2-rc.1 及以上版本使用带令牌的启动链接。主机运行或隧道连接后，可以点击“复制访问链接”，粘贴到当前电脑的其他浏览器中打开；远程链接使用本机转发端口，隧道断开后不可用。链接包含登录凭据，请勿公开分享。DSH 重启后应重新复制。

客户端的“打开”和“复制访问链接”会验证当前链接；旧令牌失效时重新读取启动信息。若 DSH 由其他终端启动且没有可用交接记录，客户端会提示从该终端获取当前启动链接，不会自动重启服务。通过 SSH 访问时，需要将终端链接中的地址和端口改为当前电脑的 127.0.0.1 和本地转发端口，保留 token 参数。

例如，本地端口为 13080 时，浏览器会打开：

http://127.0.0.1:13080/

不同主机必须使用不同的本地端口。只要端口不冲突，本机 DSH 和多个远程 DSH 可以同时运行。

菜单栏与系统托盘

macOS 关闭主窗口后，DSH Tunnel 会继续在菜单栏运行。可以从菜单栏恢复窗口、打开 WebUI、连接或断开远程主机，以及退出应用。

Windows 最小化后可继续使用系统托盘快捷菜单；关闭主窗口会退出应用。退出时，客户端会停止由自身启动的 DSH 和 SSH 隧道。如果进程未能安全停止，客户端会保留状态并提示重试。

配置与隐私

DSH Tunnel 保存显示名称、SSH 地址、SSH 用户和端口等连接设置。首次配对时生成的专用 SSH 密钥保存在系统应用数据目录的 ssh/ 子目录中；只有公钥会安装到目标设备。

DSH Tunnel 不保存：

- SSH 密码
- SSH Agent 凭据
- DSH 账户凭据

配置文件保存在系统应用数据目录：

- macOS：~/Library/Application Support/DSH Tunnel/
- Windows：%APPDATA%\DSH Tunnel\

主机配置损坏时，客户端会先备份原文件，再恢复默认配置；如果无法安全备份或写入，则以只读模式运行，不覆盖原文件。

从源码运行

需要 Node.js 22 或更新版本。

npm install
npm start
运行测试和语法检查：

npm test
npm run check

构建安装包

请在对应操作系统上构建：

npm run package:mac
npm run package:win

macOS 构建产物：

dist/mac/DSH.Tunnel--macos-arm64.dmg
dist/mac/DSH.Tunnel--macos-arm64.dmg.sha256

Windows x64 构建产物：

dist/DSH-Tunnel-Setup--x64.exe
dist/DSH-Tunnel-Portable--x64.exe

正式公开分发前，应分别完成 Apple Developer ID 签名与公证，以及 Windows 代码签名。

许可证

DSH Tunnel 使用 MIT License。

友情链接

- LINUX DO — 新的理想型社区