Featured image of post 给博客加个免费统计:Cloudflare Web Analytics 实操教程

给博客加个免费统计:Cloudflare Web Analytics 实操教程

不用 Google Analytics,也不用自己搭统计服务:Cloudflare Web Analytics 免费、无 Cookie、只贴一行代码。以 Hugo + Stack 主题、部署在 Cloudflare Pages 的博客为例,四步装好并验活。

博客写了多少篇、哪篇有人看、访客从哪来,这些问题不用装复杂的统计系统:Cloudflare 自带的 Web Analytics 就够了——免费、不种 Cookie、不拖慢页面,给页面贴一行代码就能开工。下面以 Hugo 博客(Stack 主题、部署在 Cloudflare Pages)为例,四步装完。

四步流程:后台建站 → 复制代码 → 粘进页脚文件 → 推送看数据

第一步:在 Cloudflare 后台添加站点

登录 Cloudflare 后台,左侧进入「Web Analytics」(新版界面在「可观测性 / 数据分析」下面),点「添加站点」,填自己博客的域名,点完成。有些域名它会提供"自动注入",但 Pages 自定义域名这类站点通常只给手动安装——这很正常,接着走第二步就行。

第二步:复制它给的 JS 代码

添加完会打开站点的管理页,页面上有一段现成的代码,整段复制下来,长这样(其中 Token 是你自己的,每个站点不一样):

1
<!-- Cloudflare Web Analytics --><script type='module' src='https://static.cloudflareinsights.com/beacon.min.js' data-cf-beacon='{"token": "这里是你自己的Token"}'></script><!-- End Cloudflare Web Analytics -->

提醒一句:这个 Token 是公开标识,本来就会印在网页源码里给所有人看,不是密码,不用打码保存;千万别把 Cloudflare 的 API 令牌错填进来。

第三步:把代码放进博客页脚

以 Stack 主题为例(其他主题思路相同):在博客仓库根目录新建文件 layouts/partials/footer/custom.html,把第二步的代码粘进去,保存。这是主题预留的页脚扩展位,构建时会自动出现在每个页面的 </body> 之前,不用逐页加。注意别去改主题目录里的模板本体,那些文件升级主题时会被覆盖。用其他主题的,就找主题的"自定义脚本/页脚代码"设置项,或者它预留的同类扩展文件。

第四步:推送,并验活

照常 git 提交、推送,等一两分钟部署完成。然后打开博客首页刷新一次,再「查看网页源代码」,搜 cloudflareinsights——能搜到就说明代码已经上线。回到 Web Analytics 管理页,几分钟后就会开始出现访问数据:访问量、浏览量、热门页面、来源和访客地区都有。

提醒:数据不是秒出的,刚装好看到 0 很正常,隔一会儿再看;如果过了一天还是 0,先回头检查第三步的文件路径有没有放错(必须在仓库根目录的 layouts 下,不是在主题文件夹里)。

总结: 后台建站 → 复制代码 → 粘进 layouts/partials/footer/custom.html → 推送验活,一共四步;哪天不想要了,删掉那行代码重新推送即可,干干净净。