记录前台访问,在后台以统一风格的原生界面展示流量统计。IP 地理位置采用 缓存式懒解析:记录访问时只保存 IP 与访问信息,地理位置在后台查看统计时才 按需查询,并缓存到插件数据库,每个 IP 只对 IP 库查询一次。
参考自 Typecho 的 VisitorLoggerPro,但重新实现,避免了原版把庞大的本地 IP 库 打包进插件、以及记录时同步写入地理位置字段造成的空间浪费等问题。
- 访问数据独立存储:使用插件自有数据库(
DatabaseProvider)。默认是随插件 分离的 SQLite 文件(data/extensions/plugin-visitor-logger/visitor-logger.db), 也可在后台“插件数据库存储形式”里改为合并到主库(表前缀隔离)。 - IP 库分离、可更换:IP 库是一个独立的 SQLite
.db文件,放在插件数据目录, 不会被编译进程序。可以随时替换或更新,无需重新编译。留空文件名即关闭地理 位置解析(访问仍照常记录,位置显示为“未知”)。 - 记录只在请求之后异步进行:使用
request.after钩子,核心在响应发出后用 独立 goroutine 派发,所有数据库写入都在请求路径之外,且仅在插件启用并注册钩子 时才产生开销。静态资源、后台路径、非 GET 请求都会跳过。 - 缓存式懒解析地理位置:访问表只存 IP、路径、来源、UA、爬虫标记和时间;
地理位置存在单独的
ip_geo缓存表里。查看统计时,只对窗口内尚未缓存的 IP 查询一次 IP 库并写入缓存。百万次访问、几千个 IP,只需几千次查询。 - 后台风格统一 + iframe 图表隔离:设置页用核心声明式 Schema(MDUI 组件),
统计页用原生 MDUI 卡片 + 表格,卡片配色复用 MDUI 主题变量(
--mdui-color-*), 跟随后台动态配色;ECharts 图表运行在sandbox="allow-scripts"的 iframe 里, 图表库和数据都在 iframe 内,无法触达后台 DOM、Cookie 或存储。由于沙箱 iframe 读不到父页面的 MDUI 变量,图表配色由服务端读取后台主题种子色(admin_appearance选项)后在 Go 里推导出一套调色板,随数据一起注入 iframe,实现动态配色。 - 数据管理与筛选:统计页顶部提供快速时间筛选(近 7/15/30 天、全部)与自定义 日期范围(同一行),以及按日期清除历史记录;四项概览、四张图表和访问明细表都 随所选时间范围联动更新。访问明细表支持分页,每页条数可在设置里配置(默认 100)。
- 图表:每日访问趋势(整行)、归属地排行、省份分布(可用右上角下拉框切换 国家/地区,默认自动匹配中国的多种写法)、热门页面(单独整行,底部留白防止标签 截断)。
- 每日访问:折线图,占据整行。
- 归属地排行:环形图,按国家/地区访问量排名。
- 省份分布:环形图,展示某个国家/地区下各省份(region)的访问分布。右上角下拉框 的选项来自数据库中实际出现的国家/地区,默认优先选中中国(匹配“中国 / 中國 / China / CN / CHN”等写法),无中国数据时回退到访问量最高的国家/地区。切换下拉框在 iframe 内即时重绘,无需刷新。
- 热门页面:柱状图,单独占据整行,底部留出较大空间避免旋转的路径标签被截断。
- 数据范围筛选与分页:统计页顶部的数据管理卡片提供“近 7/15/30 天、全部” 快速筛选和自定义起止日期(MDUI 日期选择器),图表、概览和列表随所选范围同步 更新。访客列表分页展示,每页条目数可在设置里调整(默认 100)。范围与翻页通过 查询串驱动,天然走后台 PJAX 导航。
- 记录清理:数据管理卡片可清除指定日期之前的记录(默认预填 30 天前);设置里 另有“自动清理”开关,可在每次打开统计页前自动删除超过设定天数(默认 180 天)的 历史记录,可关闭。
IP 库是一个普通的 SQLite 文件,通过核心的 SQLite 驱动以只读方式打开。默认文件名
geoip.db,放在插件数据目录下(可在设置里改名)。期望的表结构:
CREATE TABLE ip_ranges (
start_ip INTEGER NOT NULL, -- 区间起始(含),IPv4 为 uint32,IPv6 为高 64 位偏移值
end_ip INTEGER NOT NULL, -- 区间结束(含)
version INTEGER NOT NULL, -- 4 或 6
country TEXT,
region TEXT,
city TEXT
);
CREATE INDEX idx_ip_ranges_lookup ON ip_ranges (version, end_ip);匹配条件:version = <4|6> AND start_ip <= key AND key <= end_ip。key 的编码规则
(与插件内部 ipSortKey 一致,转换 IP 库时必须遵循):
- IPv4:地址的 32 位整数形式(
0 .. 4294967295)。 - IPv6:地址的高 64 位,再减去
2^63落入有符号整数区间,使有符号比较保持 单调递增。精度为国家/地区/城市级别,满足统计需要。
如果你手头的 IP 库是别的格式(例如 ip2region 的 xdb、纯真 qqwry.dat),可以写一个
一次性转换脚本把它导入成上面的 ip_ranges 表;或者修改插件里的 geoLookupQuery
与 ipSortKey 适配其它布局,插件其余部分只依赖 ipLocation 结构。
| 配置 | 说明 |
|---|---|
| 启用访问记录 | 关闭后停止记录新数据,已有数据保留 |
| 记录已知爬虫 | 开启时记录并标记爬虫访问,关闭时跳过 |
| 每页条目数 | 统计页访客列表每页展示的行数,默认 100 |
| 自动清理旧记录 | 开启后每次打开统计页前删除超过设定天数的记录,可关闭 |
| 自动清理天数 | 自动清理开启时,早于该天数的记录会被删除,默认 180 |
| 爬虫关键词 | 每行一个 UA 关键词(不区分大小写),命中即视为爬虫 |
| 忽略的 IP | 每行一条规则,支持精确、通配符(192.168.*.*)、CIDR(10.0.0.0/8),IPv4/IPv6 |
| IP 数据库文件名 | 放在插件数据目录的 SQLite IP 库文件名,留空则关闭地理位置解析 |
统计页数据管理卡片另外提供:范围快速筛选(近 7/15/30 天、全部)、自定义起止日期、 以及“清除指定日期之前的记录”(默认预填 30 天前)。
后台仅管理员可见,访客列表展示完整 IP,便于排查真实来源。数据存储在插件独立数据库中,可通过保留天数设置定期清理。