跳到主要内容
版本：latest

网站统计功能修复教程

本教程将指导如何修复宝塔面板【网站统计总览】插件统计不生效的问题。

版本要求

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

网站统计总览

插件说明​

插件介绍

插件安装与管理​

安装/卸载命令​

执行安装脚本后成功的状态：

安装成功状态

# 插件目录
/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

服务配置检查​

Nginx 环境配置​

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

Nginx配置引用

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配置引用

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进程

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

3. 检查 logger 版本

logger 版本过低也会导致统计异常，可以执行以下命令查看版本：

logger --version

检查logger版本

解决方案​

问题：配置文件语法错误

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

配置文件错误

修复方法：

  1. 删除配置文件中多余的分号或修复语法错误
  2. 重载 Apache 服务：
systemctl reload httpd
# 或
service httpd reload
  1. 检查统计功能是否恢复正常
提示

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