AutoDL服务器SSH免密登录及VS Code配置完整教程

准备工作

在开始之前，请确保您已准备好：

1. 一台本地电脑（Windows, macOS 或 Linux 系统）。
2. 已安装 Visual Studio Code。
3. 在 VS Code 中，从扩展商店安装微软官方插件 **Remote - SSH**。

---

第一部分：生成 SSH 密钥并配置 AutoDL

这一部分的核心是在您的本地电脑上创建一把“钥匙”（私钥），并将对应的“锁”（公钥）放到 AutoDL 服务器上。

步骤 1.1：在本地电脑生成 SSH 密钥对

根据您的操作系统，选择相应的方法：

• 对于 Windows 10 / 11 用户：

  1. 打开 PowerShell 或 **命令提示符 (CMD)**。

  2. 输入以下命令并按回车：

     ssh-keygen -t rsa -b 4096

  3. 程序会询问几个问题，请按以下方式操作：

     • Enter file in which to save the key...: 直接按回车，使用默认路径（通常是 C:\Users\您的用户名\.ssh\id_rsa）。
     • Enter passphrase (empty for no passphrase):: 直接按回车，设置为空密码，这是实现“免密”登录的关键。
     • Enter same passphrase again:: 再次按回车确认。

• 对于 macOS 和 Linux 用户：

  1. 打开**终端 (Terminal)**。

  2. 输入以下命令并按回车：

     ssh-keygen -t rsa -b 4096

  3. 与 Windows 类似，连续三次按回车即可：

     • 提示保存位置时，按回车（默认路径 ~/.ssh/id_rsa）。
     • 提示输入密码时，按回车（留空）。
     • 再次确认密码时，按回车。

完成后，在您的 .ssh 目录下会生成两个核心文件：id_rsa (私钥，绝不能泄露）和 id_rsa.pub (公钥，用于上传到服务器)。

步骤 1.2：复制您的公钥

• Windows:

  1. 打开文件资源管理器，地址栏输入 %USERPROFILE%\.ssh 并回车。
  2. 找到 id_rsa.pub 文件，用记事本或其他文本编辑器打开。
  3. 复制文件内的全部内容。

• macOS / Linux: 打开终端，输入以下命令即可将公钥内容复制到剪贴板：

  pbcopy < ~/.ssh/id_rsa.pub

  (如果 pbcopy 不可用，可使用 cat ~/.ssh/id_rsa.pub 查看内容后手动复制)。

步骤 1.3：在 AutoDL 控制台添加公钥

1. 登录 AutoDL 控制台。
2. 在左侧导航栏中，点击 “账号” -> “SSH 密钥”。
3. 点击 “添加 SSH 密钥” 按钮。
4. 在弹出的窗口中：
   • 密钥名称：起一个好记的名字，例如 my_windows_pc。
   • 公钥内容：将刚刚复制的公钥字符串完整地粘贴进去。
   • 点击 “确定”。

重要提示：如果您在添加密钥时有正在运行的实例，您必须重启该实例才能使新密钥生效。对于新创建的实例，会自动应用已保存的密钥。

---

第二部分：配置 VS Code 实现一键连接

现在，我们来告诉 VS Code 如何使用刚刚设置好的密钥去连接您的 AutoDL 服务器。

步骤 2.1：在 VS Code 中打开 SSH 配置文件

1. 打开 VS Code。
2. 按下快捷键 F1 (或者 Ctrl+Shift+P / Cmd+Shift+P) 打开命令面板。
3. 输入并选择 Remote-SSH: Open SSH Configuration File...。
4. 在弹出的选择框中，选择默认的配置文件路径（例如 C:\Users\YourName\.ssh\config 或 ~/.ssh/config）并打开它。

步骤 2.2：添加您的 AutoDL 服务器信息

将下面的配置模板复制到打开的 config 文件中，并根据您实例的实际情况修改。

配置模板：

Host my-autodl-server
    HostName <服务器地址>
    User root
    Port <端口号>
    IdentityFile <您的私钥路径>

请务必修改以下占位符：

• Host my-autodl-server: 给您的服务器起一个别名，例如 autodl-4090，这个名字将显示在 VS Code 的连接列表里。
• <服务器地址>: 从 AutoDL 控制台【我的实例】页面找到 SSH 访问指令，复制 @ 后面的服务器地址（例如 connect.region-4.autodl.com）。
• <端口号>: 同样从 SSH 访问指令中找到端口号 -p 后面的数字。
• <您的私钥路径>:
  • macOS / Linux 用户: 通常无需修改，就是 ~/.ssh/id_rsa。
  • Windows 用户: 请修改为您的私钥绝对路径，**注意使用正斜杠 /**，例如 C:/Users/Lihua/.ssh/id_rsa。

修改完成的配置示例：

# AutoDL 4090 实例
Host autodl-4090
    HostName connect.region-4.autodl.com
    User root
    Port 54321
    IdentityFile C:/Users/Lihua/.ssh/id_rsa

修改完成后，保存 (Ctrl+S) 该 config 文件。

步骤 2.3：连接服务器

1. 点击 VS Code 左侧边栏的 “远程资源管理器” 图标。
2. 在顶部的下拉菜单中选择 “SSH”。
3. 您会看到刚才在 config 文件中设置的主机别名（例如 autodl-4090）已经出现在列表中。
4. 将鼠标悬停在您的主机名上，点击右侧出现的 “连接到主机” 图标（文件夹带 + 号的图标）。

VS Code 会打开一个新窗口，并自动完成 SSH 连接。第一次连接时，可能会弹窗提示确认服务器的指纹，选择 “Continue” 即可。

至此，您已成功配置完毕！ 现在，每次想连接 AutoDL 服务器时，只需在 VS Code 的远程资源管理器中轻轻一点，即可实现无需密码的安全连接。