宝塔网站统计不生效怎么修？从插件安装、服务配置到日志排查

宝塔面板【网站统计总览】插件统计不生效，最常见的原因不是插件坏了，而是 site_total 服务没起来，或者站点配置文件里统计配置没被正确引入（比如多了个分号导致语法错误）。所以排查顺序是：先重跑安装脚本看报错 → 查服务状态 → 查 logger 进程 → 最后核对 Nginx/Apache 配置文件。

下面按这个顺序逐项做。

网站统计总览插件是什么？

宝塔面板的网站统计总览插件会在安装或更新面板（11.3 及以上版本）时自动安装。它通过把站点的访问日志实时发给 site_total 服务处理，从而在面板里汇总展示网站访问数据。

版本要求：此插件为 11.3 及以上版本安装或更新面板时自动安装。如需使用，请先将面板升级到 11.3+ 版本。

插件安装与管理

安装 / 卸载命令

插件的目录在 /www/server/site_total，安装和卸载都通过目录下的脚本完成：

# 插件目录
/www/server/site_total

# 安装插件（命令行执行）
bash /www/server/site_total/scripts/install.sh install

# 卸载插件（命令行执行）
bash /www/server/site_total/scripts/uninstall.sh

服务管理

面板把该服务写入了 systemd，可以直接用 systemd 管理：

# 启动服务
systemctl start site_total

# 停止服务
systemctl stop site_total

# 重启服务
systemctl restart site_total

# 查看服务状态
systemctl status site_total

# 查看服务日志
journalctl -u site_total

服务配置检查

统计数据能不能采集到，取决于 Web 服务的配置文件有没有把统计配置引用进来。Nginx 和 Apache 的接入方式不同，分别核对。

Nginx 环境配置

在 Nginx 配置文件中通过 include 引用统计配置文件来实现数据收集。

Nginx 配置文件路径：

/www/server/panel/vhost/nginx/extension/对应站点/*/site_total.conf

配置文件作用：

# 将符合格式的访问日志发送给 site_total 进行实时处理
access_log syslog:server=unix:/tmp/site_total.sock,nohostname,tag=10__access site_total;

Apache 环境配置

在 Apache 配置文件中通过 IncludeOptional 引入，然后启动一个 logger 进程进行数据收集。

Apache 配置文件路径：

/www/server/panel/vhost/apache/extension/对应站点.conf

问题排查与解决

基础排查

如果遇到统计不正常，先执行安装命令，观察安装过程及结束时是否有异常：

bash /www/server/site_total/scripts/install.sh install

常见问题：统计未生效

安装没问题，但统计功能依然没生效，按下面三步排查。

1. 检查服务状态

先看服务有没有报错或异常：

systemctl status site_total

2. 检查 logger 进程（Apache 环境）

Apache 环境下需要确认 logger 进程是否正常启动：

ps aux | grep logger

正常情况下应该能看到 logger 进程正在运行。

3. 检查 logger 版本

logger 版本过低也会导致统计异常：

logger --version

问题：配置文件语法错误

检查站点配置文件，如果发现有多余的分号或其他语法错误，会导致网站统计插件配置引入失败，从而无法启动 logger 进程。

修复方法：

1. 删除配置文件中多余的分号，或修复语法错误
2. 重载 Apache 服务：

systemctl reload httpd
# 或
service httpd reload

3. 检查统计功能是否恢复正常

提示：修复后建议重新访问网站几次，然后在面板中查看网站统计数据是否正常更新。

信息来源

本文事实以宝塔官方文档为准：《网站统计功能修复教程》。