1. 为什么需要SSH免密登录每次用VSCode连接远程服务器都要输密码就像每天回家都要找钥匙开门一样麻烦。我刚开始用Remote-SSH插件时一天要连接服务器十几次手指都快把键盘敲出坑了。更糟的是如果密码包含特殊字符输错三次还要被锁定严重影响开发效率。SSH免密登录的原理其实很简单就像给服务器配了把智能锁。本地生成的id_rsa是私钥相当于钥匙服务器上的authorized_keys存着公钥相当于锁芯。当两者匹配时系统会自动放行。这种非对称加密方式比密码更安全还能避免中间人攻击。实测下来配置成功后连接速度提升明显。原本需要5-6秒的认证过程现在1秒内就能完成。对于需要频繁切换不同服务器的开发者比如同时维护测试环境和生产环境这个功能简直是救命稻草。2. 本地环境准备2.1 检查SSH客户端首先确认你的Windows系统已经安装OpenSSH客户端。按下WinR输入cmd打开命令提示符运行ssh -V如果显示类似OpenSSH_for_Windows_8.1的版本信息说明已安装。若提示命令不存在需要通过「设置」→「应用」→「可选功能」→「添加功能」安装OpenSSH客户端。我遇到过企业版Windows默认禁用SSH的情况这时需要管理员权限运行Get-WindowsCapability -Online | ? Name -like OpenSSH* Add-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.02.2 生成SSH密钥对在用户目录下的.ssh文件夹通常是C:\Users\你的用户名.ssh打开PowerShell输入ssh-keygen -t rsa -b 4096 -C your_emailexample.com这里有几个实用参数-t rsa指定密钥类型为RSA-b 4096密钥长度设为4096位更安全-f ~/.ssh/server_key自定义密钥文件名适合多服务器场景生成过程中会提示输入passphrase密钥密码建议直接回车留空否则每次使用仍需要输入密码。完成后你会看到两个文件id_rsa私钥文件相当于家门钥匙id_rsa.pub公钥文件相当于锁芯规格书注意如果之前生成过GitHub用的密钥建议新建专用密钥对避免权限混乱。我就曾因为混用密钥导致Git推送和服务器登录互相影响。3. 服务器端配置3.1 上传公钥到服务器传统教程会让你用scp命令上传文件但实测发现权限问题较多。更稳妥的做法是用文本编辑器打开本地的id_rsa.pub复制全部内容通常是ssh-rsa开头的一行通过现有SSH连接登录服务器执行以下命令mkdir -p ~/.ssh echo 粘贴的公钥内容 ~/.ssh/authorized_keys chmod 700 ~/.ssh chmod 600 ~/.ssh/authorized_keys这里有个血泪教训绝对不要用FTP直接上传文件我有次用FileZilla上传因为文本编码问题导致认证失败排查了两小时。权限设置也很关键曾经因为.ssh目录权限设为777导致SSH直接拒绝连接。3.2 检查SSH服务配置用root权限编辑/etc/ssh/sshd_configsudo nano /etc/ssh/sshd_config确认以下参数PubkeyAuthentication yes AuthorizedKeysFile .ssh/authorized_keys PasswordAuthentication no # 增强安全性可选重启SSH服务使配置生效sudo systemctl restart sshd如果遇到连接问题可以先保留PasswordAuthentication yes等免密登录测试成功后再关闭。我在阿里云服务器上就遇到过SELinux阻止访问authorized_keys的情况需要额外执行restorecon -Rv ~/.ssh4. VSCode配置实战4.1 安装Remote-SSH插件在VSCode扩展商店搜索并安装官方「Remote - SSH」插件。安装后左侧会出现远程资源管理器图标这里有个隐藏技巧按住Ctrl点击图标可以快速打开配置文件。4.2 配置SSH连接信息按F1输入「Remote-SSH: Open SSH Configuration File」选择用户目录下的.ssh/config文件没有会自动创建。配置模板如下Host myserver HostName 192.168.1.100 User ubuntu Port 22 IdentityFile ~/.ssh/id_rsa IdentitiesOnly yes高级配置技巧使用跳板机时添加ProxyCommand配置对慢速网络可添加ServerAliveInterval 30保持连接不同服务器使用不同密钥时用IdentityFile指定路径我习惯用Emoji标识服务器类型比如Host prod-server HostName 10.0.0.1 Host test-server HostName 10.0.0.24.3 连接测试与排错首次连接时可能会提示「Could not establish connection」这通常是known_hosts文件冲突导致。解决方法删除.ssh/known_hosts中对应服务器的记录或在配置中添加StrictHostKeyChecking no UserKnownHostsFile/dev/null常见错误排查权限问题服务器端.ssh目录必须是700authorized_keys必须是600路径问题确保IdentityFile路径与本地密钥位置一致防火墙问题检查服务器端口是否开放netstat -tulnp5. 高阶技巧与自动化5.1 多服务器管理当需要管理多个环境时可以用include指令拆分配置Include configs/*.conf然后在.ssh/configs/目录下为每个服务器创建独立配置文件比如production.confstaging.confdev.conf5.2 自动化部署脚本将整个过程自动化可以节省大量时间。这是我常用的PowerShell脚本# 生成密钥 ssh-keygen -t rsa -b 4096 -f $env:USERPROFILE\.ssh\server_key -N # 上传公钥 $pubkey Get-Content $env:USERPROFILE\.ssh\server_key.pub ssh userserver mkdir -p ~/.ssh echo $pubkey ~/.ssh/authorized_keys chmod 700 ~/.ssh chmod 600 ~/.ssh/authorized_keys # 写入VSCode配置 Add-Content $env:USERPROFILE\.ssh\config Host myserver HostName server_ip User user IdentityFile ~/.ssh/server_key 5.3 安全增强建议虽然免密登录很方便但也要注意安全定期轮换密钥建议每3个月对生产环境使用ED25519算法ssh-keygen -t ed25519在服务器端配置IP白名单使用证书认证替代密钥认证更复杂的方案有次我的密钥意外泄露幸好服务器配置了Fail2Ban自动封禁了异常IP。现在我会在本地用gpg加密私钥使用时再临时解密。6. 常见问题解决方案连接超时问题我在公司网络下经常遇到后来发现是MTU设置问题。解决方法Host * IPQoS throughput TCPKeepAlive yesVS Code Server启动失败这是Remote-SSH的老毛病了按CtrlShiftP执行「Remote-SSH: Kill VS Code Server on Host」后重连即可。中文乱码问题在服务器端执行echo export LANGzh_CN.UTF-8 ~/.bashrc source ~/.bashrcX11转发失败需要在配置中添加ForwardX11 yes ForwardX11Trusted yes经过这些年的实践我发现最稳的组合是WSL2 VSCode 定期更新的ED25519密钥。现在连接服务器就像打开本地文件夹一样自然再也不用担心输错密码被锁定了。