SSH Remote Explorer
一个 VS Code 插件，让你可以通过 SSH 浏览和编辑远程服务器上的文件。
功能特性
- 🔌 SSH 连接管理 - 添加、编辑、删除 SSH 连接配置
- 📁 远程文件浏览 - 在侧边栏树状视图中浏览远程文件系统
- 📝 文件编辑 - 直接在 VS Code 编辑器中打开和编辑远程文件
- 💾 自动保存 - 编辑后自动保存回远程服务器
- 📤 文件上传 - 从本地上传文件到远程服务器
- 📥 文件下载 - 从远程服务器下载文件到本地
- 📂 文件操作 - 创建、删除、重命名文件和文件夹
- 🔐 多种认证方式 - 支持密码认证和私钥认证
- 📊 状态栏显示 - 实时显示连接状态
安装
从源码安装
克隆仓库：
```bash
git clone https://github.com/your-username/ssh-explorer.git
cd ssh-explorer
```
安装依赖：
```bash
npm install
```
编译：
```bash
npm run compile
```
按 F5 启动调试运行扩展
从 VSIX 安装
打包扩展：
```bash
npx vsce package
```
在 VS Code 中，选择 "Extensions: Install from VSIX..." 并选择生成的 .vsix 文件
使用方法
添加连接
- 点击侧边栏的 SSH Explorer 图标
- 在 "Connections" 面板点击 "+" 按钮
- 输入连接信息：
- 连接名称
- 主机地址
- 端口号（默认 22）
- 用户名
- 选择认证方式（密码/私钥）
连接到服务器
- 在连接列表中，点击连接项右侧的插头图标
- 等待连接建立
- 连接成功后，"Remote Files" 面板将显示远程文件列表
浏览和编辑文件
- 点击文件夹展开查看内容
- 点击文件在编辑器中打开
- 编辑并保存文件（Ctrl+S / Cmd+S），更改会自动同步到服务器
文件操作
右键点击文件或文件夹可以：
- 新建文件
- 新建文件夹
- 删除
- 重命名
- 复制路径
- 上传/下载
配置选项
在 VS Code 设置中可以配置：
| 配置项 |
描述 |
默认值 |
sshExplorer.defaultPort |
默认 SSH 端口 |
22 |
快捷键
安全说明
- 密码存储在 VS Code 的全局状态中（加密存储）
- 建议使用私钥认证提高安全性
- 私钥文件路径支持
~ 表示用户主目录
已知问题
- 暂不支持 SSH 跳板机（Jump Host）
- 大文件编辑可能较慢
开发
前置要求
- Node.js 16+
- VS Code 1.85+
开发命令
```bash
安装依赖
npm install
编译
npm run compile
监听模式编译
npm run watch
检查代码
npm run lint
```
项目结构
```
ssh-explorer/
├── src/
│ ├── extension.ts # 扩展入口
│ ├── types/
│ │ └── index.ts # 类型定义
│ ├── services/
│ │ ├── connectionManager.ts # SSH 连接管理
│ │ └── statusBarManager.ts # 状态栏管理
│ └── providers/
│ ├── connectionProvider.ts # 连接列表 TreeView
│ ├── fileExplorerProvider.ts # 文件浏览 TreeView
│ └── fileSystemProvider.ts # 虚拟文件系统
├── resources/
│ └── ssh-icon.svg # 侧边栏图标
├── package.json
└── tsconfig.json
```
贡献
欢迎提交 Issue 和 Pull Request！
许可证
MIT License
更新日志
0.0.1
- 初始版本
- 基本 SSH 连接功能
- 文件浏览和编辑
- 上传/下载功能
| |
