宝塔面板一直打不开,但 SSH 终端正常?别急着重装,先看这个进程-技术教程论坛-技术之家-989论坛

宝塔面板一直打不开,但 SSH 终端正常?别急着重装,先看这个进程

机房交换机端口指示灯

一、现象

一台 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 这种应用层错误。

终端中查看进程、端口和 pid 文件

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;
}

浏览器到内置 webserver 再到 BT-Panel 的访问链路

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 记录,但有两个客观事实值得注意:

  1. 机器内存只有 2G,面板的 Python 进程 + 内置 webserver + MySQL + Nginx 一起跑,可用内存长期偏紧,进程被系统回收的概率不低;
  2. 面板自带的守护线程只守护 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 依然显示一切正常。

请登录后发表评论

    没有回复内容