UsePAM yes仅开启PAM开关,真正实现与pam_faillock.so状态联动需三方面协同:一、确认sshd_config中UsePAM yes生效;二、在/etc/pam.d/sshd的auth段精准插入preauth/authfail/authsucc三行faillock规则;三、验证/var/run/faillock/状态更新、锁定响应及自动解锁是否正常。

要让 sshd_config 中的 UsePAM yes 与底层 pam_faillock.so 实现无缝状态联动,关键不是修改 sshd_config 本身(它只负责开关PAM),而是确保 SSH 服务真正调用并正确执行 PAM 的 faillock 认证链。这需要三方面协同:PAM 配置精准、SSH 服务启用 PAM、faillock 状态持久可查。
以下分步说明核心要点:
一、确认 UsePAM 已启用且生效
/etc/ssh/sshd_config 中必须包含:
UsePAM yes
✅ 检查方式:
sshd -T | grep usepam
输出应为 usepam yes。若为 no 或报错,需修改配置并重载:
sudo systemctl reload sshd
⚠️ 注意:UsePAM yes 是前提,但不等于自动启用 faillock——它只是打开“门”,具体认证逻辑由 /etc/pam.d/sshd(或其引用的文件)决定。
二、让 SSH 正确加载 faillock 模块(非仅靠 common-auth)
很多教程只改 /etc/pam.d/common-auth,但 SSH 默认不读取该文件(Debian/Ubuntu 下 sshd 显式 include common-auth;RHEL/CentOS 下则依赖 password-auth → system-auth 链)。因此必须确保 faillock 规则被 sshd 的 PAM 配置实际加载。
✅ 推荐做法(兼容性强):
编辑 /etc/pam.d/sshd,在 auth 段最上方插入三行(顺序不可变):
auth [default=ignore] pam_faillock.so preauth silent deny=5 unlock_time=900 fail_interval=60 auth [default=die] pam_faillock.so authfail deny=5 unlock_time=900 fail_interval=60 auth [default=ok] pam_faillock.so authsucc
? 为什么优先改 sshd 文件?
- 绕过发行版差异(如 RHEL 的
system-auth可能被其他服务覆盖) - 确保规则仅作用于 SSH 登录,不影响控制台或 su(如需统一,再同步到
common-auth或password-auth) - 避免因
include顺序或sufficient行提前退出导致 faillock 被跳过
三、验证状态联动是否真正打通
faillock 的“状态”存在 /var/run/faillock/(内存文件系统),而 SSH 登录失败时,只有 preauth 和 authfail 两步写入该目录;authsucc 则清除记录。联动是否成功,看三点:
- ✅ 失败计数实时更新:
faillock --user testuser # 应显示最近失败时间、IP、次数
- ✅ 锁定后 SSH 拒绝登录(即使密码正确):
第5次输错后,立即尝试正确密码,应返回Authentication failure(非Permission denied),且日志中出现pam_faillock(sshd:auth): user 'testuser' locked due to X failed attempts - ✅ 解锁时间自动生效:
等待unlock_time秒后重试,应能正常登录;或手动重置:faillock --user testuser --reset
? 日志定位(Debian/Ubuntu):
grep "pam_faillock" /var/log/auth.log
(RHEL/CentOS 查 /var/log/secure)
四、常见断联原因与修复
- ❌
sshd未 reload:改完/etc/pam.d/sshd后忘记systemctl reload sshd - ❌
deny=值不一致:三行中deny=5必须完全相同,否则逻辑错乱 - ❌
fail_interval过短:设为30但攻击间隔 >30 秒,导致永远不触发锁定 - ❌ root 被意外锁死:默认
pam_faillock不锁 root,如需锁定,加even_deny_root参数 - ❌
/var/run/faillock/权限错误:确保目录属主为root:root,权限0755,否则模块无法写入状态
不复杂但容易忽略


















