首页/系统/信创系统运维速查/认证次数超限(Too many authentication failures)
常见问题65 条

认证次数超限(Too many authentication failures)

报 Too many authentication failures 是 agent 密钥过多逐个尝试所致:客户端精确指定密钥,服务端按需调整尝试上限。

信创系统运维速查系统更新于 2026-10-13

认证次数超限是怎么来的

SSH 客户端会按顺序尝试认证方式和密钥:如果 ssh-agent 或默认目录里加载了大量密钥,客户端会逐个试过去,服务端在超过 MaxAuthTries 后直接断开,报 Too many authentication failures。也就是说这不是口令错误,而是「试得太多次」。正确的处理方向是让客户端明确只用一个密钥,而不是放宽服务端限制。

基本信息

报错原文Too many authentication failures
根因客户端逐个尝试多个密钥,超过服务端 MaxAuthTries
客户端参数IdentitiesOnly=yes、-i 指定私钥
服务端参数sshd_config 中的 MaxAuthTries
权限要求调整服务端配置需 root

典型使用场景

  • 管理机上配了多个密钥,登录某台服务器时被直接拒绝
  • 图形环境的密钥环自动加载大量密钥后 SSH 开始报错
  • 同一账号能登录 A 服务器却登不上 B 服务器
  • 自动化脚本因密钥过多导致连接不稳定
  • 判断当前报错是口令错误还是认证次数超限

客户端处理

客户端处理
ssh-add -l                                            # 查看 agent 已加载的密钥数量
ssh-add -D                                            # 清空 agent,用于验证根因
ssh -v -o IdentitiesOnly=yes -i ~/.ssh/id_ed25519 user@host   # -v 观察认证尝试顺序
ssh -o PreferredAuthentications=publickey -o IdentitiesOnly=yes -i ~/.ssh/id_ed25519 user@host
# 长期做法:写入 ~/.ssh/config 按主机固定
# Host app-*
#   IdentityFile ~/.ssh/id_ed25519
#   IdentitiesOnly yes
sshd -T | grep -i maxauthtries                        # 服务端当前生效值

关键信息判读

信息来源看什么结论
报错文本Too many authentication failures认证次数超限,不是口令错误
ssh -v 输出依次尝试了哪些密钥确认是否试了很多无关密钥
ssh-add -lagent 中已加载的密钥数量数量多时优先怀疑这一项
sshd -TMaxAuthTries 的实际值服务端限制过严也会触发
调大服务端 MaxAuthTries 等于放宽防爆破限制:优先在客户端精确指定密钥(IdentitiesOnly=yes 加 IdentityFile)把尝试次数压下来。
把 IdentityFile 按主机分组写进 ~/.ssh/config 是最省事的长期方案,登录时不用每次手工加参数,也能避免脚本踩同一个坑。
判别要点:如果 ssh -v 输出里能看到客户端连续尝试了多个密钥之后才被断开,就属于次数超限;如果第一个密钥报 Permission denied 再重试口令,那才是密钥或口令本身的问题。

易错点

  • 误判为口令错误反复重输:报错已经指向认证次数超限,排查方向要换
  • 直接把 MaxAuthTries 调得很大:削弱了服务端的防爆破能力,应先从客户端收敛
  • 只用 -i 不加 IdentitiesOnly=yes:agent 里其他密钥仍会被尝试
  • 两台服务器表现不同就怀疑密钥损坏:先对比两边 MaxAuthTries 的差异
  • 不把配置固化到 ~/.ssh/config:下次登录又踩同一个坑
  • 在自动化脚本里忽略该报错直接重试:每次重试都重复整轮尝试,既拖慢流水线,也可能触发服务端封禁策略

数据来源与参考

  • man 5 ssh_config
  • man 5 sshd_config
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌