背景
Hugo 博客（PaperMod 主题）默认没有访问统计。为了了解谁在访问、访问了哪些页面，选择同时接入两套统计：
- Umami：隐私友好，无 cookie，数据存储在 Umami 服务器
- Cloudflare Web Analytics：与 Cloudflare 基础设施集成，数据存储在 Cloudflare
两者不冲突，可以同时运行，便于对比数据。
Umami
特点
- 无 cookie，无跨站追踪，不需要 GDPR 同意弹窗
- 免费 Hobby 计划：100K 事件/月，3 个站点，6 个月数据保留
- 地理位置精度：国家级别
统计维度
- 页面浏览量（PV）、独立访客数（UV）
- 每次会话浏览页数、跳出率、平均停留时间
- 引荐来源、UTM 参数
- 国家/地区、操作系统、浏览器、设备类型
- 各页面访问量排行
接入步骤
- 注册 cloud.umami.is
- Settings → Websites → Add website，填入域名
- 获取
<script>标签
Hugo PaperMod 接入方式
PaperMod 主题提供了 extend_head.html 扩展点，在项目根目录创建：
layouts/_partials/extend_head.html
内容：
<script defer src="https://cloud.umami.is/script.js" data-website-id="YOUR_WEBSITE_ID"></script>
将 YOUR_WEBSITE_ID 替换为 Umami 后台生成的 ID。
Cloudflare Web Analytics
特点
- 同样无 cookie，隐私友好
- 数据不设过期限制（免费）
- 地理位置精度：城市级别（比 Umami 更精细）
Automatic setup vs Manual setup
| 方式 | 条件 | 操作 |
|---|---|---|
| Automatic setup | 域名 DNS 托管在 Cloudflare（橙云代理） | 后台开关，无需改代码 |
| Manual setup | 任意域名 | 手动添加 <script> 标签 |
如果域名 DNS 不在 Cloudflare 托管，只能用 Manual setup。
接入步骤
- 登录 dash.cloudflare.com
- Observe → Analytics → Web Analytics → Add a site
- 填入域名，选择 Manual setup
- 获取
<script>标签
Hugo PaperMod 接入方式
将脚本追加到 layouts/_partials/extend_head.html：
<script defer src="https://cloud.umami.is/script.js" data-website-id="YOUR_UMAMI_ID"></script>
<!-- Cloudflare Web Analytics -->
<script defer src='https://static.cloudflareinsights.com/beacon.min.js' data-cf-beacon='{"token": "YOUR_CF_TOKEN"}'></script>
<!-- End Cloudflare Web Analytics -->
两者对比
| Umami (cloud) | Cloudflare Web Analytics | |
|---|---|---|
| 数据存储 | Umami 服务器 | Cloudflare |
| 地理精度 | 国家 | 城市 |
| 数据保留 | 6 个月（免费版） | 不限 |
| Cookie | 无 | 无 |
| GDPR 同意弹窗 | 不需要 | 不需要 |
| 自定义事件 | 支持 | 有限支持 |