部署自检与排障
先看这三件事
- 进程活着吗 ——
systemctl status gopanel - 端口通吗 ——
curl -i http://127.0.0.1:12395/api/auth/entry - 日志说什么 ——
journalctl -u gopanel -f
后端启动日志中有启动自检与逐请求访问日志，关键字段：
listen_port/listen_port_source：最终生效端口与来源- 数据库连接摘要（密码脱敏为
******）与失败原因
一键自检脚本
bash
# 后端直连 + 服务状态 + 日志输出
sh scripts/check-deploy.sh
sh scripts/check-deploy.sh --logs前端能打开但接口没数据
面板由单个二进制同时提供页面与 API，直接访问面板端口即可确认链路：
bash
curl -i http://127.0.0.1:12395/api/auth/entry- 通 → 接口正常，问题在前端页面请求（检查浏览器控制台 / 是否走了反代）
- 不通 → 面板没起来或端口 / 数据库配置不对，看面板日志
若经 Nginx 等反代访问，请确认 /api 反代目标指向面板端口。
打不开后台（看到引导页）
说明安全入口已启用。用命令行取回地址：
bash
./GoPanel -se忘记管理员密码
bash
./GoPanel -rp # 重置为 16 位随机密码并打印登录一直失败 / 返回 429
触发了登录失败锁定（默认连续 3 次失败锁定 5 分钟）。 到「设置 → IP 黑名单」解锁，或重启进程清空内存中的锁定记录。
数据库连不上
- 检查环境变量
GOPANEL_DB_*（或配置文件db.*） - PostgreSQL 需要预先建库（不会自动建库）
- 连接地址使用宿主机实际可达的地址（
127.0.0.1即本机）
升级检测提示不自动降级
开发版切回稳定通道时，若当前版本高于稳定通道最新版，系统提示不自动降级，需手动下载。