dsh-ssh-remote-tunnel

DeepSeek Harness (DSH) 插件：把远程服务器上的 OpenAI 兼容模型（默认配置为 Qwen vLLM）通过 SSH 端口转发隧道拉回本机，并注册为 DSH 中可选择的 provider / 子代理模型。无需 PuTTY/plink——只要机器上有任意能建立 SSH 连接的客户端（Windows 自带 OpenSSH ssh 即可）就能用。

v0.3.0 变更：

• 更名为 dsh-ssh-remote-tunnel（SSH 转发隧道）。
• 去 plink 依赖：新增 sshClient 选项（auto / ssh / plink），默认 auto 优先使用 OpenSSH ssh。
• 无 plink 也能密码登录：OpenSSH 密码认证通过 SSH_ASKPASS（Windows）/ sshpass（Linux/macOS）自动注入，免交互；不填密码则走密钥认证（BatchMode）。
• 设置页新增「SSH 客户端」下拉、「ssh 路径」字段与「检测 SSH」按钮；状态区显示所用客户端与认证方式。
• 保留 plink 作为可选客户端（sshClient: plink 或 auto 下无 ssh 有 plink 时自动启用）。

它做了什么

时机	行为
DSH 启动	ping 服务器（ICMP + TCP/sshPort 双探测），连通后才继续
连通后	选择 SSH 客户端并建立 localPort → remoteHost:remotePort 本地转发。默认 OpenSSH ssh：有密码走 SSH_ASKPASS/sshpass 自动登录，无密码走密钥（BatchMode=yes）
隧道就绪	轮询 http://localhost:localPort/v1/models，列出模型，做一次 1-token 推理探针
模型注册	把端点写进 llm-pi-ai 设置段（provider 默认 qwen，模型由 models 配置决定），出现在模型选择器中，可用于子代理
隧道断线	健康检查发现本地端口关闭则自动重启（最多 maxTunnelRestarts 次）
DSH 终止	杀掉隧道进程、清理密码临时文件，移除本插件注册的 provider 路由

SSH 客户端选择（无需 plink）

config.sshClient（设置页「SSH 客户端」下拉，默认 auto）：

值	行为
auto（默认）	优先 OpenSSH ssh（不需要 plink）；仅当机器上没有 ssh 但有 plink 时才用 plink
ssh	强制 OpenSSH。密码 → SSH_ASKPASS(Win) / sshpass(Linux/macOS) 自动注入；无密码 → 密钥认证
plink	强制 PuTTY plink.exe（-pw 自动密码，-batch 免交互）

• Windows：系统自带 OpenSSH（C:\Windows\System32\OpenSSH\ssh.exe），留空即可自动找到。密码登录时插件在临时目录生成一个 askpass.bat 由 OpenSSH 的 SSH_ASKPASS 读取，隧道停止/重启时自动删除。
• Linux / macOS：密码登录需要 sshpass（apt install sshpass / brew install hudochenkov/sshpass/sshpass）；没有 sshpass 时密码登录不可用，可改用密钥认证或安装 plink。
• 路径解析：sshPath / plinkPath 留空时分别从 PATH 及系统常见目录自动查找；填目录会追加对应可执行文件名。

DSH Desktop 设置子页面

在 DSH Desktop 的设置侧边栏中新增「SSH 隧道」页面，包含三组：

1. 远端配置 — 可编辑字段：远端 IP / SSH 端口 / SSH 用户 / SSH 密码 / 本地端口 / 远端转发目标 / 远端 vLLM 端口 / SSH 客户端（auto/ssh/plink）/ ssh 路径 / plink.exe 路径 / 主机密钥指纹。
2. 隧道状态 — 实时显示当前阶段、所用 SSH 客户端（+路径）、认证方式（密码/密钥）、API 就绪、provider 注册状态、模型列表、重启次数、PID、最后错误。
3. 操作 — 保存配置 / 启动隧道 / 停止隧道 / 检测 SSH / 检测 plink 五个按钮。

页面通过宿主注册的 HTTP 端点（/plugins/ssh-remote-tunnel/*）通信，每 3 秒自动轮询状态。

安装

从插件市场

上架入口见文末「上架到插件市场」。安装命令（上架后）：

dsh plugin --profile web add dsh-ssh-remote-tunnel

从源码 / 本地链接

本机约定：所有 DSH 插件本体统一放在 D:\Tools\dsh_plugins\<插件名>，其他位置一律通过符号链接（pnpm add link:）引用。

• 插件本体：D:\Tools\dsh_plugins\dsh-ssh-remote-tunnel
• 启用（以 web profile 为例）：
  1. 在 profile 目录下 pnpm add link:D:/Tools/dsh_plugins/dsh-ssh-remote-tunnel
  2. 在 dsh.profile.bundles 数组中加入 "dsh-ssh-remote-tunnel"（web/desktop 需要客户端半部；headless 不需要）
  3. 本包的 cordis.patch.yml（bundle patch）会自动插入 id: ssh-remote-tunnel 行；若某 profile 在别处又写了同 id 的 insert，会因 loader entry id 重复导致 Desktop 无法打开——只保留一处 insert，其余用 id-targeted config 覆盖。

若从旧的 dsh-qwen-tunnel 迁移：旧插件行 id 为 qwen-tunnel，新插件为 ssh-remote-tunnel，二者不会冲突；请移除旧插件并改用新 id。旧的持久化配置文件 .dsh-qwen-tunnel.json 不再读取（新文件为 .dsh-ssh-remote-tunnel.json）。

配置

方式一：通过 DSH Desktop 设置页面（推荐）

1. 打开 DSH Desktop → 左下角「设置」→「SSH 隧道」
2. 填写远端 IP / 端口 / 用户 / 密码 / 客户端
3. 点击「保存配置」→「启动隧道」

方式二：通过 cordis.patch.yml（headless / 持久化）

- insert:
    - id: ssh-remote-tunnel
      name: dsh-ssh-remote-tunnel
      config:
        host: 10.0.0.1              # SSH 服务器（替换为你的 IP）
        sshPort: 22                 # SSH 端口
        sshUser: youruser           # SSH 用户
        password: 'yourpassword'    # 自动登录密码（字符串，注意加引号）
        localPort: 16324            # 本地监听端口
        remoteHost: localhost       # 远端转发目标
        remotePort: 8000            # 远端 vLLM 端口
        sshClient: auto             # auto | ssh | plink（默认 auto，优先 OpenSSH，无需 plink）
        # sshPath: 'C:\\Windows\\System32\\OpenSSH\\ssh.exe'   # 留空则自动查找
        # plinkPath: 'C:\\Program Files\\PuTTY\\plink.exe'     # 仅 plink 客户端需要
        hostKeyFingerprint: 'ssh-ed25519 255 SHA256:xxxx'  # 主机密钥指纹（可选）
        apiBaseUrl: http://localhost:16324/v1
        providerKey: qwen           # 模型选择器里显示的 provider 名（可改为任意，如 ssh-vllm）
        displayName: 'Qwen vLLM (SSH Tunnel)'
        models:                     # 注册进模型选择器的模型
          - id: /model
            name: 'Qwen3.8 vLLM'
          - id: qwen3.8-27b-fp8
            name: 'Qwen3.8 27B FP8 (vLLM)'
        registerProvider: true

• 不想把密码写进配置文件时，删掉 password 字段并设置环境变量 QWEN_SSH_PASSWORD（或配置 passwordEnv: 其他变量名）；不填密码则走密钥认证。
• 密码登录且 sshClient: auto/ssh 时，需要本机存在密码注入手段（Windows 用系统 OpenSSH 的 SSH_ASKPASS，Linux/macOS 需 sshpass）。若都不可用且未装 plink，插件会明确报错提示。

把 Qwen 用作子代理模型

注册成功后（重启 DSH 生效），模型选择器里会出现 provider qwen（或你设置的 providerKey）的模型，新会话/子代理可直接选用。默认模型未被改动。

如需让某个子代理工具固定用它，在 cordis.patch.yml 追加（示例）：

- insert:
    - id: tool-subagent-ssh-vllm
      name: '@deepseek-ai/dsh-tool-subagent'
      config:
        provider: spawn
        toolName: subagent_ssh_vllm
        agentOptions:
          provider: qwen
          model: /model

验证

无需重启即可独立验证隧道链路：

$env:QWEN_TEST_PASSWORD = '<ssh 密码>'
node test/smoke.mjs   # 在插件目录下运行；覆盖 ping、ssh 隧道（SSH_ASKPASS）、API、模型、推理探针、清理
node test/provider-shape.mjs   # 纯离线，校验 provider profile 形状

注意

• 密码以明文存于本机 cordis.patch.yml（与桌面 .bat 相同的信息暴露级别）。设置页/进程内存中的密码不落盘；OpenSSH 密码登录的临时 askpass.bat 仅在隧道运行期间存在于系统临时目录，停止即删除。
• 若 DSH 被强制杀掉（进程级 kill），清理逻辑不会运行；下次启动时插件会自动释放旧 ssh/plink 占用的本地端口，并清理残留的 askpass 临时文件。
• 若你在 Models 页面手动改动了该 provider，插件终止时不会覆盖/删除你的配置。
• 设置子页面仅在 DSH Desktop（web/desktop profile）中可用；headless 模式仅支持 cordis.patch.yml 配置。
• 本插件只做 SSH 本地端口转发与模型端点注册，不代理任意流量；隧道端口仅监听 127.0.0.1。

上架到插件市场

DSH 的「插件市场」（dshmarket）不接收直接上传——它的目录来自精选列表 awesome-dsh-plugin（站点 awesome-dsh-plugin.com，每次打开实时拉取 plugins.json）。上架步骤：

1. 创建公开 GitHub 仓库（如 <你的账号>/dsh-ssh-remote-tunnel），把本插件代码推上去（package.json 的 repository 指向该仓库）。截图与来源追溯都来自该仓库。
2. 发布 npm 包（可选但推荐，安装即走 npm tarball，秒级）：

   npm login
   npm publish --access public
   

   若只走 GitHub 分发，把仓库设为 public 即可，市场会用 github: 源安装。
3. 向 awesome-dsh-plugin 提 PR：在列表里加一条，字段参照 plugins.json 的结构——

   {
     "name": "dsh-ssh-remote-tunnel",
     "owner": "Cumeskey",
     "url": "https://github.com/Cumeskey/dsh-ssh-remote-tunnel",
     "category": "remote",
     "description": {
       "en": "Automatic SSH port-forward tunnel to a remote LLM/vLLM server (OpenAI-compatible). Plink-free: works with any SSH client (OpenSSH ssh with password via SSH_ASKPASS/sshpass, or key auth). Registers the tunneled model as a DSH provider for subagent selection.",
       "zh": "SSH 端口转发隧道，把远程 LLM/vLLM（OpenAI 兼容）拉回本机并注册为 DSH provider。无需 plink：任意 SSH 客户端即可（OpenSSH ssh 密码登录走 SSH_ASKPASS/sshpass，或密钥认证）。"
     },
     "npm": "dsh-ssh-remote-tunnel"
   }
   

   站点与市场会自动收录，通常一天内生效。分类建议 remote（Remote & Mobile）或 model（Models & Providers）。

   注意：市场安全策略只允许安装 awesome-dsh-plugin 精选列表内的来源，所以必须走这条 PR，不能往 dshmarket 仓库直接提条目。

许可

MIT