返回目錄

dsh-ssh-tunnel

維護狀態: 活躍

omsociety/dsh-ssh-tunnel

DSH 外掛:多機 SSH 工作臺,側欄終端與雙欄 SFTP,模型經 SSHManager 執行命令、傳檔案。

前往 GitHub
$ dsh plugin add dsh-ssh-tunnel

安裝

dsh 沒有統一的安裝指令 —— 把該外掛 README 中的設定行加入你的 profile / patch 設定,然後重啟即可。

查看安裝教學

10

星數

1

Fork

JavaScript

語言

MIT

授權條款

2026-09-28

建立於

2026-11-16

最近推送

README

简体中文 | English

DSH SSH Tunnel
DSH SSH Tunnel

DeepSeek Harness 的多机 SSH 工作台:主机库、按项目授权、右侧栏里的终端与双栏 SFTP。

模型用 SSHManager 工具执行命令、传文件;你在侧栏管主机与授权。密钥不进模型上下文。

Version DSH License Stars Issues

这是什么 • 核心特性 • 效果 • 安装方式 • 侧栏 • 模型工具 • 安全 • 开发 • 许可证与作者

这是什么

DSH SSH Tunnel 是 DeepSeek Harness 的社区插件,挂在 DSH 官方右侧栏的标签页上:把多台 SSH 主机收进一个主机库,按项目授权,然后在中央面板里开交互式终端(xterm)或双栏 SFTP。

它不会把全局 fs / subprocess 换成一个远程盘:远端操作只发生在你显式调用的 SSHManager 工具与面板里,本地文件与远端文件始终是两侧分明的东西。

配套插件是 dsh-git-forge(Git 凭据与 push 策略)。

参考来源

产品形态与部分 UX 参考开源项目 LiveAgent(多机 SSH 主机库、按项目授权、侧栏隧道管理、中央终端 / SFTP 等)。

核心特性

特性 说明
主机库 主机增删改、支持导入 OpenSSH 配置;密码 / 私钥(含口令),密钥只存宿主侧
按项目授权 授权 key 是 DSH 会话工作区(projectPathKey);连接前必须先授权,Connect 不会自动写入授权
SSHManager 工具 远端 exec、SFTP 列举/读写/增删改、上传下载、交互式会话读写;reuse_or_create / new / require_existing 会话策略
中央面板 交互式终端(xterm)与双栏 SFTP:左侧是项目工作区、右侧是远端,可直接上传下载
断线可续 掉线会话留作墓碑,可重连(同一 id)或关闭;意外断开自动重连最多 3 次,ssh2 keepalive 30s × 3
主机密钥指纹 以 SHA256 hex 存入 known_hosts.json,首次连接或指纹变更时在侧栏确认并展示指纹
本地路径守卫 上传 / 下载 / 列举 / 删除的本机路径限制在项目工作区根内,词法 与 realpath 双重校验
界面双语 侧栏与面板随 DSH 界面语言在中文 / 英文间即时切换

效果

中央面板:终端与双栏 SFTP,左侧项目工作区、右侧远端 右侧栏:主机库、按项目授权与隧道会话
中央面板:终端与双栏 SFTP —— 左侧项目工作区、右侧远端,可跨栏拖拽传输 右侧栏:主机库、按项目授权与隧道会话

安装方式

从 npm 安装

# 先停掉正在运行的 DSH(运行中的服务会锁住依赖,装完再起)
dsh plugin --profile <profile> add "dsh-ssh-tunnel@1.2.4"

提示:装好后刷新一下浏览器页面,「SSH 隧道」入口才会出现在右侧栏——只重启宿主不够,客户端产物是页面加载时取的。

装完怎么用

  1. 打开右侧栏「SSH 隧道」→ 主机库 添加一台主机(密码或私钥)
  2. 切到 项目授权,给当前项目勾上这台主机并保存(不授权连不上,这是有意为之)
  3. 回 隧道会话 点 Connect;首次连接会提示确认主机密钥指纹
  4. 点 终端 得到一个交互式 shell,或点 SFTP 打开双栏面板
  5. 让模型用 SSHManager action=exec 跑条命令、用 sftp_list 看目录、sftp_upload / sftp_download 传文件,验证整条链路

侧栏

侧栏只有一个 Tab,内部三页:

页面 作用
项目授权 当前项目允许使用的主机
主机库 主机增删改、OpenSSH 配置扫描导入
隧道会话 连接 / 断开,打开终端或 SFTP;掉线会话留墓碑,可重连或关闭

模型工具

SSHManager 的动作按用途分组:

动作 作用
list_hosts / list_sessions 列出主机库、列出当前会话
create_session / close_session 建立或关闭会话(配合 session_strategy)
exec 远端执行命令(command、cwd、timeout_ms)
sftp_list / sftp_stat / sftp_read_text / sftp_write_text 远端目录、元数据与文本读写
sftp_mkdir / sftp_rename / sftp_delete 远端建目录、重命名、删除
sftp_upload / sftp_download 在项目工作区与远端之间传文件
read_session / send_input / resize_session 交互式会话的读取、输入与窗口尺寸
  • 会话策略:reuse_or_create(默认,会复活同主机已断开的会话)、new、require_existing,或显式传 session_id
  • 超时:默认 exec 30s、SFTP 元数据 30s、SFTP 传输 120s、shell 类操作(read_session / send_input / resize_session)10s;timeout_ms 可覆盖,取值钳制在 1000–300000,整次调用另有 300s 上限
  • max_bytes:exec 与 sftp_read_text 的单次输出上限,按字节钳制在 1024–1048576(默认 exec 262144 即 256 KiB、sftp_read_text 524288 即 512 KiB);达到上限时结果带 truncated: true 且只含前 max_bytes 字节
  • exec 结算:结果带 exitKnown / code / signal / connectionDropped——正常退出 exitKnown: true 且 code 为退出码;按信号终止时返回 signal;连接被切断时 code 为 null 且 connectionDropped: true
  • 交互式输出的读取走 seq 游标协议(侧栏轮询的 shellRead):客户端携带上次读到的 since,响应返回 chunk / since / seq / baseSeq / dropped / chunkTruncated;环形缓冲(512 KiB)淘汰后 baseSeq 前移且 dropped: true,客户端据此全量重取;单次响应的 chunk 上限 256 KiB
  • 认证方式只有密码或私钥;键盘交互式认证(含堡垒机网页 MFA)不支持

安全

信任边界(客观陈述):插件的 API 与 vendor 路由都挂在 DSH 宿主的 web 服务上,并将宿主 connection 服务声明为硬依赖。每个请求首先由 connection.requestRejection(req) 执行宿主的 Host/Origin 围栏与浏览器会话认证;401 / 403 按原状态码立即结束,只有 undefined 才进入插件的 URL / 正文解析、文件读取与业务分派。会话 API 必须带 projectPathKey,跨项目不可见。

授权与路径守卫动作清单:

  • 连接必须先授权:未在「项目授权」里勾选的主机无法建立连接,Connect 不会自动写入授权
  • 授权撤销即时生效:写类操作在发起前与结果回报前各复检一次授权;撤销后输出被丢弃并以 not authorized 失败,下载中的本地文件被删除,受影响的存活会话被关闭,重连拒绝复活已撤销主机
  • 本地路径守卫 fail-closed:上传 / 下载 / 列举 / 建目录 / 删除 / 重命名的本机路径限制在项目工作区根内,词法 与 realpath 双重校验,越界路径与指向工作区外的符号链接一律拒绝;工作区根取不到时直接拒绝操作(可用环境变量 DSH_SSH_TUNNEL_WORKSPACE_ROOT 显式指定)
  • 工具结果与列表 API 不返回 password / PEM / 口令
  • 主机密钥以 SHA256 hex 存入 known_hosts.json;首次连接或指纹变更时在侧栏确认(展示指纹)
  • 优先使用密钥登录;若 secrets.json 可能泄露请立即轮换凭据
  • 认证方式为密码或私钥

数据放在哪

在 GitHub 閱讀完整 README →

DSH Plugins 是獨立的 DeepSeek Harness 外掛目錄,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。