AutoDL服务器SSH免密登录及VS Code配置完整教程
准备工作
在开始之前,请确保您已准备好:
- 一台本地电脑(Windows, macOS 或 Linux 系统)。
- 已安装 Visual Studio Code。
- 在 VS Code 中,从扩展商店安装微软官方插件 Remote - SSH。
第一部分:生成 SSH 密钥并配置 AutoDL
这一部分的核心是在您的本地电脑上创建一把“钥匙”(私钥),并将对应的“锁”(公钥)放到 AutoDL 服务器上。
步骤 1.1:在本地电脑生成 SSH 密钥对
Windows 10/11、macOS 和 Linux 自带的 OpenSSH 都可以直接生成密钥。新建密钥时优先使用 Ed25519:
ssh-keygen -t ed25519 -C "autodl"
如果当前环境或服务端明确要求 RSA,再使用:
ssh-keygen -t rsa -b 4096
保存位置可以使用默认值,也可以为 AutoDL 单独命名,例如 ~/.ssh/id_ed25519_autodl。
私钥口令(passphrase)不是 SSH 免密登录的障碍。密钥认证本身就可以避免每次输入服务器密码;给私钥设置口令能降低私钥文件泄露后的风险,需要时再配合 ssh-agent 缓存解锁状态。只有在你明确接受本机私钥无口令风险时才留空。
完成后会得到私钥和对应 .pub 公钥文件。私钥只保存在本机,不能上传或分享;上传到 AutoDL 的是 .pub 公钥内容。
步骤 1.2:复制您的公钥
- Windows:打开
%USERPROFILE%\.ssh,找到刚生成的.pub文件并复制全部内容;PowerShell 也可以直接运行:
如果使用了自定义文件名,把路径换成实际公钥文件。Get-Content "$HOME\.ssh\id_ed25519.pub" - macOS:可以使用:
pbcopy < ~/.ssh/id_ed25519.pub - Linux:通常直接查看后复制:
cat ~/.ssh/id_ed25519.pub
如果你生成的是 RSA 密钥,则对应文件名通常为 id_rsa.pub。
步骤 1.3:在 AutoDL 控制台添加公钥
- 登录 AutoDL 控制台。
- 按当前控制台入口进入 “容器实例” -> “设置密钥登录”,打开 SSH 公钥配置页面。
- 添加一条新的 SSH 公钥。
- 在弹出的窗口中:
- 密钥名称:起一个好记的名字,例如
my_windows_pc。 - 公钥内容:将刚刚复制的公钥字符串完整地粘贴进去。
- 点击 “确定”。
- 密钥名称:起一个好记的名字,例如
重要提示:如果您在添加密钥时有正在运行的实例,您必须重启该实例才能使新密钥生效。对于新创建的实例,会自动应用已保存的密钥。
第二部分:配置 VS Code 实现一键连接
现在,我们来告诉 VS Code 如何使用刚刚设置好的密钥去连接您的 AutoDL 服务器。
步骤 2.1:在 VS Code 中打开 SSH 配置文件
- 打开 VS Code。
- 按下快捷键
F1(或者Ctrl+Shift+P/Cmd+Shift+P) 打开命令面板。 - 输入并选择
Remote-SSH: Open SSH Configuration File...。 - 在弹出的选择框中,选择默认的配置文件路径(例如
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后面的数字。<您的私钥路径>:填写步骤 1.1 实际生成的私钥文件,例如:- macOS / Linux:
~/.ssh/id_ed25519或自定义的~/.ssh/id_ed25519_autodl; - Windows:例如
C:/Users/Lihua/.ssh/id_ed25519。OpenSSH 配置中使用正斜杠通常最省事。
- macOS / Linux:
如果你实际生成的是 RSA 密钥,就改成对应的 id_rsa 路径,不要照抄与本机不一致的文件名。
修改完成的配置示例:
# AutoDL 4090 实例
Host autodl-4090
HostName connect.region-4.autodl.com
User root
Port 54321
IdentityFile C:/Users/Lihua/.ssh/id_ed25519
修改完成后,保存 (Ctrl+S) 该 config 文件。
步骤 2.3:连接服务器
- 点击 VS Code 左侧边栏的 “远程资源管理器” 图标。
- 在顶部的下拉菜单中选择 “SSH”。
- 您会看到刚才在
config文件中设置的主机别名(例如autodl-4090)已经出现在列表中。 - 将鼠标悬停在您的主机名上,点击右侧出现的 “连接到主机” 图标(文件夹带
+号的图标)。
VS Code 会打开一个新窗口并建立 SSH 连接。第一次连接时可能会提示服务器主机密钥指纹;如果 AutoDL 控制台或其他可信来源提供了指纹,先核对后再确认。不要在主机名、端口或指纹异常时直接点 “Continue”。
配置完成后,以后可以直接从 VS Code Remote - SSH 选择这个主机。使用了私钥口令时,首次连接可能仍会要求解锁私钥;这和输入服务器账户密码是两回事。
评论将在接近此处时加载,也可点击立即加载。