登录常见问题

v1 之后 Dashboard 使用本地账户登录，并支持将本地账户绑定到 OAuth2 第三方账户。旧版 GitHub OAuth 登录问题不再适用于当前登录流程。

忘记管理员密码

请参考 初始化用户密码。重置后建议立即登录后台修改为新的强密码。

OAuth2 登录失败

请先确认以下配置：

1. Dashboard 配置文件中的 oauth2 字段使用新版结构，详见 设置 OAuth 2.0 绑定。
2. 第三方平台的 Callback URL 为 https://你的面板域名/api/v1/oauth2/callback。
3. 已先使用本地账户登录，并在个人信息页完成 OAuth2 绑定。

如果还没有绑定关系，不能直接使用 OAuth2 登录到本地账户。

登录接口被频繁尝试或误封

v1 引入了 Web 应用防火墙，用于限制登录爆破。若 Dashboard 部署在反向代理或 CDN 后面，请正确配置 前端真实 IP 请求头，否则可能因为无法识别真实访问者 IP 而出现误判。

如果已经误封，可以使用管理员账户在 系统设置 → Web 应用防火墙 中删除对应封禁记录。