SSH 密钥对配置 5 步法VSCode 免密连接 Ubuntu 虚拟机解决 3 类常见认证失败在开发过程中频繁输入密码连接远程环境不仅效率低下还存在安全隐患。本文将手把手带你完成 VSCode 通过 SSH 密钥对实现免密登录 Ubuntu 虚拟机的完整流程并针对常见的认证失败问题提供解决方案。1. 环境准备与密钥生成首先确保你的 Ubuntu 虚拟机已安装 OpenSSH 服务端。在终端执行以下命令检查 SSH 服务状态sudo systemctl status ssh如果服务未运行使用以下命令启动sudo systemctl start ssh sudo systemctl enable ssh接下来在本地机器生成 SSH 密钥对。Windows 用户可以使用 Git Bash 或 PowerShellMac/Linux 用户直接使用终端ssh-keygen -t ed25519 -C your_emailexample.com提示ed25519 算法比传统的 RSA 更安全高效。生成过程中可以设置密钥密码passphrase增加安全性但为了方便演示我们暂时留空。生成的密钥默认保存在公钥~/.ssh/id_ed25519.pub私钥~/.ssh/id_ed255192. 密钥部署与权限配置将公钥上传到 Ubuntu 虚拟机有多种方式这里介绍最高效的ssh-copy-id方法ssh-copy-id -i ~/.ssh/id_ed25519.pub usernameyour_vm_ip如果系统提示命令不存在可以手动操作将公钥内容复制到剪贴板SSH 登录虚拟机执行以下命令mkdir -p ~/.ssh echo 粘贴你的公钥内容 ~/.ssh/authorized_keys chmod 700 ~/.ssh chmod 600 ~/.ssh/authorized_keys权限设置至关重要错误的权限会导致认证失败。检查确认.ssh目录权限为 700authorized_keys文件权限为 600所有文件和目录的属主是当前用户3. VSCode 远程连接配置安装 Remote-SSH 插件后按CtrlShiftP打开命令面板选择 Remote-SSH: Open SSH Configuration File添加以下配置Host MyUbuntuVM HostName your_vm_ip User your_username IdentityFile ~/.ssh/id_ed25519 IdentitiesOnly yes关键参数说明参数说明示例值Host自定义连接名称MyUbuntuVMHostName虚拟机IP地址192.168.1.100UserUbuntu 用户名developerIdentityFile私钥文件路径~/.ssh/id_ed25519IdentitiesOnly强制使用密钥认证yes保存后在 Remote Explorer 中选择该配置连接。首次连接会提示确认主机密钥指纹输入yes继续。4. 常见认证问题排查4.1 Permission denied (publickey)这是最常见的错误可能原因及解决方案密钥路径错误检查IdentityFile路径是否正确确认私钥文件存在且有读取权限权限问题在虚拟机执行chmod 700 ~/.ssh chmod 600 ~/.ssh/authorized_keys确认/etc/ssh/sshd_config中以下配置正确PubkeyAuthentication yes AuthorizedKeysFile .ssh/authorized_keysSELinux 限制仅限 CentOS/RHELrestorecon -Rv ~/.ssh4.2 Host key verification failed当主机密钥变更时会出现此错误。解决方法删除本地 known_hosts 中的旧记录ssh-keygen -R your_vm_ip或手动编辑~/.ssh/known_hosts删除对应行4.3 连接超时或无响应网络问题排查步骤确认虚拟机IP未变更检查防火墙设置sudo ufw allow ssh验证网络连接模式桥接/NAT检查 SSH 服务监听端口netstat -tuln | grep 225. 高级配置与优化5.1 多密钥管理当需要管理多个密钥对时~/.ssh/config文件可以这样配置Host WorkVM HostName 192.168.1.101 User workuser IdentityFile ~/.ssh/work_key Host PersonalVM HostName 192.168.1.102 User personal IdentityFile ~/.ssh/personal_key5.2 保持连接活跃防止 SSH 连接超时断开在客户端配置中添加Host * ServerAliveInterval 60 ServerAliveCountMax 55.3 VSCode 远程开发技巧端口转发在 VSCode 端口转发面板中添加需要转发的端口远程扩展部分扩展需要在远程环境重新安装终端集成直接使用虚拟机终端支持所有 Linux 命令6. 安全最佳实践虽然免密登录方便但需注意以下安全事项定期轮换密钥每3-6个月更换一次密钥对使用强密码保护密钥生成密钥时设置强密码短语限制访问IP在/etc/hosts.allow中限制可连接IP禁用密码登录配置/etc/ssh/sshd_configPasswordAuthentication no ChallengeResponseAuthentication no7. 自动化部署脚本以下脚本可自动完成服务端配置#!/bin/bash # deploy_ssh.sh USERNAMEyour_user SSH_DIR/home/$USERNAME/.ssh AUTH_KEYS$SSH_DIR/authorized_keys # 创建.ssh目录 mkdir -p $SSH_DIR # 设置权限 chown -R $USERNAME:$USERNAME $SSH_DIR chmod 700 $SSH_DIR # 添加公钥 echo ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIJl3... $AUTH_KEYS chmod 600 $AUTH_KEYS # 配置SSH服务 sudo sed -i s/#PasswordAuthentication yes/PasswordAuthentication no/ /etc/ssh/sshd_config sudo sed -i s/#PubkeyAuthentication yes/PubkeyAuthentication yes/ /etc/ssh/sshd_config sudo systemctl restart sshd在实际项目中我遇到过因权限问题导致的连接失败后来发现是脚本执行时使用了 sudo导致文件属主变为 root。因此特别提醒配置用户目录时务必注意执行身份。