Aliyun Devbox - VS Code 插件
阿里云 Devbox VS Code 插件,支持一键连接远程开发环境。
功能介绍
- 一键远程开发:通过 URI 协议快速连接阿里云 Devbox 远程开发环境
- 自动 SSH 配置:自动管理 SSH 密钥和配置文件
- 多 IDE 支持:兼容 VS Code、Cursor、Trae、Windsurf 等主流编辑器
- 安全连接:使用私钥认证,无需密码输入
支持的 IDE
- Visual Studio Code
- Cursor
- Trae
- Windsurf
- Kiro
- Qoder
- Lingma
- CodeBuddy
- Antigravity
快速开始
安装插件
方式 1:从插件市场安装
在 VS Code 扩展商店搜索 "Aliyun Devbox" 并安装。
方式 2:手动安装 VSIX
# 下载插件
wget https://open-vsx.org/api/Aliyun-OOS/aliyun-devbox/1.0.0/file/Aliyun-OOS.aliyun-devbox-1.0.0.vsix
# 在 VS Code 中安装
# 1. 打开 VS Code
# 2. 点击左侧扩展图标
# 3. 点击右上角 "..." → "从 VSIX 安装"
# 4. 选择下载的 .vsix 文件
使用插件
方式 1:通过 URI 连接(推荐)
点击阿里云控制台提供的连接链接,或在浏览器地址栏输入:
cursor://aliyun-oos.aliyun-devbox?sshDomain=username@host&sshPort=22&base64PrivateKey=xxx&workingDir=/workspace&sshHostLabel=my-devbox
方式 2:通过命令连接
- 按
Ctrl+Shift+P 打开命令面板
- 输入 "Connect Remote SSH"
- 输入连接参数
URI 参数说明
| 参数 |
说明 |
示例 |
sshDomain |
SSH 连接地址(用户名@主机) |
devbox@47.103.115.163 |
sshPort |
SSH 端口 |
22 |
base64PrivateKey |
Base64 编码的私钥 |
LS0tLS1CRUdJTi... |
workingDir |
远程工作目录 |
/home/devbox/project |
sshHostLabel |
SSH 配置标识 |
my-devbox |
配置说明
插件会自动创建以下配置文件:
~/.ssh/config - SSH 主配置(自动添加 Include)
~/.ssh/aliyun/applicationmanager/devbox_config - Devbox 专用配置
~/.ssh/aliyun/applicationmanager/{sshHostLabel} - 私钥文件
故障排除
连接失败
- 检查 SSH 端口是否正确
- 确认私钥格式正确(支持 OpenSSH 新格式)
- 查看 VS Code 输出面板中的日志
插件未激活
确保已安装 Remote-SSH 扩展(VS Code 官方扩展)。
开发
# 克隆仓库
git clone https://github.com/aliyun/applicationmanager.git
# 安装依赖
cd devbox-plugin-vscode
npm install
# 编译
npm run compile
# 打包
npm run package
许可证
Apache-2.0
| |