SSH 失败时,最后一行的错误通常是一句总结,而不是一个诊断——Permission denied (publickey) 告诉你的是一场协商的结果,而不是它在哪里出了问题。真正的来龙去脉在 ssh -vvv 里,这也是为什么人们最后会把 debug3: receive packet: type 51 这样的原始片段贴进搜索引擎。读懂那段调试输出不需要背下整个协议。你需要知道的,是那几行能回答真实问题的内容,以及哪些行只是噪声。
这是一份阅读指南:每一级 -v 多打印了什么、你会依次看到哪些阶段,以及一份针对那些值得停下来细看的行的解码表。(至于错误本身——连接被拒、超时、主机密钥告警——修复办法在解码手册里。)
-v、-vv 和 -vvv 到底多打印了什么
-v打印debug1行:高层次的叙述。读取了哪些配置文件、正在连往哪里、服务器提供了什么、尝试了哪些密钥、哪种认证方式最终胜出。对大多数问题来说,这就够了。-vv加上debug2:协商的细节——双方完整的算法列表、针对每把密钥的决策过程。-vvv加上debug3:数据包级别的调试输出,包括send packet: type N/receive packet: type N这些行。正是这一级会报出协议消息编号,那些能拿去搜索的“谜之行”也来自这里。
先从 -v 开始。当 -v 的叙述戛然而止、你需要看到它究竟死在哪个数据包上时,再祭出 -vvv。
各个阶段,按你会看到的先后顺序
每一次成功的连接都走同一条路,调试输出也随之展开。知道这些阶段,意味着你能在弄清什么出错之前,先判断出失败发生在哪里。
1. 配置。 最先出现的几行是 Reading configuration data /home/you/.ssh/config 和 .../etc/ssh/ssh_config,随后对每一个匹配上的 Host 块各有一行 Applying options for <pattern>。如果 SSH 用了一个你没料到的端口、用户或密钥,罪魁祸首就在这里被点名了——某个你早忘了的块正在生效。(这个文件里该放什么、匹配又是怎么工作的:~/.ssh/config 指南(英文)。)
2. TCP 连接。 先是 Connecting to host [1.2.3.4] port 22.,然后是 Connection established.。如果你看到的不是这个,而是 connect to address ... Connection refused 或 Connection timed out,那就别往下读了——这一步之后的一切都无关紧要,因为根本没有“之后”。见下文。
3. 版本交换。 Local version string SSH-2.0-OpenSSH_... 和 Remote protocol version 2.0, remote software version ...——两端用明文互相自报家门。它主要的用处是识别出老掉牙的服务器,以及确认你究竟有没有连到一个 sshd。
4. 密钥交换与主机密钥。 SSH2_MSG_KEXINIT sent / received,接着是选定的算法(kex: algorithm: ...、kex: host key algorithm: ...),然后服务器的主机密钥会与你的 known_hosts 做比对:Host 'x' is known and matches the ED25519 host key / Found key in ~/.ssh/known_hosts:12。如果对不上,连接就会在这里带着那条醒目的警告横幅中止。
5. 认证。 Authentications that can continue: publickey,password 是服务器在列出它愿意接受的认证方式。随后客户端会逐一尝试各种方式和密钥,一次一个,直到有一个成功——或者全都失败。这个阶段是你需要读得最多的地方,所以它有自己专属的解码表。
一段带注释的调试输出,从头到尾
下面是一段真实(经过删减)的 -vvv 运行输出,对应的是被搜索得最多的那种失败——Permission denied (publickey)——其中重要的行都做了标注。上面讲的每个阶段都按顺序清晰可见:
$ ssh -vvv deploy@203.0.113.10
OpenSSH_9.6p1, OpenSSL 3.0.13
debug1: Reading configuration data /home/you/.ssh/config
debug1: /home/you/.ssh/config line 12: Applying options for 203.0.113.10 # ← 匹配到了一个 Host 块;如果用户/密钥/端口不对,先怀疑它
debug1: Connecting to 203.0.113.10 [203.0.113.10] port 22.
debug1: Connection established. # ← TCP 已通:连接被拒 / 超时在这里被排除
debug1: Local version string SSH-2.0-OpenSSH_9.6
debug1: Remote protocol version 2.0, remote software version OpenSSH_8.9p1 # ← 你连到了一个真正的 sshd
debug1: SSH2_MSG_KEXINIT sent
debug1: SSH2_MSG_KEXINIT received
debug1: kex: algorithm: curve25519-sha256
debug1: Server host key: ssh-ed25519 SHA256:abc123...
debug1: Host '203.0.113.10' is known and matches the ED25519 host key. # ← 主机密钥阶段通过;不是 known_hosts 的问题
debug1: Authentications that can continue: publickey # ← 只接受密钥;永远不会提供密码认证
debug1: Offering public key: /home/you/.ssh/id_ed25519 ED25519 SHA256:def456... # ← 客户端实际尝试的那把密钥
debug3: receive packet: type 51 # ← SSH_MSG_USERAUTH_FAILURE:服务器拒绝了那把密钥
debug1: Trying private key: /home/you/.ssh/id_rsa # ← agent 里的密钥用尽了;现在回退到密钥文件
debug1: No more authentication methods to try.
deploy@203.0.113.10: Permission denied (publickey).
从下往上读。失败是 Permission denied (publickey);在它上方最后一次真正的尝试,是那次引出了 type 51 的 id_ed25519 提交。所以服务器看到了那把密钥,并拒绝了它——这是服务器侧的问题(登录用户不对、密钥不在 authorized_keys 里,或者 ~/.ssh 权限有误),而不是缺少密钥。假如 id_ed25519 压根没出现在任何一行 Offering public key 里,诊断就会翻转到客户端侧:这把密钥根本没被发出去。
解码表:能回答真实问题的那些行
Will attempt key: / Offering public key: ...——它回答的是“它在尝试哪些密钥,顺序又是怎样?”。在 -v 下你会看到每一个候选项:文件路径或 agent 条目、密钥类型、指纹。如果你想用的那把密钥不在这份列表里,服务器就从没见过它——再怎么在服务器侧折腾也无济于事。用 -i 明确指向它,并检查配置阶段有没有一行 IdentityFile 正在把你覆盖掉。
debug3: receive packet: type 51——这就是 SSH_MSG_USERAUTH_FAILURE:服务器拒绝了那一次认证尝试。它本身并不致命——客户端耸耸肩,转向下一把密钥或下一种方式,所以在一次正常的登录里你也常会看到好几个 type 51。只有当它紧跟在你本以为能成功的那把密钥之后时,它才成为诊断结论:那说明服务器看过那把密钥,然后说了“不”——用户不对、密钥不在 authorized_keys 里,或者服务器侧权限有误。这类排查见 Permission denied 指南。(供你定位:type 50 是发出去的请求,type 52 是成功。)
Server accepts key: 之后却仍然失败——这是有意思的一种。服务器已经确认这把公钥在 authorized_keys 里,并邀请客户端证明自己拥有它;如果在这一行之后认证依然失败,问题就出在你这一侧的“证明”上:agent 没能签名(agent 套接字不对,或者 agent 其实并不持有那把私钥)、密码短语的提示输入失败,或者磁盘上的私钥与提交的那把公钥对不上。看看紧随其后的那一行 sign_and_send_pubkey:——或者它的缺席。
No more authentication methods to try.——终局状态。服务器允许的每一种方式都试尽了,紧接着的下一行就是 Permission denied。别把这一行当成错误本身;从它往上读,去找最后一次真正的尝试,以及它失败的原因。
卡在 expecting SSH2_MSG_KEX_ECDH_REPLY——这根本不是认证问题。服务器的密钥交换应答是整条连接里第一个大数据包,如果它之前的一切都正常、唯独它迟迟不来,那经典的原因就是 MTU 问题或某个作怪的中间盒子——VPN 和某些企业防火墙会把大数据包分片或丢弃。换一个网络、或者不挂 VPN 再试一次;如果能连上,那就去调 MTU,而不是盯着密钥看。
Unspecified GSS failure——Kerberos 的噪声。客户端尝试了 GSSAPI 认证,而你并不在一个 Kerberos 域里,于是它失败了,并回退到下一种方式。如果这条连接最终是在密钥上成败的,那这一行与它毫无关系——除非你真的在用 Kerberos SSO,否则忽略它。
connect to address ... port 22: Connection refused / Connection timed out——连接压根没建立起来,所以一切认证相关的问题都无从谈起。“被拒”意味着主机回应了,但没有任何东西在监听;“超时”意味着这条路径上一片寂静。这是两种不同的排查,都与密钥无关——两分钟诊断把这两条分支都讲到了。
能快速定位问题的工作流
三个习惯,能把满屏的调试文本变成两分钟就能读完的东西:
- 把噪声去掉,再复现一次。
ssh -vvv -o IdentitiesOnly=yes -i ~/.ssh/the_key user@host只提交一把密钥,于是调试输出里只有一次尝试,而不是六次,这时一个 type 51 就只可能指向一件事。 - 从下往上读。 先在末尾找到失败,再往上走到它之前最后一个决策点——最后那一行
Offering public key,或者它始终没能跨过的那道阶段边界。一段调试输出的头三十行几乎总是健康的。 - 查清是谁设了什么。 当行为和你的本意对不上时,顶部那些
Reading configuration data和Applying options for行会点出负责的文件和块。所谓“SSH 无视我的命令行参数”,一半的情况都是某个配置块在悄无声息地胜出。
从源头上减少要读的调试输出
出问题时,调试输出是对的工具——但它揭示的内容里,有一大块本是你不该一次次重新发现的状态:这台主机要用哪把密钥、哪个用户、哪个端口。Termalin 把这些和已保存的主机放在一起,于是正确的密钥是被有意提交的,而不是排在 agent 队列里的第四位;它还会在首次连接时验证每台服务器的身份,指纹一旦有变就发出醒目的警告——也就是把主机密钥这个阶段,妥善地处理掉了。实时的主机状态能在你连接之前就回答“这台机器到底连不连得上”,相当于把调试输出里“被拒 / 超时”那条分支整个提前消解了。Free 版主机数量不限——下载它,把 -vvv 留给真正古怪的那些日子。
Termalin 是一款免费、跨平台的 SSH 客户端,它把每台主机的端口、用户、密钥和保活设置与主机一起保存,并在每次连接时验证服务器身份——下载它,或浏览完整功能列表。