宝塔网站统计教程

宝塔网站统计
一、产品概述
宝塔网站统计（bt-stats）是一款轻量级、自托管的网站访问分析系统，作为宝塔面板插件运行。聚焦高性能、低成本、数据准确。

• 自托管：数据存储在自有服务器，不经过第三方
• 高性能：Go 采集后端 + DuckDB 列存引擎，单机可承载日均百万 PV
• 低资源：无需 MySQL/PostgreSQL，嵌入式数据库即开即用
• 准确可靠：Cookie 标识用户身份，精准识别新 / 回访客
  

功能矩阵

• 概览看板：PV、UV、IP、跳出率、平均访问时长、活跃用户趋势
• 访问分析：入口 / 出口页面排名
• 来源分析：来源域名 + 渠道分布（直接 / 搜索引擎 / 社交 / 外链 / 付费 / UTM）
• 访客分析：地域、浏览器、OS、设备、屏幕、语言 6 维分布
• 会话列表：Session 分页浏览 + 单会话行为日志
• 实时访客：实时访问列表 + 访问轨迹追踪
• 用户旅程：页面路径排名、事件流分析
• 广告追踪：UTM 五参数（source/medium/campaign/content/term）+ 广告平台 Click ID
• 页面性能：Web Vitals（LCP/INP/CLS/FCP/TTFB）均值、评分、趋势、维度分解
• 热力图：页面点击坐标热度分布，分页面配置与查询
• IP 地理分布：国家 + 省份 IP 分布可视化
  

二、快速开始
2.1 环境要求
服务器：Linux x86_64（Debian/Ubuntu/CentOS 均支持）
内存：最低 1GB，推荐 2GB 以上
磁盘：200MB 基础空间，日均 1 万 PV 约增加 100MB / 月
面板：宝塔 Linux 面板
Web 服务：Nginx/Apache（apache 仅支持手动配置）


2.2 安装插件
在宝塔面板「软件商店」中搜索「宝塔网站统计」并安装。安装完成后，进入插件设置页面完成相关配置。


2.3 开启网站统计
在插件的「网站列表」中添加要统计的站点。开启方式分为自动开启和手动开启。
CDN 类型：如果站点使用了 CDN，选择对应的 CDN 厂商（Cloudflare / 阿里云 / 腾讯云），确保获取到真实访客 IP。
备注：若已开启面板中的全局 CDN 可忽略此处设置。


2.4 注入跟踪脚本
自动部署：插件会自动在站点的 Nginx 配置中注入跟踪脚本，无需手动修改代码。部署后，任意访问者加载页面时，跟踪脚本会自动采集数据并上报。
手动部署：若自动部署失效、网站使用了反转代理或使用 Apache 服务，请选择手动部署。


方式一（Nginx）：修改网站配置文件，使用 sub_filter 替换</head>标签
sub_filter '</head>' '【这里粘贴手动配置信息】</head>';


方式二（推荐）：

• 将手动配置信息复制并粘贴到网站所有页面的</head>标签前
• 建议直接放在 header.htm 等公共页头模板中，实现 "一处安装，全站生效"
• 若需在独立 JS 文件中调用，请去掉首尾的<script>与</script>标签，将内部核心代码放入 JS 文件即可
  

注意：若网站开启了反向代理，请在 proxy_pass 下添加一行
proxy_set_header Accept-Encoding "";



部署完成后的站点上报路径：
/bt-stats.js    → 跟踪脚本
/bt-stats.gif   → 数据上报接口


2.5 验证部署
部署完成后，访问站点任意页面，打开浏览器开发者工具→网络，查看是否存在 bt-stats.gif 的请求，状态码应为 200，返回内容为 1×1 像素的透明 GIF。
等待几秒后，在插件概览页面即可看到统计数据。


三、数据说明
3.1 核心指标定义
PV：页面访问事件总数，代表页面访问次数
UV：独立访客数，代表访客数量
IP：独立 IP 数，访问网站的 IP 数量
跳出率：单页 Session 占比，仅访问 1 页就离开的会话比例
停留时长：总停留时长 / Session 数，单次访问的平均访问时长（上限 60 分钟，避免脏数据污染）


3.2 网页性能标准
统计指标
P50：中位数，代表中间水平，用于查看整体平均常态
P75：75 分位，75% 数据上限，代表多数流量的较差值
P95：95 分位，95% 数据上限，用于观察长尾异常、慢请求

性能指标
LCP 最大内容绘制：≤1.5s 优秀，≤2.5s 良好，≤4s 一般，＞4s 较差
INP 交互响应：≤100ms 优秀，≤200ms 良好，≤500ms 一般，＞500ms 较差
CLS 布局偏移：≤0.05 优秀，≤0.1 良好，≤0.25 一般，＞0.25 较差
FCP 首次内容绘制：≤1s 优秀，≤1.8s 良好，≤3s 一般，＞3s 较差
TTFB 首字节时间：≤400ms 优秀，≤800ms 良好，≤1.8s 一般，＞1.8s 较差


3.2 热力图
热力图展示访客在页面上的点击分布，直观呈现用户最关注、点击最密集的区域，辅助页面布局优化、按钮与广告位调整。



备注：若网站禁止在 iframe 中加载，请在网站配置中移除 X-Frame-Options / CSP frame-ancestors 配置。


Nginx 配置如下：

请注释掉这条配置 add_header X-Frame-Options SAMEORIGIN;



四、常见问题
Q：为什么统计数据比实际访问少？
可能原因：

• 跟踪脚本未覆盖全站所有页面。
• 后端校验过滤了异常数据（上报数据不合法）。
• CDN IP 识别配置不准确导致独立 IP 数偏低。
• CDN 配置了强制缓存JS导致统计不到
  

Q：支持哪些浏览器？
Chrome、Firefox、Safari、Edge 等现代浏览器均支持。Web Vitals 性能指标仅在支持 PerformanceObserver API 的浏览器中采集。

Q：数据能保存多久？
磁盘空间充足可永久保存。DuckDB 列式存储压缩率高，日均 1 万 PV 的站点每月约增加 100MB 数据量，请注意磁盘空间。

Q：能否统计多个站点？
支持。在插件「网站管理」中添加多个站点并分别部署跟踪脚本即可，数据相互独立。

Q：用户隐私如何处理？

• 使用匿名化 Cookie 标识访客，不含个人身份信息。
• 所有数据均只存放在用户服务器本地，不上传任何数据到第三方服务。