外观
登录失败与账户被锁
适用范围
能打开 Web 登录页，但出现下面这些情况：
- 提示用户名或密码不正确，而你确认密码没错。
- 连续输错几次之后，正确的密码也被拒绝。
- 开启了两步验证，验证码一直不对。
- 登录成功，但左侧菜单很少。
- 登录之后很快又回到登录页。
不适用：页面根本打不开，见Web 界面打不开；页面上显示 502，见502 Bad Gateway 与 Failed to connect to socket；用 SMB 访问共享被拒绝，见SMB 访问被拒绝或反复要密码。
开始排查前
先分清三种账户，它们的密码互不相通：
| 账户 | 用途 | 说明 |
|---|---|---|
admin | Web 管理员 | 默认密码是 openmediavault，首次登录后应当立刻修改。它是唯一一个默认就能访问全部菜单的账户 |
root | Linux 的系统管理员 | 密码是安装时设置的，用于控制台和 SSH |
| 你在 OMV 里建的普通用户 | 文件共享账户 | 登录 Web 默认只能修改自己的密码和邮箱，且要管理员允许 |
本页的操作都是只读检查，或者重置失败计数、重置密码，不涉及数据。
排查步骤
1. 先对照现象
| 现象 | 可能原因 | 看哪一节 |
|---|---|---|
| 提示用户名或密码不正确 | 密码或大小写不对，或账户被锁，或系统盘满了 | 2、3、7 |
| 确认密码没错，连试几次仍被拒 | 账户被锁定 | 3 |
| 提示验证码不对 | 两步验证 | 4 |
| 能登录，但菜单很少 | 当前账户不是 Web 管理员 | 5 |
| 登录后很快回到登录页，提示会话过期 | 自动注销，或应用配置后需要重新登录 | 6 |
2. 核对账号和密码
- 确认用的是
admin或加入了openmediavault-admin组的账户，注意区分大小写，换个浏览器窗口排除自动填充了旧密码。 - 忘记了
admin的密码：在 NAS 本机或通过 SSH 登录，运行omv-firstaid，选Change Workbench administrator password。它只重置 Web 管理员密码，不会改 root 的密码。详见忘记管理员密码。 - 一直用默认密码的，参考第一次登录：修改默认密码修改。
3. 账户被锁定
OMV 的 Web 登录通过 PAM 验证，并启用了 pam_faillock。按源码里的配置：同一账户在 300 秒内连续失败 3 次就会被锁定，unlock_time=0 表示不会自动解锁，需要手动重置。
邮件模板与 PAM 配置有出入
OMV 在锁定时发送的通知邮件模板里写着「3 分钟后可以再次登录」，与 PAM 配置里的 unlock_time=0 不一致。以你实际看到的现象为准：先等几分钟再试，仍被拒绝就手动重置。
在 NAS 本机或 SSH 里查看和重置：
sh
# 在 OMV 的 shell 里执行
# 列出各账户的失败记录（只读）
faillock
# 重置某个账户的失败计数，<用户名> 换成被锁的账户
faillock --user <用户名> --reset也可以运行 omv-firstaid，选 Reset failed login attempt counter：它会列出有失败记录的账户和失败次数，选中后重置。菜单里的说明提醒，达到失败次数并不一定意味着账户已被锁定。
补充几点：
- 失败记录保存在
/var/run/faillock/下，那是内存文件系统，所以重启 NAS 通常也会清空它。 - OMV 每天会检查被锁定或接近锁定的账户，在开启邮件通知时发邮件提醒，邮件里同样提到用
omv-firstaid解锁。通知开关在系统 → 通知 → 事件（System → Notification → Events）的「验证」（Authentication）项。 - 如果同一个账户反复被锁，检查有没有脚本、监控或手机 App 还在拿旧密码持续尝试登录。
4. 两步验证（2FA）
OMV 8.5 系列起提供官方的 openmediavault-2fa-totp 和 openmediavault-2fa-emailotp 插件（当前两个插件都要求 OMV 8.5.9 以上），启用方法见两步验证：TOTP 与邮件验证码。
- 验证码总是错：TOTP 是 6 位数字、每 30 秒更换一次，服务器只容忍前后各一个时间窗口的偏差（约 30 秒）。NAS 和手机的时间差超过这个范围，验证码就一直不对。检查 NAS 的时间（
系统 → 日期和时间（System → Date & Time），见时间、时区与主机名），并把手机设为自动同步时间。 - 连续输错之后变慢：8.5.9 起，OMV 对验证码的尝试做了限速，等一会儿再试。这和密码连续输错 3 次被锁是两套机制，细节见两步验证一文的常见问题。
- 验证器丢了或手机换了：
admin自己丢了验证器，在 NAS 本机或 root 的 SSH 运行omv-firstaid。装了对应插件之后，菜单里会多出Disable Workbench administrator's 2FA TOTP和Disable Workbench administrator's 2FA Email OTP（认菜单文字，不要认编号），确认框的默认答案是「否」，要选「是」。它们关闭的是内置管理员admin的两步验证（TOTP 还会清除密钥）。其他账户丢了验证器，由另一个管理员在用户 → 2FA TOTP（Users → 2FA TOTP）里选中该账号的记录，点删除，该账号下次登录只要密码，再自己重新启用。完整的恢复流程见两步验证：TOTP 与邮件验证码。 - 邮件验证码收不到：邮件验证码依赖邮件通知能正常发信，先按配置邮件通知发一封测试邮件。
关闭两步验证会降低安全性，进入界面之后记得重新启用并保存新的恢复方式。
5. 登录之后菜单很少
当前账户不是 Web 管理员。官方说明：普通用户登录 Web 默认只能访问自己的账户设置，修改密码和邮箱（前提是管理员允许）；只有 admin 能访问全部功能。把普通用户加入 openmediavault-admin 组，它就成为 Web 管理员。做法与权限最小化的建议见管理员账户与最小权限。
6. 登录之后很快被退出
系统 → 工作台 → 设置（System → Workbench → Settings）里的自动注销（Automatic logout）默认是 5 分钟无操作就关闭会话，之后提示「会话过期」。- 8.5.10 起，PHP 的会话文件放在
/run/openmediavault/sessions这个内存目录里。应用配置之后需要重新登录一次，重启 NAS 也会让现有会话失效。 - 浏览器禁用或频繁清理 Cookie，同样会让登录状态保持不住。
7. 系统盘写满了
官方排障页指出：密码正确却一直被拒绝，最常见的原因是系统盘（rootfs）写满了。
sh
# 在 OMV 的 shell 里执行
df -h /使用率接近 100% 时，见系统盘满了。
确认恢复
- 用正确的账户登录，能看到仪表盘。
- 换另一个浏览器或隐私窗口再登录一次，确认不是浏览器缓存造成的假象。
- 重置过两步验证或密码的，登录之后重新启用并保存新的验证方式。
- 在 NAS 上运行
faillock，确认该账户没有残留的失败记录。
仍未解决
附上：登录页上的原始提示、用的是哪种账户、faillock 的输出，以及 诊断 → 系统日志（Diagnostics → System Logs）里「验证」类型的相关行。验证日志也可以在 shell 里查看：
sh
# 在 OMV 的 shell 里执行
journalctl --facility=auth,authpriv --no-pager -n 50分享前去掉主机名、IP 和账户名，读如何有效求助。
参考资料
- OMV 官方文档：FAQ（默认账号、非特权用户与
openmediavault-admin组）、Troubleshooting（系统盘满导致登录被拒、只有 admin 能看全部菜单） - 本站：安全检查清单、omv-firstaid 救援工具