AutoDL 远程连接 VS Code Remote-SSH 完整指南

前置准备

1. 安装 VS Code 插件

在 VS Code 中安装 Remote - SSH 插件：

1. 打开 VS Code
2. 按 Ctrl+Shift+X 打开扩展商店
3. 搜索 Remote - SSH
4. 点击安装（作者：Microsoft）

2. 获取 AutoDL SSH 连接信息

1. 登录 AutoDL 控制台
2. 找到你的实例，点击进入详情页

3. 在「SSH 登录指令」处获取连接信息，格式如下：

   ssh -p 端口号 root@区域.autodl.pro

   例如：ssh -p 12345 root@region-1.autodl.pro

4. 记录以下信息：

   • 主机地址：如 region-1.autodl.pro
   • 端口号：如 12345
   • 用户名：通常为 root
   • 密码：在实例页面可查看或重置

方法一：直接连接（推荐新手）

步骤 1：打开 Remote-SSH

1. 按 Ctrl+Shift+P 打开命令面板
2. 输入 Remote-SSH: Connect to Host...
3. 选择该选项

步骤 2：输入连接信息

在弹出的输入框中输入：

ssh -p 端口号 root@主机地址

例如：

ssh -p 12345 root@region-1.autodl.pro

步骤 3：选择配置文件

首次连接会提示选择 SSH 配置文件保存位置，选择：

• Windows: C:\Users\你的用户名\.ssh\config
• Linux/Mac: ~/.ssh/config

步骤 4：选择操作系统

选择远程服务器的操作系统类型：Linux

步骤 5：输入密码

在弹出的密码框中输入 AutoDL 实例的密码，等待连接完成。

方法二：配置 SSH Config（推荐长期使用）

步骤 1：打开 SSH 配置文件

1. 按 Ctrl+Shift+P 打开命令面板
2. 输入 Remote-SSH: Open SSH Configuration File...
3. 选择配置文件路径

步骤 2：添加配置

在配置文件中添加以下内容：

Host autodl
    HostName region-1.autodl.pro
    Port 12345
    User root

将 HostName 和 Port 替换为你的实际信息

步骤 3：保存并连接

1. 保存配置文件
2. 按 Ctrl+Shift+P，输入 Remote-SSH: Connect to Host...
3. 选择刚才配置的 autodl
4. 输入密码即可连接

方法三：配置 SSH 密钥免密登录（推荐）

步骤 1：生成 SSH 密钥（如已有可跳过）

在本地终端执行：

ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

一路回车使用默认配置，密钥会生成在：

• Windows: C:\Users\你的用户名\.ssh\id_rsa
• Linux/Mac: ~/.ssh/id_rsa

步骤 2：上传公钥到 AutoDL

方法 A：使用 ssh-copy-id（Linux/Mac）

ssh-copy-id -p 端口号 root@主机地址

方法 B：手动上传（Windows/通用）

1. 查看本地公钥内容：

   # Windows PowerShell
   cat C:\Users\你的用户名\.ssh\id_rsa.pub
   
   # Linux/Mac
   cat ~/.ssh/id_rsa.pub

2. 复制公钥内容

3. SSH 登录到 AutoDL 服务器：

   ssh -p 端口号 root@主机地址

4. 在服务器上执行：

   mkdir -p ~/.ssh
   echo "你复制的公钥内容" >> ~/.ssh/authorized_keys
   chmod 700 ~/.ssh
   chmod 600 ~/.ssh/authorized_keys

步骤 3：更新 SSH Config

Host autodl
    HostName region-1.autodl.pro
    Port 12345
    User root
    IdentityFile ~/.ssh/id_rsa

现在连接时无需输入密码。

常见问题排查

1. 连接超时

• 检查 AutoDL 实例是否已开机
• 检查网络是否正常
• 确认端口号是否正确

2. 密码错误

• 在 AutoDL 控制台重置密码
• 注意密码区分大小写

3. Host key verification failed

删除旧的主机密钥记录：

# Windows
ssh-keygen -R "[主机地址]:端口号"

# 例如
ssh-keygen -R "[region-1.autodl.pro]:12345"

4. VS Code 一直提示输入密码

• 检查密钥配置是否正确
• 确认服务器上 ~/.ssh/authorized_keys 权限为 600
• 确认 ~/.ssh 目录权限为 700

5. 连接后无法打开文件夹

等待 VS Code Server 安装完成，首次连接可能需要几分钟。

实用技巧

1. 端口转发

在 SSH Config 中添加端口转发，方便访问远程服务：

Host autodl
    HostName region-1.autodl.pro
    Port 12345
    User root
    LocalForward 8888 localhost:8888
    LocalForward 6006 localhost:6006

这样可以通过本地 localhost:8888 访问远程的 Jupyter Notebook。

2. 保持连接

防止连接断开，添加心跳配置：

Host autodl
    HostName region-1.autodl.pro
    Port 12345
    User root
    ServerAliveInterval 60
    ServerAliveCountMax 3

3. 多实例管理

为不同实例配置不同名称：

Host autodl-train
    HostName region-1.autodl.pro
    Port 12345
    User root

Host autodl-dev
    HostName region-2.autodl.pro
    Port 54321
    User root

快速检查清单

• [ ] VS Code 已安装 Remote-SSH 插件
• [ ] AutoDL 实例已开机
• [ ] 已获取正确的主机地址、端口、密码
• [ ] SSH Config 配置正确
• [ ] （可选）SSH 密钥已配置

连接成功后，你可以像操作本地文件一样编辑远程服务器上的代码！

AutoDL 目录选择指南

AutoDL 实例有两个主要存储位置：

推荐存放方案

典型项目结构

/root/
├── projects/          # 代码项目（系统盘，保存镜像）
│   └── your-project/
│       ├── src/
│       └── configs/

/root/autodl-tmp/
├── datasets/          # 数据集（数据盘，IO快）
├── models/            # 预训练模型权重
└── outputs/           # 训练输出、checkpoint

简单原则

• 需要保存到镜像的 → 系统盘 /root
• 大文件、频繁读写的 → 数据盘 /root/autodl-tmp

💡 提示：如果使用 vLLM 等推理框架，建议把模型权重放 /root/autodl-tmp，代码放 /root。