VSCode Remote-SSH 免密登录：3步配置与 2 个常见权限错误排查

每次连接远程服务器都要输入密码？作为开发者，我们追求的是效率与流畅的体验。本文将带你深入理解VSCode Remote-SSH免密登录的核心机制，并提供一套完整的配置方案，同时解决那些令人头疼的权限问题。

1. 密钥生成与基础配置

免密登录的核心在于SSH密钥对的正确使用。让我们从本地环境开始：

ssh-keygen -t ed25519 -C "your_email@example.com"

执行上述命令后，你会看到类似以下的输出：

Generating public/private ed25519 key pair. Enter file in which to save the key (/home/user/.ssh/id_ed25519): Enter passphrase (empty for no passphrase): Your identification has been saved in /home/user/.ssh/id_ed25519 Your public key has been saved in /home/user/.ssh/id_ed25519.pub

关键点说明：

• ed25519算法比传统RSA更安全高效
• 空密码(passphrase)可实现完全免密，但会降低安全性
• 密钥默认存储在用户目录的.ssh文件夹中

接下来需要将公钥传输到远程服务器。推荐使用ssh-copy-id命令：

ssh-copy-id -i ~/.ssh/id_ed25519.pub user@remote_host

这个命令会自动处理以下事项：

1. 创建远程.ssh目录（如果不存在）
2. 将公钥追加到authorized_keys文件
3. 设置适当的文件权限

2. VSCode配置与连接测试

在VSCode中安装Remote-SSH扩展后，需要配置SSH连接信息。编辑~/.ssh/config文件（Windows在C:\Users\username\.ssh\config）：

Host my-remote-server HostName 192.168.1.100 User devuser IdentityFile ~/.ssh/id_ed25519 PreferredAuthentications publickey

配置参数解析：

提示：如果连接仍然要求输入密码，可在命令面板执行"Remote-SSH: Open Configuration File..."检查配置路径是否正确。

3. 权限问题深度排查

即使完成了上述步骤，你可能还是会遇到以下两个典型错误：

3.1 错误1：Permissions are too open

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @ WARNING: UNPROTECTED PRIVATE KEY FILE! @ @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ Permissions 0644 for '/home/user/.ssh/id_ed25519' are too open.

解决方案：

1. 设置私钥权限为600（仅所有者可读写）

   chmod 600 ~/.ssh/id_ed25519

2. 确保.ssh目录权限为700

   chmod 700 ~/.ssh

3. 检查authorized_keys权限

   chmod 600 ~/.ssh/authorized_keys

3.2 错误2：仍要求输入密码

当所有配置看似正确却仍需密码时，可按以下流程排查：

1. 检查SSH服务端配置

   sudo grep PubkeyAuthentication /etc/ssh/sshd_config

   确保输出包含PubkeyAuthentication yes

2. 验证密钥指纹

   ssh-keygen -lf ~/.ssh/id_ed25519.pub

   对比本地和服务器上的公钥指纹

3. 查看详细调试信息

   ssh -vT user@remote_host

   这会显示详细的连接过程，帮助定位问题

4. 检查SELinux状态（Linux服务器）

   getenforce

   如果是Enforcing模式，可能需要调整策略

   restorecon -Rv ~/.ssh

4. 高级配置与优化

为了提升安全性和使用体验，可以考虑以下进阶配置：

多密钥管理： 当需要连接不同服务器时，可以为每个服务创建独立密钥：

ssh-keygen -t ed25519 -f ~/.ssh/work_ed25519 -C "work_server"

然后在config文件中指定对应密钥：

Host work-server HostName work.example.com User employee IdentityFile ~/.ssh/work_ed25519

安全增强措施：

1. 使用强密码保护私钥（虽然会失去完全免密的便利）
2. 定期轮换密钥（建议每3-6个月）
3. 限制服务器端访问IP

   from="192.168.1.*",command="/bin/true" ssh-ed25519 AAAAC3N...

性能优化： 在config中添加以下参数可加速连接：

Host * Compression yes ControlMaster auto ControlPath ~/.ssh/control-%r@%h:%p ControlPersist 1h

5. 自动化维护脚本

为简化日常维护，可以创建以下实用脚本：

权限修复脚本（保存为fix_ssh_perms.sh）：

#!/bin/bash # 修复本地SSH相关文件权限 chmod 700 ~/.ssh chmod 600 ~/.ssh/* chmod 644 ~/.ssh/*.pub 2>/dev/null

密钥检查脚本（保存为check_ssh_auth.sh）：

#!/bin/bash # 检查服务器端认证配置 echo "=== SSH服务配置 ===" grep -E "PubkeyAuthentication|PasswordAuthentication" /etc/ssh/sshd_config echo -e "\n=== 授权密钥 ===" ls -la ~/.ssh/authorized_keys cat ~/.ssh/authorized_keys echo -e "\n=== 最近认证日志 ===" tail -20 /var/log/auth.log | grep sshd

在实际项目中，我发现最常被忽视的问题是authorized_keys文件末尾的空行或格式问题。一个可靠的检查方法是使用ssh-keygen验证：

ssh-keygen -lf ~/.ssh/authorized_keys

这能确保所有密钥都是有效格式。