James' Blog

# CyberPanel 503 错误排查与修复 ## 第一步：检查服务状态 “`bash # 检查 CyberPanel 服务 systemctl status cyberpanel # 检查 LiteSpeed 服务 systemctl status lsws “` 如果服务是 **inactive / dead**，尝试启动： “`bash systemctl restart cyberpanel systemctl restart lsws “` — ## 第二步：查看日志定位问题 “`bash # CyberPanel 日志 tail -50 /home/cyberpanel/error.log # LiteSpeed 错误日志 tail -50 /usr/local/lsws/logs/error.log # 系统日志 journalctl -u cyberpanel –no-pager -n 50 “` — ## 第三步：常见原因及修复 ### 原因 1：CyberPanel 服务崩溃（最常见） “`bash systemctl restart cyberpanel “` ### 原因 2：LiteSpeed 异常 “`bash systemctl restart lsws # 如果重启失败，强制杀掉进程 killall lshttpd /usr/local/lsws/bin/lshttpd “` ### 原因 3：磁盘空间满了 “`bash df -h “` 如果 `/` 或 `/home` 使用率 **100%**： “`bash # 清理日志 rm -rf /var/log/*.gz rm -rf /home/cyberpanel/error.log journalctl –vacuum-size=100M # 清理备份 rm -rf /home/backup/* “` ### 原因 4：端口 8090 未监听 “`bash # 检查端口 netstat -tlnp | grep 8090 # 或 ss -tlnp | grep 8090 “` 如果端口没被监听，说明 CyberPanel 服务没启动： “`bash systemctl start cyberpanel “` ### 原因 5：防火墙拦截 “`bash # 检查防火墙 firewall-cmd –list-ports # firewalld ufw status # Ubuntu # 开放 8090 端口 firewall-cmd –add-port=8090/tcp –permanent && firewall-cmd –reload # 或 ufw allow 8090/tcp “` ### 原因 6：Python 环境损坏 “`bash # 重建 CyberPanel 的 Python 虚拟环境 cd /usr/local/CyberPanel source venv/bin/activate pip install -r /usr/local/CyberPanel/requirments.txt systemctl restart cyberpanel “` — ## 第四步：终极修复方案 如果以上都不行，**升级/重装 CyberPanel**： “`bash # 升级（保留数据） sh <(curl https://cyberpanel.sh || wget -O – https://cyberpanel.sh) # 安装界面选择 2 = Upgrade “` — ## 快速一键修复脚本 “`bash systemctl restart cyberpanel systemctl restart lsws systemctl restart dovecot systemctl restart pdns systemctl status cyberpanel systemctl status lsws echo “— 端口检查 —” netstat -tlnp | grep 8090 “` — > 💡 **建议**：运行完排查命令后，把输出贴出来，我可以帮你进一步定位具体原因。