宝塔网站统计使用教程

宝塔网站统计

宝塔网站统计（bt-stats）是一款以宝塔面板插件形式运行的轻量级、自托管网站访问分析系统。本教程适用于 2.0 版本。

产品特点

• 自托管：统计数据保存在自己的服务器中，不经过第三方平台。
• 高性能：采用 Go 采集后端和 DuckDB 列存引擎，单机可承载日均百万 PV。
• 低资源占用：无需安装 MySQL 或 PostgreSQL，嵌入式数据库开箱即用。
• 准确可靠：通过 Cookie 标识访客，区分新访客与回访客。

竞品对比

功能矩阵

快速开始

环境要求

安装插件

登录宝塔 Linux 面板，进入【软件商店】，搜索并安装【宝塔网站统计】。安装完成后，打开插件配置页面。

开启网站统计

在插件的【网站列表】中添加或找到需要统计的站点，然后选择自动或手动模式开启统计。

如果站点使用了 CDN，请选择对应的 CDN 厂商（Cloudflare、阿里云或腾讯云），以便获取真实访客 IP。已经在面板中开启全局 CDN 的站点可以忽略此项。

以 Cloudflare 为例，可以在【缓存】>【配置】中清除缓存。

部署跟踪脚本

自动部署

插件会自动修改站点的 Nginx 配置并注入跟踪脚本，无需修改网站代码。部署后，访问者打开页面时会自动上报统计数据。

手动部署

自动部署失效、站点使用反向代理或 Web 服务为 Apache 时，请使用手动部署。

1. 选择以下任一方式部署插件生成的统计代码：

   • 方式一（Nginx）：在网站 Nginx 配置中使用 sub_filter，将统计代码插入 </head> 标签前。

     sub_filter '</head>' '【在此处粘贴插件生成的统计代码】</head>';

   • 方式二（推荐）：将统计代码粘贴到网站所有页面的 </head> 标签前。建议放入 header.htm 等公共页头模板，实现一次部署、全站生效。

     如果需要在独立 JavaScript 文件中调用，请去掉统计代码首尾的 <script> 和 </script> 标签，只保留核心代码。使用 CDN 的站点还需要刷新 CDN 缓存。

2. 如果网站使用反向代理，请在 proxy_pass 配置下添加：

   proxy_set_header Accept-Encoding "";

3. 按照插件界面提示检测配置并开启统计。

核心运行路径

验证部署

1. 访问目标网站的任意页面。
2. 打开浏览器开发者工具，进入【网络】面板。
3. 搜索 bt-stats.gif 请求。状态码为 200，且返回 1 × 1 像素的透明 GIF，表示上报正常。
4. 等待几秒后，返回插件概览页面，确认已经生成统计数据。

数据指标说明

核心访问指标

数据统计分位

Web Vitals 性能评分

2.0 功能配置

热力图

热力图展示访客在页面上的点击分布，可用于评估页面布局、按钮和广告位的效果。

1. 进入插件的【热力图】页面，添加需要监控的页面地址并保存。
2. 产生访问数据后，打开对应页面的热力图。
3. 按需切换 PC、平板或移动端，查看不同视口下的点击热度。

热力图预览通过 iframe 加载目标页面。如果站点设置了 X-Frame-Options: SAMEORIGIN 或 CSP frame-ancestors 限制，需要移除限制或放行面板的域名或 IP。插件一键写入失败时，请在站点的 Nginx 或 Apache 配置中手动添加 CSP 放行规则，并将 frame-ancestors 的值替换为面板的真实域名或 IP。

转化漏斗

漏斗可以自定义转化流程节点，统计每个环节的访客数量、转化率和流失率，帮助定位流失较多的步骤。

例如，可以配置“访问首页（index.html）→ 进入下载页（download.html）→ 完成登录（/login.html）”三步转化流程。产生数据后，漏斗图会分别展示进入人数、流失人数和每一步的转化率。

会话回放

会话回放可以还原访客的鼠标移动、点击、滚动和页面跳转等操作，用于定位页面卡顿、按钮无响应、流程中断等体验问题。

站点开启统计后，进入【网站】>【网站设置】，开启回放并设置采样率和路径过滤规则。

回放功能使用以下请求：

回放配置响应示例：

{
  "sample": 0,
  "blockUrls": null,
  "recordingId": "80c8e723-888b-4c56-b5e2-34fed4460430"
}

回放数据默认启用严格文本脱敏，输入框和敏感文本等内容不会被录制。

数据大屏

数据大屏将核心访问指标与 IP 地域分布集中展示，适合运营会议和监控室投屏。

在插件【大屏设置】中开启大屏，配置访问端口、安全路由或域名，然后添加大屏登录用户并为其授权站点。配置完成后，通过生成的独立 URL 访问大屏。

常见问题

为什么统计数据比实际访问量少？

可能原因如下：

1. 跟踪脚本没有覆盖网站的所有页面。
2. 浏览器插件或广告拦截工具拦截了统计脚本。
3. 后端过滤了不合法或无效的上报数据。
4. CDN IP 识别配置不正确，导致独立 IP 或访客统计出现偏差。

支持哪些浏览器？

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

数据能保存多久？

磁盘空间充足时，数据可以永久保存。日均 1 万 PV 的站点每月约增加 100 MB 数据，请预留足够的磁盘空间。

能否统计多个站点？

支持。可以添加多个站点并分别部署跟踪脚本，各站点的数据相互独立。

如何保护访客隐私？

• 插件使用匿名 Cookie 标识访客，不收集或保存个人身份信息。
• 统计数据仅保存在自己的服务器中，不会上传到第三方平台。
• 会话回放默认启用严格文本脱敏，不录制输入框和敏感文本。