无法登录（问题解答）

问题汇总

• 【安全入口】面板默认开启了安全入口校验，直接访问 http://服务器IP:端口/ 会返回伪装的 404 页面，必须使用完整的安全入口地址登录，例如：http://服务器IP:端口/安全入口路径/
• 【安全入口忘记/丢失】在服务器上执行 ruyi-cmd info 可查看当前面板地址（含安全入口路径）；执行 ruyi-cmd setsafepath 可重新设置安全入口
• 【面板端口】执行 ruyi-cmd info 查看面板端口；执行 ruyi-cmd setport 可修改面板端口
• 【服务未运行】执行 ruyi-cmd status 查看面板运行状态；未运行时执行 ruyi-cmd start 启动
• 【IP 被临时封禁】连续多次登录失败会触发临时封禁（倒计时结束自动解封），等待解封或在服务器上执行 python manage.py clearLoginBan（可加 --ip=你的IP 只清指定 IP）立即解封
• 【验证码】连续登录失败达到阈值后，登录页会要求输入图片验证码，输入正确的验证码后即可继续登录
• 【OTP 动态口令丢失】更换手机或丢失验证器后，在服务器上执行 ruyi-cmd disableotp 关闭 OTP 两步验证后重新登录
• 【升级后页面白屏/点击无反应】浏览器缓存了旧版页面导致，按 Ctrl + F5 强制刷新即可恢复
• 【防火墙拦截】检查服务器防火墙 / 云服务器安全组是否放行了面板端口
• 【浏览器缓存异常】登录页静态资源加载失败时，先强制刷新（Ctrl + F5）或更换浏览器无痕模式验证

排查步骤建议

1. 确认服务在运行：服务器上执行 ruyi-cmd status，未运行先 ruyi-cmd start
2. 确认访问地址正确：ruyi-cmd info 核对面板端口与安全入口，使用完整入口地址访问
3. 确认网络可达：本机 ping / telnet 服务器IP 端口 测试连通性，检查防火墙与安全组
4. 确认账号信息：忘记密码请参见 《忘记密码（密码重置）》
5. 确认登录限制：IP 封禁等待倒计时或执行 python manage.py clearLoginBan 解封

相关命令速查

ruyi-cmd status       # 查看面板运行状态
ruyi-cmd info         # 查看面板信息（地址、端口、安全入口）
ruyi-cmd start        # 启动面板服务
ruyi-cmd restart      # 重启面板服务
ruyi-cmd setport      # 修改面板端口
ruyi-cmd setsafepath  # 修改面板安全入口
ruyi-cmd disableotp   # 关闭OTP两步验证
python manage.py clearLoginBan              # 清除所有登录封禁和失败计数
python manage.py clearLoginBan --ip=x.x.x.x # 只清除指定 IP 的封禁

更多安全说明

面板整体安全机制（安全入口、接口限速、token 有效期等）请参见 《面板安全（问题解答）》。