busuanzi

• 简体中文

self-hosted busuanzi

A simple visitor statistics system based on Golang + Redis

• Calculate the UV and PV of the website
• Calculate the UV and PV of the subpage
• One-click deployment using Docker
• Privacy protection only stores HASH
• Pjax compatible webpage
• Support migration from the original busuanzi

Installation

Support multiple running methods: compile and run from source code, run with Docker. See Install for details

Quick Start with Docker

1. Edit the docker-compose.yaml file with your own configuration.
2. Run docker-compose up -d to start the service.
3. Visit http://localhost:8080 to view the data.

Usage

Supports multiple custom attributes, compatible with pjax web pages, supports custom tag prefixes. See: Usage documentation

Principle

• Busuanzi uses Redis for data storage and retrieval. Redis, as an in-memory database, has extremely high read and write performance. At the same time, its unique RDB and AOF persistence mechanisms ensure the security of Redis data.

UV and PV data are stored in the following keys:

Data Migration

• You can use the busuanzi-sync tool to sync data from the original busuanzi to the self-hosted busuanzi.

Upgrade Suggestions

• Please be sure to back up your data (dump.rdb) before upgrading.
• New and old version data may not be compatible, please pay attention to the instructions on the Release interface, upgrade cautiously
• 2.5.x - 2.7.x can use the bsz-transfer tool to migrate data to 2.8.x.

Other

Logo created by ChatGPT

Thanks

• CDN acceleration and security protection for this project are sponsored by Tencent EdgeOne: EdgeOne offers a long-term free plan with unlimited traffic and requests, covering Mainland China nodes, with no overage charges. Interested friends can click the link below to claim it ->
  • Best Asian CDN, Edge, and Secure Solutions - Tencent EdgeOne.
• Thanks to JetBrains for providing free student licenses for this project.

<p align="center"> <a href="https://edgeone.ai/?from=github" style="margin-right: 24px; display: inline-block;"> <img src="https://raw.githubusercontent.com/soxft/busuanzi/refs/heads/main/static/edgeone.png" alt="Tencent EdgeOne" width="200" style="vertical-align: middle; margin-right: 24px;"/> </a> <img src="https://resources.jetbrains.com.cn/storage/products/company/brand/logos/jetbrains.png" alt="JetBrains Logo" width="200" style="vertical-align: middle; margin-right: 24px;"/> <img src="https://resources.jetbrains.com.cn/storage/products/company/brand/logos/GoLand_icon.png" alt="GoLand Logo" width="50" style="vertical-align: middle;"/> </p>