gift95/busuanzi

自建不蒜子访问量统计系统

基于soxft/busuanzi项目开发，是一款轻量的访问量统计工具，采用Golang+Redis技术栈，提供站点及子页面的UV、PV统计功能，支持加密配置与数据迁移，适合个人或小型站点使用。

核心功能

• 统计站点整体UV（独立访客）与PV（页面浏览量）
• 统计子页面的UV与PV数据
• 支持Docker一键部署，降低运维成本
• 兼容Pjax动态网页技术
• 提供从原版不蒜子的数据迁移能力
• 可选对IP及路径进行MD5加密（16位/32位或不加密）

使用场景

适用于个人博客、静态站点、小型商业网站等需要轻量化访问量统计的场景，帮助站长直观了解站点流量情况。

配置说明

通过环境变量配置核心参数，关键项如下：

• WEB_LOG: 是否开启日志（true/false）
• WEB_DEBUG: 调试模式开关（true/false）
• WEB_CORS: 跨域访问设置（如"*"允许所有来源）
• BSZ_EXPIRE: 数据过期时间（秒，0表示永久保留）
• BSZ_SECRET: 签名密钥（需设置随机安全值）
• API_SERVER: API地址（需转义，用/代替/）
• REDIS_ADDRESS: Redis服务地址
• REDIS_PASSWORD: Redis访问密码
• BSZ_PATHSTYLE: 路径统计模式（true为path模式，false为url&path模式）
• BSZ_ENCRYPT: 加密算法（可选MD516/MD532或留空）

部署示例

Docker Compose部署

yaml
version: "3.8"
services:
  bsz:
    image: "docker.xuanyuan.run/gift95/busuanzi:latest"
    container_name: busuanzi
    ports:
      - "4080:8080"  # 宿主机端口映射
    volumes:
      - /opt/bsz/bsz:/app/expose
    environment:
      WEB_LOG: true
      WEB_DEBUG: false
      WEB_CORS: "*"
      BSZ_EXPIRE: 0
      BSZ_SECRET: "YourRandomSecret"  # 替换为随机密钥
      API_SERVER: https:\/\/your-domain.com  # 替换为实际API地址
      REDIS_ADDRESS: redis:6379
      REDIS_PASSWORD: your-redis-password
      BSZ_PATHSTYLE: true
      BSZ_ENCRYPT:  # 可选加密方式

原理说明

• 数据存储依赖Redis，利用其高性能内存数据库特性，结合RDB/AOF持久化确保数据安全。
• 数据存储结构：

  统计类型	存储结构	Key格式示例
  站点PV	String	bsz:site_pv:md5(host)
  站点UV	HyperLogLog	bsz:site_uv:md5(host)
  页面PV	ZSet	bsz:page_pv:md5(host):md5(path)
  页面UV	HyperLogLog	bsz:page_uv:md5(host):md5(path)