一套给自己看,一套给访客看。用 Umami + 不蒜子为博客添加完整的访问统计。


工具介绍

Umami

Umami 是一款开源的网站统计工具,定位是 Google Analytics 的隐私友好替代品。

  • 开源:代码完全公开,可自部署
  • 隐私友好:不使用 Cookie,不追踪个人信息,符合 GDPR
  • 数据详细:访客来源、设备类型、浏览器、停留时长、实时在线人数
  • 免费版:Umami Cloud 每月 10 万次页面浏览,个人博客完全够用
  • 数据归属:显示在后台,只有博主自己能看

适合用来了解博客的真实流量情况。

不蒜子

不蒜子 是一个极简的页面计数器,由国内开发者维护。

  • 接入极简:两行代码搞定
  • 免费无限制:没有用量上限
  • 双维度统计:网站总访问量 + 单篇文章浏览量
  • 数据公开:数字直接显示在博客页面上,访客可见
  • 缺点:不开源,数据存在作者服务器,部分广告拦截插件(如 Brave)会屏蔽

适合在博客页面直接展示浏览数字。


两者的区别

Umami 不蒜子
数据可见性 仅博主后台 页面公开显示
统计维度 详细(来源、设备等) 仅浏览次数
隐私 极佳 一般
接入难度 极简
开源

两者互补,同时使用效果最好。


一、接入 Umami Cloud

1. 注册账号

打开 umami.is,点 Sign up 注册,选择数据存储地区(推荐 United States)。

2. 添加网站

登录后进入 SettingsWebsitesAdd website

  • Name:填博客名称
  • Domain:填你的域名(如 shaifx.pages.dev,不加 https:// 和末尾 /

3. 获取追踪代码

添加完成后点 EditTracking code,复制类似这样的代码:

<script defer src="https://cloud.umami.is/script.js" data-website-id="你的ID"></script>

4. 注入博客

layouts/_partials/ 目录下新建 extend_head.html(PaperMod 专用扩展钩子,不会覆盖主题文件):

<script defer src="https://cloud.umami.is/script.js" data-website-id="你的ID"></script>

部署后登录 Umami 后台即可查看实时数据。


二、接入不蒜子

1. 加载脚本

layouts/_partials/extend_head.html 里追加一行:

<script async src="//busuanzi.ibruce.info/busuanzi/2.3/busuanzi.pure.mini.js"></script>

2. 显示网站总访问量

layouts/_partials/extend_footer.html 里加入:

<div style="text-align:center; padding: 10px; font-size: 0.85em; opacity: 0.6;">
  本站累计访问 <span id="busuanzi_value_site_pv"></span> 次 · 访客 <span id="busuanzi_value_site_uv"></span> 人
</div>

3. 显示单篇文章浏览量

先把主题模板复制到自己的目录(以 PaperMod 新版为例):

cp themes\PaperMod\layouts\single.html layouts\_default\single.html

然后找到显示阅读时间的位置,加入:

· 浏览 <span id="busuanzi_value_page_pv"></span> 次

三、推送部署

git add .
git commit -m "添加 Umami + 不蒜子统计"
git push

注意事项

  • 本地 hugo server 预览时不蒜子数字显示异常,属正常现象,部署到线上才准确
  • Brave 等浏览器内置拦截器会屏蔽不蒜子脚本,导致数字不显示,不影响其他普通访客
  • Umami 的统计数据在后台查看,不蒜子的数字直接显示在页面上,两套数据不互通