vscode免登录ssh

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 直接连接服务器

之后就可以享受更加方便的无缝远程开发体验。

← Back to Blog