---
title: "宝塔面板网站统计不生效修复教程"
description: "修复宝塔面板（BT Panel）网站统计总览插件统计不生效的问题，覆盖 Nginx 与 Apache 两种环境下的配置修复与日志路径检查步骤。"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.bt.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 宝塔面板网站统计不生效修复教程

## 网站统计功能修复教程

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

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

![网站统计总览](/img/practical-tutorials/fix-site-statistics/image-20260117002751268.png)

## 插件说明

![插件介绍](/img/practical-tutorials/fix-site-statistics/image-20260117105301765.png)

## 插件安装与管理

### 安装/卸载命令

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

![安装成功状态](/img/practical-tutorials/fix-site-statistics/image-20260117104315619.png)

```bash
# 插件目录
/www/server/site_total

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

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

### 服务管理

面板将此服务写入到了 systemd 中，可以通过 systemd 进行管理：

```bash
# 启动服务
systemctl start site_total

# 停止服务
systemctl stop site_total

# 重启服务
systemctl restart site_total

# 查看服务状态
systemctl status site_total

# 查看服务日志
journalctl -u site_total
```

## 服务配置检查

### Nginx 环境配置

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

![Nginx配置引用](/img/practical-tutorials/fix-site-statistics/image-20260117110752348.png)

**Nginx 配置文件路径：**

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

**配置文件作用：**

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

### Apache 环境配置

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

![Apache配置引用](/img/practical-tutorials/fix-site-statistics/image-20260117095239072.png)

**Apache 配置文件路径：**

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

## 问题排查与解决

### 基础排查

如果遇到统计不正常的情况，可以先执行安装命令，查看安装过程及结束时是否有异常：

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

### 常见问题：统计未生效

#### 问题描述

安装没有问题，但是统计功能没有生效。

#### 排查步骤

**1. 检查服务状态**

首先执行以下命令查看服务是否有报错或异常：

```bash
systemctl status site_total
```

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

如果使用的是 Apache 环境，需要检查 logger 进程是否正常启动：

```bash
ps aux | grep logger
```

![检查logger进程](/img/practical-tutorials/fix-site-statistics/image-20260117105706578.png)

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

**3. 检查 logger 版本**

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

```bash
logger --version
```

![检查logger版本](/img/practical-tutorials/fix-site-statistics/image-20260117105832859.png)

#### 解决方案

**问题：配置文件语法错误**

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

![配置文件错误](/img/practical-tutorials/fix-site-statistics/image-20260117110025613.png)

**修复方法：**

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

```bash
systemctl reload httpd
# 或
service httpd reload
```

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

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

Source: https://docs.bt.cn/practical-tutorials/fix-site-statistics/index.mdx