一、插件简介

网站统计分析（Webstat）是基于迅睿CMS官方开发的网站用户统计分析系统，参考谷歌统计、百度统计的常用功能，提供实时监控、访问趋势、来源分析、受访分析、访客画像、会员分析等完整的统计能力。

插件在保留官方插件全部防恶意访问能力（IP黑名单、客户端黑名单、请求频率限制、蜘蛛过滤等）的基础上，新增了访问来源、页面标题、浏览器语言、屏幕分辨率、会话标识、停留时长等采集维度，并增加按天汇总表，统计数据读取更快。

二、功能概览

三、安装方法

（一）安装插件

第一步：将压缩包 webstat-1.2.6.zip 上传到服务器；

第二步：登录迅睿CMS后台，进入【应用】→【应用管理】→【安装应用】，选择上传的压缩包进行安装；

第三步：安装完成后，在【应用管理】中找到“网站统计分析”，点击启用；

第四步：进入【系统】→【更新缓存】。

（二）开始统计

动态页面（PHP页面）无需任何操作，系统通过钩子自动采集访问记录；

如果网站启用了静态页面生成功能，请打开【统计代码】，将统计代码复制到模板公共位置（如 footer.html），保存后重新生成静态页面。

安装完成后，后台左侧菜单出现“网站统计分析”分组，包含11个功能入口。

四、参数配置说明

（一）统计设置

（二）防恶意访问

五、统计模块使用说明

除实时监控外，网站概况及各统计模块（趋势、来源、受访、访客、会员）均支持时间范围切换：今天、3天、7天、15天、30天，以及自定义起止日期。

访问日志模块支持按字段搜索（账号、IP、URL、页面标题等）、按时间范围筛选、查看单条详情、拉黑IP和客户端；删除记录需在开发者模式下操作。

来源分析模块新增「访客区域分布」与「IPv4/IPv6访问占比」图表：IPv4地址通过迅睿内置IP库反查省市区域；IPv6地址通过内置运营商/机构前缀表反查区域（电信、联通、移动、教育网及Google、Cloudflare等），未命中的IPv6地址归为「IPv6其他地区」。

v1.2.0 新增「网站概况」总览页：6 张核心指标卡（浏览量、用户数、新用户、会话数、平均互动时长、跳出率）均标注较上一周期涨跌百分比；流量趋势折线图（PV/UV）与渠道分布环形图（直接访问、搜索引擎、外部链接、站内访问）并列展示；热门页面 TOP10 表格支持一键导出 CSV 文件。全站统计页面已统一为 GA 风格标签导航，后台左侧菜单新增「网站概况」入口。

v1.2.1 更新：新增「使用说明」页面（内置插件简介、快速开始、功能模块、时间范围、指标口径、区域反查、导出、参数配置及常见问题说明），后台左侧菜单与页面右上角同步提供「参数配置」「使用说明」快捷入口；同时修复迅睿 4.7.6（CodeIgniter 4 内核）兼容性问题，受访分析等页面的数据库查询方法调用已全部修正。

v1.2.2 更新：修复访问日志 IP 所属地区不准确的问题。访问日志列表、详情及实时监控页面的 IP 地区统一改用插件内置区域反查（IPv4 走迅睿 IP 库并正确提取省市，修正三字省份如「黑龙江」被截断为「黑龙」的问题；IPv6 走内置运营商/机构前缀表），不再依赖迅睿内核旧版 IP 展示函数。

v1.2.3 更新：修复网站概况与来源分析页面的查询报错。搜索词统计由 CI3 风格链式查询（$this->db->where）改为 CodeIgniter 4 兼容的原生 SQL 写法（query->getResultArray），适配迅睿 4.7.6（CI4 内核）的数据库连接对象。

v1.2.4 更新：访问日志列表与实时监控页面的 IP 地址列拆分重组——IP 与地区独立成列，地区列完整显示国家省市（如「中国 山西省 阳泉市」），拉黑操作移至最后一列，URL 列收窄并支持超长省略；新增内网/保留地址识别，内网、本机、IPv6 链路本地等地址不再显示为「未知」。

v1.2.5 更新：全站统计页面搜索工具栏样式类名优化（去除 Bootstrap row 栅格类，避免负外边距导致的左右偏移），涉及网站概况、趋势、来源、受访、访客、会员、访问日志等全部统计页面。

v1.2.6 更新：网站概况页「热门页面 TOP10」右侧新增「AI 爬虫分析」卡片：按 User-Agent 关键词自动识别 GPTBot、ChatGPT-User、ClaudeBot、Google-Extended、PerplexityBot、CCBot、Bytespider、Amazonbot、cohere-ai、Meta AI 等主流 AI 大模型爬虫，展示抓取次数占比环形图与 TOP10 排行。爬虫记录默认关闭，需在参数配置中开启「记录蜘蛛」后开始采集 AI 爬虫访问数据。

六、常见问题

七、卸载说明

在【应用管理】中卸载本插件即可。卸载将删除本插件的全部数据表（app_web_stat_log 访问明细表、app_web_stat_daily 按天汇总表）及参数配置，请提前备份需要保留的数据。