SSH 密钥免密登录配置指南
这个问题很常见,不过 VSCode 本身为了安全,不支持直接保存 SSH 密码。
每次重连都要输密码,根本原因是它默认使用密码认证。想一劳永逸地解决,最靠谱的方法就是配置 SSH 密钥(免密登录)。
核心思路是在你的电脑上生成一对密钥(一把“私钥”自己留着,一把“公钥”放到服务器上),之后连接时,系统会自动用这对密钥来验证身份,就不需要再手动输入密码了。
🛠️ 操作步骤(Windows 示例)
整个过程分为在本地电脑和远程服务器上的操作。
1. 在本地电脑生成密钥对
打开 PowerShell(非管理员模式即可),输入以下命令并按提示操作:
ssh-keygen -t ed25519 -C "your_email@example.com"
保存位置
出现提示时,直接按 Enter 键,使用默认路径:
C:\Users\你的用户名\.ssh\id_ed25519
设置密码(Passphrase)
系统会询问是否给私钥加密码。
为了彻底免密,这里直接按两次 Enter 留空即可。
操作完成后,在:
C:\Users\你的用户名\.ssh\
目录下会生成两个文件:
id_ed25519:私钥,绝不能泄露。id_ed25519.pub:公钥,需要上传到服务器。
2. 将公钥添加到远程服务器
方法一:使用 ssh-copy-id 命令(推荐)
这是最简单的方法,在 PowerShell 中执行:
ssh-copy-id 用户名@服务器IP
按提示输入一次服务器密码,公钥会自动添加到服务器的:
~/.ssh/authorized_keys
文件中。
方法二:手动复制
如果 ssh-copy-id 不可用,可以手动复制公钥。
首先,在 PowerShell 中执行:
Get-Content ~\.ssh\id_ed25519.pub | Set-Clipboard
复制公钥内容。
然后正常 SSH 登录服务器:
ssh 用户名@服务器IP
在服务器上执行:
mkdir -p ~/.ssh
echo 你的公钥内容 >> ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys
3. 测试免密登录
在本地 PowerShell 中尝试连接服务器:
ssh 用户名@服务器IP
如果配置成功,应该可以直接登录,不再需要输入服务器密码。
✍️ 配置 VSCode
为了让 VSCode 远程开发更加方便,可以进一步配置 SSH 的 config 文件。
在 Windows 资源管理器地址栏中输入:
%USERPROFILE%\.ssh
然后回车。
找到 config 文件,用记事本或 VSCode 打开。如果没有,则新建一个名为:
config
的文件。
添加以下内容:
Host myserver
HostName 服务器IP
User 你的用户名
IdentityFile ~/.ssh/id_ed25519
保存文件。
之后在 VSCode 的远程资源管理器中,选择 myserver 这个配置进行连接即可。
🔧 如果还是不行?
可以尝试以下几种方法。
1. 排查密钥路径
检查 SSH config 文件中的:
IdentityFile
路径是否完全正确。
例如:
IdentityFile ~/.ssh/id_ed25519
2. 启用 ssh-agent
可以使用管理员身份运行 PowerShell,然后依次执行:
Set-Service ssh-agent -StartupType Automatic
Start-Service ssh-agent
ssh-add $env:USERPROFILE\.ssh\id_ed25519
3. 调整 VSCode 设置
在 VSCode 的 settings.json 中加入:
"remote.SSH.useLocalServer": true
有时可以解决 Windows 上重复输入密码的问题。
4. 保持 SSH 连接活跃
在 SSH config 文件中加入:
ServerAliveInterval 60
例如:
Host myserver
HostName 服务器IP
User 你的用户名
IdentityFile ~/.ssh/id_ed25519
ServerAliveInterval 60
这样可以防止 SSH 连接因长时间闲置而断开。
💎 总结
总的来说,配置 SSH 密钥 是解决 SSH 每次连接都需要输入密码问题的标准方法。
整个过程通常只需要配置一次:
本地电脑生成密钥
↓
获取公钥
↓
将公钥放到服务器 ~/.ssh/authorized_keys
↓
测试 SSH 免密登录
↓
配置 VSCode SSH config
↓
VSCode 直接连接服务器
之后就可以享受更加方便的无缝远程开发体验。