3x-ui 面板白屏，应该先检查什么？
问：端口能访问，但面板一直白屏，是安装坏了吗？
答：仅凭白屏无法确定原因，先核对完整访问地址，再看浏览器失败的请求。 GitHub Issue #2853 汇集了多种相似现象；同一个页面症状可能来自不同原因。
该帖子创建于 2025-04-01，核对时有 25 条评论、主题 4 个赞，已关闭。它是历史社区案例，并不代表当前版本仍有同一缺陷，也没有统一的维护者确认修复方案。
问：完整访问地址在哪里看？
答：在目标服务器运行 sudo x-ui settings，核对当前协议、端口和访问路径。 不要只输入服务器 IP 或域名根路径，也不要继续使用更新前保存的地址。
一位用户反馈，补齐 webBasePath 后恢复访问；但另一位用户表示重设路径没有解决问题。这说明路径值得检查，却不是通用答案。不要公开设置输出中的私有路径和凭据。
验证方法：用当前完整地址重新访问。如果可以出现登录页，说明这一分支已恢复；还应登录并确认页面交互正常。
问：地址正确，下一步看什么？
答：打开浏览器开发者工具的“网络”和“控制台”，重新加载页面，记录首个失败请求。 以下是本站根据故障层次整理的排查顺序，不是上游确认的单一修复：
| 观察到的现象 | 下一步检查 | 怎样确认 |
|---|---|---|
| 主页面请求超时 | 服务监听、面板端口的安全组与防火墙 | 先让主页面请求成功返回 |
| 主页面返回，但脚本或样式 404 | 访问路径、反向代理路径转发 | 对应资源能正常返回 |
| 证书错误 | 域名与证书匹配、证书有效期 | 用正确域名访问，无证书错误 |
| 只有特定浏览器失败 | 扩展、缓存及控制台错误 | 无扩展的浏览器环境对照结果 |
可以用 sudo systemctl status x-ui --no-pager 和 sudo ss -lntp 检查服务与监听状态；Docker 部署应检查对应容器。不要为了测试直接关闭全部防火墙，也不要从白屏直接推断代理入站有问题。
问：换一个网络能打开，是不是已经确认被封锁？
答：没有，只能说明访问路径或环境存在差异。 社区用户有更换网络后恢复的反馈，也有未恢复的反馈。对照时保持地址、浏览器和配置不变，记录失败请求的差异，再继续判断 DNS、网络和服务端响应；不要把网友对原因的猜测当成结论。
问：恢复面板之后，还需要做什么？
答：分别验证面板登录和客户端连接。 管理页面恢复不等于代理服务恢复。按部署教程的连接验证步骤检查客户端日志和实际访问结果。仍无法判断时，提交版本、部署方式及脱敏错误信息，避免只报告“白屏”。