不蒜子.rs

简洁的网站访客统计服务 · Rust 高性能实现

站点访问 (PV)

站点访客 (UV)

本页访问

特性

零外部依赖，单一二进制

内置 SQLite，数据持久化

高性能内存缓存

RESTful API 接口

兼容原版 busuanzi

完整管理后台

API 接口

方法	路径	说明
POST	/api	统计并返回 PV/UV
GET	/api	仅获取 PV/UV (不计数)
PUT	/api	仅提交统计 (不返回)
GET	/ping	健康检查

请求头

Header	必须	说明
`x-bsz-referer`	是	当前页面 URL

访客身份通过 Cookie (busuanziId) 自动识别，与原版 busuanzi 兼容。

响应格式

{
  "success": true,
  "data": {
    "site_pv": 1234,  // 站点总访问量
    "site_uv": 567,   // 站点独立访客
    "page_pv": 89     // 当前页面访问量
  }
}

快速开始

// 统计当前页面并获取数据
const res = await fetch('https://bsz.saop.cc/api', {
  method: 'POST',
  credentials: 'include',  // 携带 Cookie
  headers: { 'x-bsz-referer': location.href }
});

const { data } = await res.json();
console.log('PV:', data.site_pv, 'UV:', data.site_uv);

完整示例

<!-- 在页面中显示访问统计 -->
<p>本站访问 <span id="pv">-</span> 次</p>

<script>
(async () => {
  const res = await fetch('https://bsz.saop.cc/api', {
    method: 'POST',
    credentials: 'include',
    headers: { 'x-bsz-referer': location.href }
  });
  
  const { data } = await res.json();
  document.getElementById('pv').textContent = data.site_pv;
})();
</script>