跳转到内容
GitHub

登录与安全

本页介绍怎么登录、给账号绑定验证器,以及修改密码时需要遵守的规则。账号启用二次验证,或管理员要求强制开启后,登录时才需要额外验证。

查看设备、空闲退出和强制下线,请读登录会话;查配置键和默认值,请读登录安全配置。

查看登录页截图
登录页:账号密码、手机验证码与第三方登录
  • 登录页(/sign-in):所有人都能访问。
  • 个人中心(/profile):修改自己的密码、绑定手机号和验证器、关联第三方账号、查看最近登录记录。
  • 系统管理 → 用户管理(/system/user):超级管理员为他人重置密码或二次验证。
  • 系统管理 → 参数配置(/plugins/config):调整策略,需要 sys:config:edit。
  • 日志管理 → 登录日志(/log/login):查看登录记录,需要 log:login:list。

重置密码和二次验证按超级管理员判定,只授予菜单权限还不能操作。

方式使用前需要做什么
账号密码输入账号、密码,以及默认开启的图形验证码
手机验证码系统已安装短信插件;本人先在个人中心验证并绑定手机号
GitHub / Google系统已配置 OAuth2 插件;先用账号密码登录,在个人中心关联第三方账号

管理员录入或导入的手机号,需要本人验证后才能用于登录。陌生第三方账号默认不能登录;开放自动注册需另行配置。

没有「忘记密码」的自助找回:登录页上写的是「忘记密码找管理员重置」。

先在 apps/api/backend/.env 设置 MFA_SECRET_KEY,然后重启后端。它必须是 64 位十六进制,可以这样生成:

终端窗口
python -c "import os;print(os.urandom(32).hex())"

密钥留空时,不能开启或强制二次验证。这是服务端密钥,请妥善保存,不要放进共享文档或截图。

  1. 打开「个人中心 → 二次验证」,开始绑定。
  2. 用 Google Authenticator、Microsoft Authenticator、1Password 等验证器扫描二维码。
  3. 输入当前动态码确认,并保存随后显示的 10 个恢复码。

绑定后,可以凭当前动态码在个人中心关闭二次验证或重新生成恢复码;被强制开启时不能关闭。

看到什么算成功: 退出后重新登录,会进入输入动态码的第二步。启用二次验证后,手机验证码和第三方登录也需要这一步。

在「系统管理 → 参数配置 → 登录策略」中设置「二次验证强制」:

值效果
off由用户自愿开启
superuser超级管理员必须开启
all所有人必须开启

尚未绑定的用户,下次在网页登录时需要先完成绑定才能进入系统。被强制的用户不能自己关闭。手机 App 支持输入动态码,但首次绑定需要在网页端完成。

规则默认可改范围
长度6–32 位1–128
必须包含特殊字符否——
不能和最近几次相同3 次0–24
有效期365 天(0 = 永不过期)0–3650
到期提醒提前量7 天(0 = 不提醒)0–365

在「个人中心」修改自己的密码;管理员在「系统管理 → 参数配置 → 口令与锁定」调整规则。后端同样会校验这些范围。

改自己的密码、或者被管理员重置密码之后,这个账号的所有会话都会结束(原因是「密码已修改」),包括当前这一个。

默认情况下,同一账号连续失败 5 次,锁定 5 分钟;同一 IP 累计失败 30 次,锁定 15 分钟,跨账号也累计。错误提示不会透露账号是否存在或已被锁定。

账号阈值在「系统管理 → 参数配置 → 口令与锁定」中调整;IP 阈值在 .env 中调整。经过反向代理部署时,还需配置 TRUSTED_PROXIES,让 IP 防护使用真实地址。键名和接口限流见登录安全配置。

超级管理员在「系统监控 → 在线用户」查看并结束会话。登录会话说明了多端上限、空闲退出和各种下线提示。

  • 第二因素只有 TOTP 和恢复码,没有通行密钥(WebAuthn)、硬件密钥,也没有用短信当第二因素。
  • 没有自助找回密码和自助注册(第三方登录显式打开自动建号的除外)。
  • 密码到期提醒在网页端还没显示出来;过期后本人不能自助改密码,见上文。
  • 会话依赖单实例 Redis 的 Lua 脚本,尚未在 Redis Cluster 上实测,见登录会话。
  • 登录安全配置:完整参数、扩展注意事项、源码和已有测试覆盖。
  • 试用会话管理:在演示站观察两个会话。二次验证建议本地体验,演示站不保证配有密钥。