轻量级网站访问统计系统

功能特性

开箱即用的完整统计能力，满足网站分析需求

📊

实时数据看板

今日 PV/UV/IP 等核心指标卡片展示，支持与昨日对比，变化趋势一目了然。

📈

趋势图表

基于 ECharts 渲染近7天 PV/UV 趋势折线图，浏览器分布环形饼图，操作系统横向柱状图。

🌍

访客地理位置

多源 IP 查询 API 自动解析国家/省份/城市，按地区分布可视化展示，支持 30 天文件缓存。

🖥️

设备与浏览器分析

自动解析 User-Agent，识别浏览器/版本、操作系统（含 Win10/Win11 区分）、设备类型（桌面/手机/平板）。

🔄

SPA 单页应用支持

自动劫持 History API 和 hashchange，监听路由切换并上报页面浏览与停留时间。

🏢

多站点管理

一个部署实例即可统计多个网站，站点独立隔离，支持启用/停用和级联删除。

⏱️

停留时间统计

利用 visibilitychange 和 beforeunload 事件精确追踪页面停留时长，兼容移动端切后台场景。

🔗

来源分析

自动记录 Referrer 来源页面，区分直接访问与外部引流，助力渠道分析。

🛡️

隐私友好

自托管部署，数据完全归自己所有。无第三方依赖，不向外部发送访客数据。

技术栈

极简架构，兼容性极强，几乎可在任何 PHP 主机上运行

层级	技术	说明
后端语言	PHP 5.x / 7.x / 8.x	兼容所有主流 PHP 版本
数据库	MySQL (InnoDB)	PDO 连接，utf8mb4 字符集
追踪脚本	原生 JavaScript (ES5)	零依赖，兼容 IE9+ 浏览器
图表引擎	ECharts 5.4	CDN 加载，丰富图表类型
IP 地理位置	多源 API	ip-api.com / 淘宝 / 太平洋，带缓存
HTTP 客户端	cURL / file_get_contents	自动降级，适配各种环境

工作原理

从嵌入代码到数据展示，整个流程简单透明

STEP 1

嵌入脚本

→

STEP 2

数据采集

→

STEP 3

后端处理

→

STEP 4

写入数据库

→

STEP 5

可视化看板

访客访问页面 → tracker.js 采集浏览器/屏幕/来源信息 → POST 到 track.php →
解析 UA + 查询 IP 地理位置 → 写入 visits 表 + 更新 daily_stats 汇总 → 管理后台 ECharts 可视化呈现

数据模型

三张核心表，覆盖原始记录与聚合统计

表名	作用	关键字段
sites	站点管理	site_key (16位密钥)、site_name、site_url、状态
visits	原始访问记录	visitor_id、IP、地理位置、URL、Referrer、UA、设备、屏幕、停留时间
daily_stats	每日汇总	PV、UV、IP数、新访客数、平均停留时间（按站点+日期去重）

快速开始

4 步部署，立即拥有自己的网站统计

1️⃣ 上传文件到 PHP 服务器

确保服务器运行 PHP + MySQL，将所有文件上传到网站目录。

2️⃣ 修改配置文件

编辑 config.php，填入数据库连接信息和后台密码。

3️⃣ 登录后台添加站点

访问 admin.php 登录后台，点击「添加站点」创建新站点，获取 site_key。

4️⃣ 嵌入追踪代码

将下面这段代码复制到目标网站的 </body> 标签之前：

                
                // 将以下代码放入 </body> 之前

                <script
                 src="http://your-domain/tongji/tracker.js"
                 data-site-key="YOUR_SITE_KEY"></script>

追踪能力一览

覆盖几乎所有你需要了解的访问数据

指标	说明
PV（页面浏览量）	✓
UV（独立访客）	✓
IP 统计	✓
新访客识别	✓
停留时间	✓
来源分析 (Referrer)	✓
地理位置（国家/省/市）	✓
浏览器 & 版本	✓
操作系统 (含 Win10/11区分)	✓
设备类型 (Desktop/Mobile/Tablet)	✓
屏幕分辨率	✓
SPA 路由监听	✓
跨域上报	✓

项目文件结构

极简设计，仅 5 个核心文件

文件	功能
config.php	核心配置、数据库连接、工具函数、IP/UA 解析
index.php	入口重定向到管理后台
admin.php	管理后台（登录、仪表盘、站点管理、API 接口）
track.php	数据采集 API 端点，接收并处理上报数据
tracker.js	前端追踪脚本，嵌入目标网站