# busuanzi

**Repository Path**: soxft/busuanzi

## Basic Information

- **Project Name**: busuanzi
- **Description**: 不蒜子是一个静态网站访问量统计系统
- **Primary Language**: Go
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: https://busuanzi.9420.ltd
- **GVP Project**: No

## Statistics

- **Stars**: 9
- **Forks**: 1
- **Created**: 2022-06-27
- **Last Updated**: 2026-03-01

## Categories & Tags

**Categories**: system-monitor

**Tags**: None

## README

[![soxft/busuanzi](https://socialify.cmds.run/soxft/busuanzi/image?description=1&font=Raleway&forks=1&language=1&logo=https%3A%2F%2Fraw.githubusercontent.com%2Fsoxft%2Fbusuanzi%2Fmain%2Fdist%2Ffavicon.png&name=1&owner=1&pattern=Circuit%20Board&stargazers=1&theme=Dark&cache=43200)](https://busuanzi.9420.ltd)

## 自建不蒜子

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

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

## 安装

支持多种运行方式: 源码编译运行, Docker 运行. 详见: [安装方法](https://gitee.com/soxft/busuanzi/wikis/install)

## 使用方式

支持多种自定义属性, 兼容 pjax 网页, 支持自定义 标签前缀. 详见: [使用文档](https://gitee.com/soxft/busuanzi/wikis/usage)

## 原理

- `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)   |


## 其他

Logo 由 ChatGPT 设计

## 数据迁移

- 可使用 [busuanzi-sync](https://gitee.com/soxft/busuanzi-sync) 工具迁移[原版不蒜子](http://busuanzi.ibruce.info)的数据

## 升级建议

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