1panel 面板出现 502 错误怎么解决

学完这篇，你能按「先判断哪一层出问题，再重启服务、看日志、修反向代理」的顺序，自己修好访问 1Panel 面板时出现的 502 Bad Gateway，不用重装系统。

第一步：先判断 502 出在哪一层，决定往哪个方向查

这一步的目的是分清「面板服务本身挂了」和「前面的反向代理连不上面板」，因为两者的修法完全不同。做法：用手机流量或换一台电脑，直接访问 http://服务器IP:面板端口（端口和安全入口用 SSH 执行 1pctl user-info 查看）。如果直连也 502，说明 1Panel 核心服务没跑起来，走第二到第五步；如果直连能打开、只有域名访问 502，说明是 Nginx 反向代理配置问题，直接跳到第七步。

注意：1Panel 默认带「安全入口」随机路径，直连时地址要写成 http://IP:端口/安全入口，路径不对会返回 404 或 403，别误判成 502。

第二步：登录 SSH，确认 1Panel 服务到底在不在跑

这一步要拿到服务的真实状态，正常情况下应该看到 active (running)。先执行：

systemctl list-units --type=service | grep -i 1panel

1Panel v1.10 及以上版本服务名是 1panel-core.service 和 1panel-agent.service，更早的版本是 1panel.service。接着执行：

systemctl status 1panel-core
1pctl status

如果显示 inactive (dead) 或 failed，就是服务停了；如果显示 active 却仍然 502，说明进程活着但端口没监听或反代指向错了。

第三步：重启 1Panel 服务并立即复测

这一步用一条命令把服务拉起来，然后刷新浏览器看是否恢复。优先用官方封装命令：

1pctl restart

如果 1pctl 不可用，用 systemd：

systemctl restart 1panel-core
systemctl restart 1panel-agent

重启后执行 1pctl status 确认状态，再直连面板地址验证。

注意：重启后如果几秒钟又变回 failed，说明是崩溃循环，不要反复重启，直接进第四步看日志，否则容易把日志刷掉。

第四步：查日志找到崩溃原因

这一步要拿到具体报错行，常见的是端口占用、配置文件损坏、数据库（面板自带的 SQLite）锁死。执行：

journalctl -u 1panel-core -n 200 --no-pager
tail -n 200 /opt/1panel/log/*.log

重点看 bind: address already in use（端口被占）、no space left on device（磁盘满）、permission denied（权限被改）。如果日志里出现数据库相关报错，可以先备份 /opt/1panel/db/ 目录，再执行 1pctl restart 观察是否恢复。

第五步：检查磁盘和内存这两个高频元凶

这一步排除「服务被系统杀掉」的情况。磁盘满会让面板无法写日志和数据库而崩溃，内存不足会触发 OOM Killer。执行：

df -h
free -h
dmesg | grep -i "out of memory"

如果 / 或 /opt 使用率超过 95%，先清理 Docker 无用镜像（docker system prune -a）或旧日志；如果看到 OOM 记录，考虑给服务器加内存，或在 1Panel 面板的「主机 → 进程」里限制占用高的应用。

第六步：确认端口监听与防火墙放行

这一步确认服务确实在监听、外部能进来。执行：

ss -lntp | grep 1panel

正常会看到服务监听在 0.0.0.0:端口。如果只监听 127.0.0.1，说明只允许本机访问，需要在反向代理场景下才能用。接着确认放行：

firewall-cmd --list-ports        # CentOS/RHEL
ufw status                       # Ubuntu/Debian

注意：云服务器还要在云厂商控制台的「安全组」里放行面板端口，服务器本机放行了但安全组没放行，同样连不上。

第七步：反向代理场景下修 Nginx 配置

这一步解决「直连正常、域名 502」。在 1Panel 面板里进入「网站 → 网站」，点你的站点名，选择「反向代理」，检查代理地址的 IP 和端口是否与 1pctl user-info 显示的面板端口一致。改完后执行：

nginx -t
nginx -s reload

代理配置里建议保留：

proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";

如果面板本身打不开，也可以直接编辑 /opt/1panel/apps/openresty/openresty/conf/conf.d/ 下对应站点的 conf 文件。

第八步：以上都不行，更新或修复面板

这一步做兜底。执行 1pctl update 升级到最新版（当前 v2 系列已修复多个导致服务异常退出的问题）。若仍无法启动，备份 /opt/1panel 目录后，用官网最新安装脚本重新执行安装，安装程序会识别已有环境并走修复流程。

小结

• 先分清 502 是面板服务问题还是反向代理问题，直连 IP 测一次最快。
• 服务状态用 1pctl status 和 systemctl status 1panel-core 看，v1.10 以上服务名带 -core。
• 重启无效别硬重启，先看 journalctl -u 1panel-core 和 /opt/1panel/log/。
• 磁盘满和内存 OOM 是面板 502 的两大隐形原因。
• 域名 502 优先查 Nginx 反向代理端口是否与面板端口一致，改完记得 nginx -t。