Sky李晓峰1. 先别急着改配置：给问题分个层
1.1 密钥连接失败到底错在哪一步
先说个我自己的实际经历。有一台刚开好的云服务器，我在本地终端里用 ssh root@<服务器IP> 一条命令就能直接登上去，root 的 /root/.ssh/authorized_keys 里也确认过公钥存在。结果回到 VSCode 里，Remote-SSH 连接，界面卡一下之后弹出一个密码输入框。第一次遇到这种情况，人的第一反应往往是"是不是密钥文件权限不对""是不是 VSCode 不支持密钥"，然后开始盲目改权限、换密钥格式，折腾一下午发现没用。
后来我把整个链路在脑子里过了一遍，才意识到问题不在"密钥是否有效"，而在"VSCode 通过哪种方式、在哪个目录、用哪把钥匙去连接服务器"。密钥认证的完整过程其实是这样的：
- 客户端发起 TCP 连接，和 SSH 服务端协商加密算法；
- 服务端返回自己的 host key，完成主机身份校验；
- 客户端开始认证阶段，向服务端提供"可用公钥列表"；
- 服务端拿这些公钥和当前用户的
authorized_keys比对，命中后返回挑战； - 客户端用对应私钥完成签名，服务端验证通过，会话建立。
VSCode 的 Remote-SSH 扩展不是一个独立的 SSH 客户端，它在 Windows 上调用的是系统自带的 OpenSSH（或者你手动指定的 ssh.exe），在 Linux/macOS 上调用系统的 ssh。所以第 3 步里的"可用公钥列表"从哪里来、包含哪些密钥、走的是哪个用户的 HOME 目录，直接影响认证结果。很多时候你以为 VSCode 和终端用的是同一把钥匙，其实它俩读的根本不是同一份配置文件。
1.2 命令行能连、VSCode 连不上，说明了什么
这是一个特别重要的判断信号。如果本地终端里执行：
bash复制ssh -i ~/.ssh/id_ed25519 user@192.168.1.100
能够正常登录，至少能证明以下几件事：
- 服务器端的 SSH 服务是正常的；
- 密钥对本身是有效的（公钥在服务器上、私钥在本地）；
- 服务器没有限制该用户登录，SSH 端口也可达；
- 认证方式里公钥认证是开启的。
那问题范围就缩小到了 VSCode 这一侧：要么它读的 ~/.ssh/config 不是你以为的那个文件，要么它用了错误的 IdentityFile 路径，要么它连接的 Host 定义和你命令行里用的不是同一个。反过来还有一种很常见的情况：命令行用 ssh -v 也会卡住，服务器日志里直接出现 Failed publickey for user，那问题基本就锁定在服务器端或者密钥本身。
所以我的第一个建议永远都是：先做减法，再定位问题。 不要让 VSCode 这个外壳干扰你，先在裸 SSH 层面上验证密钥是否真的可用。
1.3 通过错误信息快速归类
VSCode 连接失败时，有的错误在弹窗里显示，有的藏在输出日志里，还有的只在终端模式下才看得见。根据我踩过的坑，下面这些提示基本能帮你快速归档：
| 错误提示（或日志关键词） | 问题大概率在哪个环节 | 优先检查方向 |
|---|---|---|
Permission denied (publickey,password) |
认证阶段 | 服务器 authorized_keys、密钥路径、服务端日志 |
No supported authentication methods available |
认证方式协商 | sshd_config 中 PubkeyAuthentication / PasswordAuthentication |
Remote host identification has changed |
host key 校验 | known_hosts 中旧的主机指纹 |
Failed to establish a socket connection |
网络层 | 端口、防火墙、服务器的 sshd 是否启动 |
Server installation failed 或 Resolving remote environment 卡住 |
远端执行层 | vscode-server 安装失败、远程用户是否有写权限 |
Connection closed by remote host |
会话层 | sshd 日志、内存、PAM 配置、Too Many Authentication Failures |
其中和"使用秘钥无法连接"最相关的是前两行，尤其是 Permission denied (publickey,password)。这个提示的意思是：服务器允许公钥认证也允许密码认证，但在本次连接尝试里，你的客户端提供的公钥没有被服务器接受，同时又拒绝了密码输入弹窗，所以协商多次后两边都过不去。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 命令行与日志配合的排查链路
2.1 先用 ssh -vvv 验证认证全流程
无论你觉得服务器端多么正常，排查密钥问题最可靠的方法是开 verbose 日志跑一次完整连接。在本地终端里执行：
bash复制ssh -vvv user@192.168.1.100
注意区分 -v 和 -vvv，排查密钥时直接用