
一、现象
一台 Linux 服务器,某天发现:
- SSH 能正常登录,终端一切正常,网站也正常访问;
- 但浏览器打开宝塔面板地址,一直转圈 / 连接超时 / 拒绝连接;
- 重启服务器无效,
bt restart之后过一段时间又打不开。
第一反应是“面板挂了”,于是很多人直接开始 bt restart、修复面板、甚至重装。实际上这次排查下来,面板的核心程序一直是活着的,挂掉的是另一个很容易被忽略的进程。
二、环境
- 系统:Debian 系 Linux
- 面板:aaPanel / 宝塔国际版(8.x)
- 内存:2G 小机器
- 面板端口:自定义端口(非 8888)
- 面板已开启 SSL
三、排查过程
1. 先确认面板进程在不在
ps aux | grep -E "BT-Panel|BT-Task" | grep -v grep
结果两个进程都在:
root 17920 /www/server/panel/pyenv/bin/python3 /www/server/panel/BT-Task
root 17928 /www/server/panel/pyenv/bin/python3 /www/server/panel/BT-Panel
bt status 也显示:
Bt-Panel (pid 17928) already running
Bt-Task (pid 17920) already running
所以“面板没启动”这个判断是错的。
2. 看端口到底有没有在监听
ss -lntp
输出里能看到 80、888、3306、21、SSH 端口……但就是没有面板端口。
本机自测也连不上:
curl -sk -m 5 -o /dev/null -w "%{http_code}n" https://127.0.0.1:面板端口/管理路径
# 000
000 表示连接层就失败了,不是 502/500 这种应用层错误。

3. 确认端口配置没写错
cat /www/server/panel/data/port.pl
cat /www/server/panel/data/admin_path.pl
端口、管理路径都正常,没有被改掉。
防火墙也排查过,面板端口在放行列表里:
ufw status
iptables -L -n
ufw 里 面板端口/tcp ALLOW Anywhere,ipset 黑白名单也是空的。所以不是防火墙拦的。
4. 关键发现:面板只监听了 Unix socket
查看 BT-Panel 进程打开的文件描述符:
ls -l /proc/<BT-Panel的PID>/fd
发现它只持有一个 socket,对应的是 /tmp/panel.sock,而 /tmp/panel.sock 这个文件确实存在,权限 srwxrwxrwx。
再看一下面板的启动脚本 /www/server/panel/BT-Panel 就明白了:
- 新版宝塔的
BT-Panel是一个 WSGI 应用,只监听本地 Unix socket; - 浏览器访问的 TCP 端口,是由一个内置的 nginx(
/www/server/panel/webserver/sbin/webserver)监听,再反向代理到/tmp/panel.sock。
配置在 /www/server/panel/webserver/conf/webserver.conf:
listen 面板端口 ssl default_server;
...
location /
{
proxy_pass http://unix:/tmp/panel.sock;
}

5. 找到真凶:前置 webserver 进程已经没了
cat /www/server/panel/webserver/logs/webserver.pid
# 17960
ps -p 17960
# 查无此进程
也就是说:BT-Panel 活着,但负责监听端口的内置 webserver 已经退出,pid 文件只是残留。
配置本身没问题,先做配置检查:
cd /www/server/panel/webserver
./sbin/webserver -t -c /www/server/panel/webserver/conf/webserver.conf
输出:
nginx: the configuration file ... syntax is ok
nginx: configuration file ... test is successful
配置完全正常,纯粹是进程没了。
四、解决办法
宝塔自带了启停脚本:
# 查看状态
bash /www/server/panel/script/webserver-ctl.sh status
# 启动
bash /www/server/panel/script/webserver-ctl.sh start
启动后立刻恢复:
ss -lntp | grep 面板端口
# LISTEN 0.0.0.0:面板端口 users:(("webserver",pid=xxxxx,fd=8))
用浏览器 User-Agent 验证返回 200,登录页正常;通过公网 IP 访问也返回 200。
或者直接:
bt restart
五、为什么进程会自己消失?
这次日志里没有抓到明确的 OOM 记录,但有两个客观事实值得注意:
- 机器内存只有 2G,面板的 Python 进程 + 内置 webserver + MySQL + Nginx 一起跑,可用内存长期偏紧,进程被系统回收的概率不低;
- 面板自带的守护线程只守护
BT-Task,不守护 webserver。也就是说 webserver 一旦退出,面板自己不会把它拉起来,表现就是“面板进程明明在跑,但网页打不开”。
另外,如果你最近做过面板升级 / 修复,也可能出现旧进程退出、新进程没起来的中间状态。
六、一劳永逸的做法:加个自动拉起
既然面板不守护它,就自己加一个定时检查。用宝塔「计划任务」新建一个 Shell 脚本任务,每 2 分钟执行一次:
#!/bin/bash
CTL=/www/server/panel/script/webserver-ctl.sh
if ! bash $CTL status | grep -q "is running"; then
bash $CTL start >> /www/server/panel/webserver/logs/watchdog.log 2>&1
echo "$(date '+%F %T') webserver was down, restarted" >> /www/server/panel/webserver/logs/watchdog.log
fi
注意:新建任务时把执行周期设为 2 分钟,脚本要能被 root 执行。
顺便,内存紧张的话建议加个 swap(如果还没有):
free -h # 先确认
swapon --show # 有输出说明已有 swap
七、排查思路小结
以后遇到“服务打不开”,按这个顺序走,能少走很多弯路:
| 步骤 | 命令 | 判断 |
|---|---|---|
| 进程是否存活 | ps aux | grep 服务名 |
进程在 ≠ 服务可用 |
| 端口是否监听 | ss -lntp |
没有目标端口就是连接层问题 |
| 本机是否可通 | curl 127.0.0.1:端口 |
000 是连不上,5xx 才是应用问题 |
| 防火墙 | ufw status / iptables -L -n |
排除拦截 |
| 前置代理进程 | 查 pid 文件对应进程是否存在 | 本次的关键 |
一句话总结:“面板进程在跑”和“面板能打开”是两件事。宝塔新版里,真正监听端口的是 webserver 这个内置 nginx,它挂了,bt status 依然显示一切正常。







没有回复内容