SSH Tools 2

SSH Tools 2.0 是一个面向 VS Code 的 SSH / FTP / 远程管理插件，提供 SSH 主机管理、远程终端、SFTP/FTP 文件浏览、端口转发、SOCKS 代理、RDP/VNC 启动、工作区管理和配置导入导出等能力。

本仓库是基于 XPLOT SSH Tools 1.0.81 整理出的源码维护版本。原插件由 XPLOT 开发，较长时间未继续更新；本版本在保留原有使用习惯的基础上，补充了可维护的源码工程结构，并对前端、构建流程和已知问题做了修复。

声明：本项目为源码学习、修复和维护版本。全部源码整理、前端重写和 Bug 修复由 codex 工具辅助完成，建议在生产环境使用前自行测试关键功能。

功能特性

SSH 连接管理

• 新增、编辑、删除 SSH 连接。
• 支持密码和私钥认证。
• 支持连接分组、在线/离线视图和手动刷新。
• 支持复制主机信息、连接命令和 SCP 路径。
• 支持单级 SSH 跳板机连接，SSH 文件管理和终端可通过已有 SSH 连接访问内网目标服务器。

远程终端

• 内置 xterm.js 终端。
• 支持在 VS Code 中打开 SSH 终端会话。
• 支持多终端窗口。
• 支持终端字体、颜色、光标等显示配置。

SFTP / FTP 文件管理

• 浏览远程目录。
• 上传、下载文件和文件夹。
• 新建文件、新建文件夹。
• 重命名、删除远程文件或目录。
• 复制文件名、远程路径和 SCP 命令。

端口转发

• 支持本地端口转发。
• 支持远程端口转发。
• 支持 SOCKS 代理。
• 支持基于 ssh2 的转发模式和本地 SSH 命令模式。

远程桌面

• 支持 RDP 配置管理和启动。
• 支持 VNC 配置管理和启动。
• Windows RDP 可使用系统自带远程桌面客户端。
• VNC 需要本机安装对应 VNC 客户端，例如 RealVNC。

工作区管理

• 可将常用远程目录加入工作区视图。
• 支持在线/离线工作区树。
• 适合频繁访问固定远程目录的场景。

配置管理

• 支持 .db .json 配置导入导出，方便跨机器迁移。

与 1.0.81 的区别

对比项	1.0.81	本项目
工程形态	主要是编译后产物	补充源码工程结构
前端	Vue 2 + Element UI	Vue 3 + Element Plus
构建	不便于重新构建	支持 webpack 构建和 VSIX 打包
配置导出	以 .db 为主	.db + JSON
状态反馈	部分操作反馈不足	补充成功/失败提示
已知 Bug	部分取消输入、连接清理、命令注册问题	已修复一批高风险问题
持久 ID 生成	部分 ID 使用弱随机生成	改用 crypto.randomUUID() 或 crypto 随机 fallback
自动化	无 GitHub Actions	支持自动构建 VSIX 和 Release
SSH 跳板机	原版未提供独立跳板机配置	2.1.0 支持单级 SSH 跳板机，文件管理和终端可通过已有 SSH 连接访问目标服务器

安装方式

也可以在 VS Code 中打开 Extensions 面板，选择 Install from VSIX... 手动安装。

从源码构建

环境要求：

• Node.js 20 或更高版本。
• npm。
• VS Code 1.85 或更高版本。

git clone https://github.com/charley008/sshtool2.git
cd sshtool2

npm install
npm run build
npm run package

构建完成后，项目packages根目录会生成：

sshtools2-2.x.x.vsix

连接 Windows 主机

如果要通过 SSH 连接 Windows 主机，需要在 Windows 目标主机上启用 OpenSSH Server：

1. 安装 OpenSSH Server。
2. 启动 sshd 服务。
3. 放行防火墙中的 SSH 端口，默认端口为 22。
4. 使用 Windows 用户名和密码或密钥连接。

参考文档：

• OpenSSH for Windows
• Microsoft OpenSSH 安装文档

远程桌面依赖

• RDP：Windows 通常可直接使用系统自带远程桌面客户端。
• Linux RDP：通常需要安装 xfreerdp。
• VNC：需要安装可用的 VNC 客户端，例如 RealVNC。
• VNC 默认端口通常为 5900，具体以服务端配置为准。

License

MIT License，详见 LICENSE.md。