thirsty5034/dsh-ssh-tunnel

DSH 社区插件:多主机 SSH 隧道 + SSHManager(更好的侧边栏)

Project Overview项目介绍

dsh-ssh-tunnel is a DSH-native plugin that adds multi-host SSH tunnel management and an SSHManager model tool to DeepSeek Harness, integrating with the dsh-better-sidebar extension version 0.12 or higher. It supports macOS, Linux, and Windows, with dedicated install scripts for each platform. Users can also install it manually via the DSH CLI directly from the GitHub source, since it is not yet published to npm. After installation, you need to restart DSH web and hard-refresh your browser to load the plugin correctly. It requires Node.js 18 or newer and network access to your target SSH hosts to work properly.

This plugin is built for developers who want to manage remote SSH hosts via DeepSeek Harness’s AI model. Before using, you add and edit host inventory in the dedicated sidebar tab, and can even import a list of hosts scanned via OpenSSH. Next, you grant the current project access to specific hosts, because connections are not auto-authorized by default. Once connected, you can open an interactive xterm-based terminal to run commands, or launch a dual-pane SFTP interface for file management. Unexpected disconnections will automatically retry reconnecting up to three times, and you can also manually reconnect any dropped sessions.

The plugin currently only supports two authentication methods: password and private key. Keyboard-interactive authentication and bastion-host MFA are not supported at this time. All sensitive credentials are stored locally in the $DSH_HOME/ssh-tunnel directory, with strict file permissions set to 0600 for secrets and 0700 for the directory, so secrets are never exposed to the AI model. Host key fingerprints are stored as SHA256 hashes, and the plugin will prompt you to verify new or changed host keys in the sidebar before connecting. The plugin is released under the open source MIT license, and requires a DSH web profile and dsh-better-sidebar to work.

dsh-ssh-tunnel 是专为 DeepSeek Harness 开发的原生插件,依托 dsh-better-sidebar(≥0.12 版本)扩展,为 DSH 提供多主机 SSH 隧道管理和 SSHManager 模型工具能力。插件支持主机清单管理、密钥存储(密钥不会暴露给大模型),还提供项目范围授权,可在侧边栏添加专门的标签页用于连接管理和权限配置。中心面板提供交互式终端和双面板 SFTP 文件管理界面。

该插件面向需要在 DSH 中通过大模型管理远程 SSH 主机的开发者,用户使用时需要先在侧边栏完成主机信息的增删改查,还可导入 OpenSSH 扫描的主机列表,之后为当前工作区项目授予指定主机的访问权限,授权完成后才可发起连接。连接后可以选择打开交互式终端执行命令,或是打开 SFTP 面板进行文件管理,意外断开的连接会自动重连最多 3 次,也支持手动重新连接已断开的会话。

该插件要求 Node.js 18 以上版本,使用前需要先安装好 DSH web 配置文件和 dsh-better-sidebar 扩展,可通过官方提供的 shell/PowerShell 脚本一键安装,也可通过 DSH CLI 手动从 GitHub 源安装。仅支持密码和私钥两种认证方式,暂不支持键盘交互或堡垒机 MFA 认证,遵循 MIT 许可协议免费开源使用,所有密钥存储在本地 DSH 目录,权限设置严格。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add "dsh-ssh-tunnel@github:thirsty5034/dsh-ssh-tunnel"

把 thirsty5034/dsh-ssh-tunnel 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-ssh-tunnel

English | 简体中文

DeepSeek Harness community plugin: multi-host SSH tunnel + SSHManager for dsh-better-sidebar.

  • Host inventory + secrets (never exposed to the model)
  • Project-scoped authorization (projectPathKey = workspace cwd)
  • Model tool SSHManager (exec, SFTP, session strategies)
  • Sidebar tab for connect / grants
  • Center overlay: interactive terminal (xterm) and dual-pane SFTP

Does not replace global fs / subprocess with a single remote disk.

Companion: dsh-git-forge (Git credentials + push policy).

Credits / prior art

Product shape and several UX patterns are informed by open-source LiveAgent (multi-host SSH inventory, project-scoped access, sidebar tunnel management, center terminal / SFTP surfaces).

This package is a DSH-native implementation (Cordis host/client plugin, dsh-better-sidebar tab, SSHManager tool, DSH-local secret layout). It is not a git fork of LiveAgent and does not vendor LiveAgent sources. Consult LiveAgent under its own license when comparing designs.

Requirements

  • DSH web profile with dsh-better-sidebar (≥ 0.12)
  • Node.js 18+
  • Network access to your SSH targets

Install

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/thirsty5034/dsh-ssh-tunnel/main/scripts/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/thirsty5034/dsh-ssh-tunnel/main/scripts/install.ps1 | iex

Or CLI (GitHub source until npm publish):

export DSH_HOME=${DSH_HOME:-$HOME/.dsh}
dsh plugin --profile web add "dsh-ssh-tunnel@github:thirsty5034/dsh-ssh-tunnel"
dsh --profile web --dump-config | grep ssh-tunnel

Restart DSH web after host-side changes, then hard-refresh the browser.

Options / local link / npm (later)
bash scripts/install.sh --restart
bash scripts/install.sh --from npm 0.3.6
dsh plugin --profile web add "dsh-ssh-tunnel@link:/path/to/dsh-ssh-tunnel"

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-accounts 下一个 Next muretai-dsh-skill →