出现 Too many authentication failures:先看这次递出了几把钥匙
Frank Zhang
- 8 分钟阅读 - 3782 字TL;DR
服务器是在这一次连接上把认证次数用完才挂断的。先数递出去的钥匙,再用 IdentitiesOnly yes 绑住你要用的那一把。
先对屏幕上的英文。Mac 的 Terminal 会打出这两句,git、scp、sftp,以及这个 Mac 上的图形客户端,打出来的也是这两句。Linux 上的 OpenSSH 客户端同样会打。原因不是 macOS 专有的。检索词「认证失败次数过多」对不上这一句,排的时候以粘贴出来的英文为准。
Too many authentication failures
Received disconnect from <host> port 22:2: Too many authentication failures
<host> 是这次应答的那一头。第二句里的端口是这次实际走的端口。有的程序只露出第一句。
这是这一次连接的次数上限。OpenSSH 服务器把这次连接上的认证尝试数满了,就挂断。sshd_config(5) 把上限叫 MaxAuthTries,默认 6。这一句不能证明钥匙坏了,也不能单凭它说账号被锁、被封,或者该去 reset。下一次连接重新计数。少递几把,下一次可以成功。
次数在你想用的那把钥匙被看见之前就用完,常见来源是 ssh-agent,或密码管理器的 agent,先递了一长串。ssh_config(5) 写的客户端做法是 IdentitiesOnly yes,加上你要用的那一个 IdentityFile,或命令行上的 -i。
站上 2026-11-13 的 publickey 那篇 已经点过这句断开,也写了 IdentitiesOnly yes。这篇给已经看见 Too many authentication failures 的人,常常是对的那把还没递出去。那把已经出现在 Offering public key 里,结尾却是 Permission denied (publickey),就去那篇。GitHub 对后一句的说明在 Error: Permission denied (publickey)。troubleshooting index 没有为这句断开单开一页,写这篇时核对过目录。
站上没有一次会话的屏幕是这句断开,也没有为它记下 agent 列表、Offering public key 日志,或某台服务器的 MaxAuthTries。下面的命令没有为这篇在 Mac 或 VPS 上重跑。旗标来自手册。引用的调试原文来自写作时读到的 OpenSSH auth.c、auth2.c、auth2-pubkey.c、packet.c、ssh2.h 和 sshconnect2.c,链接是当时的 master。Mac 自带自己的那一份。你机器上的 man 不一致时,以你的手册为准。
三十秒
| 屏幕上的原文 | 在这篇里怎么读 | 第一条只读命令 |
|---|---|---|
Too many authentication failures,或 Received disconnect … Too many authentication failures | 这一次连接把认证次数用完了。前面常常已经递过别的钥匙。 | ssh-add -l |
你要的那把在 Offering public key 里,结尾是 Permission denied (publickey) | 服务器看见了这把,并且拒绝了。这篇到此为止。 | publickey 那篇 |
Connection refused、REMOTE HOST IDENTIFICATION HAS CHANGED,或 Bad configuration option: UseKeychain | 停在别的层。 | 表下面三篇 |
TCP 还没到认证,看 Connection refused 那篇。主机密钥对不上,看 host key 那篇,命令可以用 known_hosts 修复命令生成器。UseKeychain 和 apple-use-keychain 看 UseKeychain 那篇。隧道地址和端口一直在变,是 一次ssh排错经历。那几篇都不是这句断开。
先读,先不改文件
这一节不写 ~/.ssh/config,不从 agent 里删钥匙,也不跟 sshd 说话。ssh 和 git 前面不要加 sudo。publickey 那篇写过这个分叉:sudo 读的是 root 的 ~/.ssh。
失败的命令如果不是 GitHub,把 git@github.com 换成 user@host。GitHub 的 SSH 用户名是 git。展开出来不是 git,去 publickey 那篇。
agent 里现在的指纹
ssh-add -l
ssh-add(1) 写明 -l 列出 agent 里当前身份的指纹。退出码 2 是联系不上 agent。列表很长,才值得怀疑是这篇的情况。这个列表不是服务器肯接受的把数。
-d 和 -D 先别动。手册写明 -d 移除列出的身份,-D 清空 agent 里的身份。两个都不删磁盘上的钥匙文件。Keychain、另一个 agent,或下一次 ssh-add,都可能再装回来。清空不是第一步。
不连接,先看会递什么
ssh(1) 的 -G 算完 Host 和 Match 就打印配置并退出,不开连接。
ssh -G git@github.com | grep -iE '^(user|hostname|identityfile|identitiesonly) '
读 identitiesonly 和每一行 identityfile。ssh_config(5) 里 IdentitiesOnly 默认是 no。多个 IdentityFile 会追加进名单,和大多数关键字不一样。grep 没输出,就读完整的 ssh -G。关键字不区分大小写。IdentitiesOnly 仍是 no 时,agent 里的身份也会被用上。
数 verbose 里的递出
ssh -vT git@github.com
-v 打印连接、认证和配置的调试。-T 不分配伪终端。GitHub 没有 shell,所以他们的测试带 -T。对面有 shell 时,一个 -v 也够看见递钥匙的行。
写作时读到的 sshconnect2.c 里,客户端已经有公钥、准备发送探测时,打 Offering public key:。断开之前数这些行。你要的那把没出现,或排在好几把后面,就留在这篇。那把已经递出,结尾仍是 Permission denied (publickey),文件缺失、指纹和账号页面都去 publickey 那篇。
2 是原因码,6 不是量出来的
packet.c 里客户端的格式是 Received disconnect from %s port %d:%u: %.400s。%u 是断开原因码。sshpkt_disconnect 对这一类断开发 SSH2_DISCONNECT_PROTOCOL_ERROR,ssh2.h 把它定义成 2。auth.c 的 auth_maxtries_exceeded 用字符串 Too many authentication failures 断开,走的是同一个发送方。port 22:2: 里,22 是端口,2 是原因码,不是把数,也不是失败次数。该不该留在这篇,看后面的 Too many authentication failures。别的断开文本也会带这个原因码。
MaxAuthTries 管的是每一次连接里的失败次数,默认 6。次数到一半之后,后面的失败才记日志。auth2.c 的 userauth_finish 在认证方法失败时加一,同一次连接里密码错了也算,到顶就调用 auth_maxtries_exceeded。
公钥查询被拒绝时,先走另一笔预算。PubkeyAuthOptions 的 max-pk-ok 默认 6,这些查询过了这个数才计入 MaxAuthTries。查询发生在签名之前,只问服务器肯不肯收这把钥匙。auth2-pubkey.c 里,pk_ok_failures 还没超过 max_pubkey_ok 时,被拒绝的查询标成已经计过;超过之后才算一次失败。Offering public key 有几行,看你自己的日志。这篇不给每台服务器定一个把数。1Password 的 advanced 页 在 “SSH server six-key limit” 下写了同一句,并说第七把会被拒绝。那是他们对默认值的说法。这篇没有重测,也没有读 github.com 或 gitlab.com 的 sshd_config。
服务器日志里的原句是 maximum authentication attempts exceeded for,后面跟用户名;账号不存在时前面还有 invalid user。地址不是你连的那些,是别人在失败。有人贴的行以 [preauth] 结尾。写作时读过的 auth.c、packet.c、log.c 里没有这个括号,这里不解释它。那一片失败,和你这头把钥匙递早了,不是同一件事。PubkeyAuthentication 和 StrictHostKeyChecking 保持原样。
先试一条,不写配置
ssh -o IdentitiesOnly=yes -i ~/.ssh/id_ed25519 -vT git@github.com
文件名和目标换成你的。-o 传入配置关键字。它改变这次递哪些钥匙,不写 ~/.ssh/config。
GitHub 在另一页 Error: Key already in use 用他们的文件名写了同一组选项:ssh -v -o "IdentitiesOnly=yes" -i ~/.ssh/id_rsa git@github.com。那一页说钥匙已经挂在别的账号上。这篇只用这些旗标。
只有 -i 不够。没设 IdentitiesOnly 时,agent 里的身份仍会使用。这条命令成功,普通 ssh 或 git 仍断开,就是递出的把数。它在递出你点名的文件之后仍以 Permission denied (publickey) 结束,就是服务器拒绝了这把。指纹、贴 .pub、生成新钥匙,都留在 publickey 那篇。
没有你想用的 IdentityFile 或 -i 时,IdentitiesOnly yes 只用已配置的身份或默认文件。写作时读到的 OpenBSD 手册列出 ~/.ssh/id_rsa、id_ecdsa、id_ecdsa_sk、id_ed25519、id_ed25519_sk 和 id_mldsa44_ed25519。Mac 上的手册可能更短。只在 agent 里、文件名又不在这份名单上的钥匙,不会被递出。
要留下来的几行
Host github.com
HostName github.com
User git
IdentityFile ~/.ssh/id_ed25519
IdentitiesOnly yes
Host、User、IdentityFile 换成你的。连这台主机的 scp 和 sftp 读同一份客户端配置。手册允许 IdentityFile 指向公钥文件,私钥不在磁盘上时从 agent 取对应私钥。
两个 GitHub 账号,或 GitHub 和 GitLab 各一把,要一个别名,并且 remote 使用它:
Host github.com-work
HostName github.com
User git
IdentityFile ~/.ssh/id_ed25519_work
IdentitiesOnly yes
remote 写成 git@github.com-work:ORG/REPO.git。github.com-work 是客户端的名字,HostName 才是真正的主机。AddKeysToAgent、UseKeychain、生成钥匙和对指纹,在 publickey 那篇。
Host * 下只写 IdentitiesOnly yes、却没有按主机写 IdentityFile,不是开头该用的。客户端这时只递已配置的身份或那些默认文件名。以前能登,只因为一把别的文件名恰好在 agent 里,这种登录会停。等看清哪台主机用哪个文件,再把全局 Host * 当成后面的可选默认。
ssh-add -d 和 ssh-add -D 仍是可选的、临时的,放在配置写好之后。不要从这里开始。不要删 ~/.ssh,不要对钥匙、config 或 authorized_keys 做 chmod 777,也不要因为这一句就把每把钥匙都换掉。
你管的那台服务器
在控制台或一条已经登着的会话里读生效上限。正在失败的 SSH 读不到对面。
sudo sshd -T | grep '^maxauthtries '
sshd -T 打的是生效配置。把 MaxAuthTries 调大不是第一步。你管不了的服务器,包括 github.com,不该先动这个数。这篇也没读过那个文件。
补全里带出来的名字
自动补全还会把这一句和 1Password、vCenter、FinalShell、「reset」放在一起。密码管理器的 agent 一次装很多钥匙时,可以打出同样的字。上面那页用的也是 IdentityFile 加 IdentitiesOnly yes,例子把 IdentityFile 指向下载的 .pub。这篇不走那个应用的界面,也没有记下谁在用 1Password。vCenter 和 FinalShell 不在这里。「Reset」不是 OpenSSH 客户端文档里对这一句的修法。
这篇停在这里
- 命令没有为这篇在 Mac 或 VPS 上重跑。依据是手册和上面的 OpenSSH 文件。机器上的
man优先。 - 没有记下 agent 列表或把数。默认值来自手册,不是某一台 Mac 的日志。
- github.com 和 gitlab.com 的
MaxAuthTries没有读到。 - 不读
~/.ssh/config的图形客户端,可以在命令行已经成功之后继续把 agent 里每一把都递出去。让它用同一份ssh,或只给它一把身份。那些界面这篇不写。 - 搜索量。这篇没有另做外部数据。
其他阅读路线见 自部署阅读路线。英文稿是同一题的另一份写法:Received disconnect: Too many authentication failures: the client offered too many keys。
这篇如果有用,欢迎自愿赞助,用来继续更新博客和自部署笔记。这不是慈善捐赠。