给网站装一块自己的流量看板，Iris Analytics 不用自备服务器和数据库

我们做网站以后，最先想知道的通常不是一堆复杂指标。

今天来了多少人？大家从哪里进来？哪些页面看得最多？手机访问多，还是电脑访问多？

这些问题并不复杂，麻烦的是后面的部署。

买服务器、装数据库、配统计服务，忙活半天，可能网站本身还没多少访问。直接用大型分析平台又太重，菜单一层套一层，想找一个数据还得先学会它的报表体系。

最近我们发现了一个挺轻的小项目，叫 Iris Analytics。

它把网站统计需要的前端、API 和数据存储都放到了 Cloudflare：Pages 负责页面和接口，Workers Analytics Engine 负责保存时序数据。我们不用再单独准备服务器，也不用维护 MySQL、PostgreSQL 这类数据库。

这个项目基于 HanAnalytics 重构，重点调整了数据总览和使用体验。

截至本文整理，项目版本为 1.2.7，采用 MIT 协议开源。它目前只有 12 个 Star，算不上热门项目，但思路很适合已经在用 Cloudflare 的个人站长和独立开发者。

01 不是简化版 Google Analytics，而是一块自己的数据看板

Iris Analytics 做的事情很直接：在网站底部放入一段追踪脚本，访问数据就会写入我们自己的 Cloudflare Analytics Engine。

打开仪表板，可以看到浏览量、访客数和访问次数，也能继续查看：

• 每个时间段的流量变化
• 访问最多的页面
• 外部来源网站
• 浏览器和操作系统
• 桌面、手机、平板等设备类型
• 访客所在国家或地区

时间范围可以切换为今天、昨天、最近 7 天、30 天、60 天和 90 天。一个面板还可以集中管理多个网站，并通过站点标识把数据分开。

这套功能不算多，但基本覆盖了小网站最常看的数据。

我们更喜欢它的一点，是整个页面没有复杂的报表配置。打开就看数字，点进站点就看页面、来源和设备，学习成本很低。

02 最省事的地方，是不用再养一套数据库

传统自托管统计工具通常意味着一整套运维工作：服务端应用、数据库、容器、备份和更新，一个都少不了。

Iris Analytics 走了另一条路。

它的 Vue 前端和 Pages Functions 可以直接部署到 Cloudflare Pages。每次访问产生一个数据点，再由 Analytics Engine 保存；查看报表时，项目通过 Cloudflare 的 SQL API 查询并汇总。

对我们来说，这个架构带来的收益不是某个参数更漂亮，而是少维护了一台机器和一套数据库。

对个人博客、作品集、文档站和刚上线的小产品，Iris Analytics完全够用。

03 一段脚本接入，多个站点放在一起看

部署完成后，进入“设置 → 集成工具”，填一个自定义的网站标识，就能拿到追踪代码。

形式大概是这样：

<script
  defer
  src="https://你的项目.pages.dev/tracker.min.js"
  data-website-id="你的网站唯一标识">
</script>

把它放到网站底部，等产生新的访问数据，再回到仪表板查看即可。

追踪脚本会记录页面路径、外部来源、浏览器、操作系统、设备类型、国家或地区等信息，并通过浏览器本地存储判断当天访客和 30 分钟访问间隔。服务端还会根据 User-Agent 做基础的机器人过滤。

如果我们有多个网站，可以给每个站点设置不同的 website-id。仪表板会自动列出已有数据的站点，也支持搜索和固定常看的站点。

这里最适合的场景，不是做精细的用户画像，而是快速回答几个运营问题：哪篇文章带来访问、流量从哪里来、读者主要用什么设备、这几天的趋势有没有变化。

04 真正部署时，有两项安全设置别省

Iris Analytics 的基础部署并不复杂，但它不是点一下就完事。

我们需要准备 Cloudflare Account ID，创建一个具有“账户分析读取”权限的 API Token，再建立 Analytics Engine 数据集，并把变量名绑定为 AnalyticsBinding、数据集名设为 AnalyticsDataset。

然后在 Cloudflare Pages 中设置环境变量、绑定 Analytics Engine，重新部署项目。

这里有两个容易被忽略的配置。

一个是仪表板密码。CLOUDFLARE_WEBSITE_PWD 默认可以留空，意味着别人只要知道地址，就可以看到统计相关数据了。正式使用时建议设置密码哦。

设置密码后，访问统计页面会先经过这层登录验证。

另一个是网站白名单。默认情况下，上报接口是公开的，其他网站也可能向同一个数据集发送内容。配置 CLOUDFLARE_WEBSITE_WHITELIST 后，系统会同时核对网站标识和域名，减少数据被污染的风险。

这两项都不是可有可无的美化设置。一个保护看板，一个保护数据源，部署时顺手配好最省事。

05 它很轻，但边界也很明确

Iris Analytics 更像一个够用的网站流量仪表板，不是完整的数字营销平台。

它目前没有转化漏斗、用户分群、事件分析、A/B 测试和复杂归因，也不适合替代原始访问日志。项目会保存完整 User-Agent、页面路径和外部来源，网站运营者仍需根据自己的地区、业务和隐私政策，判断是否需要告知访问者以及如何合规使用。

还有一个容易被忽略的限制：Cloudflare Analytics Engine 的数据默认只保留 3 个月。它也会在高数据量或复杂查询时采用自适应采样。因此，这套工具适合看整体趋势和分布，不适合拿来追查某一条访问记录，也不适合直接做跨年度分析。Cloudflare 的限制文档和采样说明写得很清楚。

所以我们会这样选：

• 已经在用 Cloudflare，想给个人博客或小产品加一块轻量看板，可以试。
• 不想维护服务器和数据库，只关心基础流量趋势，很合适。
• 需要长期留存、复杂事件模型、精细用户路径或合规套件，换成熟的专业方案更省时间。

Iris Analytics 的价值，不是把网站分析做得无所不能。

它只是把个人站长最常看的那部分数据，收进了一套自己能部署、能查看、也能继续修改的 Cloudflare 工作流里。需求刚好落在这里，这个项目就很顺手。

项目地址：rowink/IrisAnalytics