README.zh_CN.md

自建不蒜子

一个基于 Golang + Redis 的简易访问量统计系统

• 统计站点的 UV, PV
• 统计子页面的 UV, PV
• 使用 Docker 一键部署
• 隐私保障 仅存储 HASH
• 兼容 Pjax 技术的网页
• 支持从原版不蒜子迁移数据

安装

支持多种运行方式: 源码编译运行, Docker 运行. 详见: Install

使用方式

支持多种自定义属性, 兼容 pjax 网页, 支持自定义 标签前缀. 详见: 使用文档

原理

• Busuanzi 使用 Redis 进行数据存储与检索。Redis 作为内存数据库拥有极高的读写性能，同时其独特的RDB与AOF持久化方式，使得 Redis 的数据安全得到保障。

• UV 与 PV 数据分别采用以下方式进行存储:

index	数据类型	key
sitePv	String	bsz:site_pv:md5(host)
siteUv	HyperLogLog	bsz:site_uv:md5(host)
pagePv	ZSet	bsz:page_pv:md5(host) / md5(path)
pageUv	HyperLogLog	bsz:site_uv:md5(host):md5(path)

数据迁移

• 可使用 busuanzi-sync 工具迁移原版不蒜子的数据

其他

Logo 由 ChatGPT 设计

升级建议

• 请务必在升级前备份数据 (dump.rdb)
• 新老版本数据可能并不兼容, 请注意 Release 界面的说明, 谨慎升级
• 2.5.x - 2.7.x 可以使用 bsz-transfer 工具进行数据迁移至 2.8.x