4.9 KiB
项目统计与页面缓存
后台「设置 → 数据统计」只查询两个配置域名的访问流量：
- 博客：
CF_DOMAIN。 - R2 附件：后台保存的
r2.public_domain。文章中引用的外链图片不纳入统计。
流量查询使用 httpRequestsAdaptiveGroups，按 hostname 筛选且只包含 requestSource: eyeball。CDN 请求命中率明确计算为 HIT / 总请求数，包含该域名的后台及 API 请求，并另外列出其数量和各缓存状态。它不代表适配器内部 Cache API 的命中率，也不代表 D1 查询比例。旧的全 Zone PV、按日 UV 累加不再用于项目指标。
查询优先使用最近 30 天；仅当 API 返回时间范围限制或结果达到分组上限时，尝试 7 天、1 天，并显示实际时段。权限不足、字段不支持或数据不完整时显示「统计不可用」，不回退到全 Zone 流量，不将错误当作零流量。
统计需要部署环境中的 CF_API_TOKEN、CF_ZONE_ID，Token 需要对应 Zone 的 Analytics 读取权限。两个域名应属于所配置的 Zone；附件域名若属于另一 Zone，可额外配置 CF_ASSETS_ZONE_ID，并授予该 Zone 的读取权限。D1 和 R2 资源统计仍分别使用 CF_ACCOUNT_ID、CF_D1_ID、CF_R2_BUCKET。
页面浏览与访问次数
页面趋势来自 Cloudflare Web Analytics（RUM），与上方 CDN 请求统计分开。基本设置中填写统计脚本里的 token（site_token），不要填写 site_tag，因为该设置同时用于浏览器采集脚本。
后台通过 /accounts/{account_id}/rum/site_info/list 分页解析对应的 site_tag，再查询 rumPageloadEventsAdaptiveGroups。除 CF_ACCOUNT_ID 外，CF_API_TOKEN 需要该账户的 Account Settings Read（读取站点列表）和 Account Analytics Read（查询统计）权限。解析失败、权限不足或找不到站点时明确显示错误，不将采集 Token 当作 Site Tag 继续查询；查询成功但无记录时显示「暂无数据」。
趋势按 UTC 日期统计，包含今天，共 30 个日期；最近 7 天同样包含今天。PV 使用 count，访问次数使用 sum.visits，Visits 不代表去重访客人数。已有记录的日期范围内，缺失日期补零；完全没有记录时不生成全零曲线。
缓存策略与更新
复用 @sveltejs/adapter-cloudflare 自带的 Cache API，通过服务端 hook 统一设置公开 HTML 的响应头：
| 内容 | 浏览器 max-age | 边缘 s-maxage |
|---|---|---|
| 首页、归档、分类、标签、系列列表 | 0 | 300 秒 |
| 文章详情、独立页面 | 0 | 3600 秒 |
后台、API、客户端导航 __data.json、错误响应 |
不缓存 | 不缓存 |
公开页面的查询参数完整保留，分页内容不共用缓存键；客户端导航数据实时读取，不缓存可能包含加载错误或部分节点的数据。预览域名不会启用公开页面缓存。构建生成的哈希静态资源维持适配器原有策略。
公开 HTML 带有 blogflare-public:<博客 hostname> 缓存标签。后台及 API 的内容写入完成后，统一调用 Cloudflare 按标签清理，覆盖旧、新 URL、分页及列表关联；每次修改会失效本博客的所有已标记公开页面，静态附件不受影响。Token 还需要该 Zone 的 Cache Purge 权限。清理请求同步等待（10 秒超时）；失败不撤销已经保存的内容，会记录日志及 cache.purge_error，并在设置页显示警告。清理失败时列表、详情分别以 5 分钟、1 小时 TTL 兜底。
Cloudflare 按标签清理存在限流，批量写入时应留意后台警告。API 返回成功表示接受清理请求，实际全球失效及并发旧请求的影响仍需线上验证。
部署流水线改用 scripts/purge-blog-cache.mjs，只清理 wrangler.jsonc 中 CF_DOMAIN 的 hostname，且检查 HTTP 状态和响应的 success。它同时移除升级前未带标签的旧页面及旧 __data.json 缓存。第一次上线必须完成这一清理步骤；手动部署时也应在设置 CLOUDFLARE_API_TOKEN、CLOUDFLARE_ZONE_ID 后执行该脚本。不会清空整个 Zone 或清理其他图片域名。
上线验收
- 确认统计面板分别显示配置的博客和附件 hostname；不足 30 天或不可用时显示真实原因。
- 同一节点重复读取公开 HTML，结合
Age、Workers 日志及 D1 读取量验证内部缓存；不能只看外层CF-Cache-Status。 - 修改文章内容和 slug，检查直接访问、站内导航、旧地址及分类/标签分页；删除文章和修改站点信息也应失效。
- 确认后台、API 和
__data.json均返回no-store，图片仍正常命中。 - 核对部署清理只作用于博客域名。不要把 CDN 综合命中率作为唯一验收标准。