Cloudflare正式支持HTTP Vary头
My comment on We just shipped support for the ugliest part of HTTP: Vary — Hacker News. I've been wanting this from Cloudflare for years . \n The classic problem here is if yo
ガイド一覧 · 本文は主に簡体字中国語です。国際向けの要点は English summary をご利用ください。
Cloudflare正式支持HTTP Vary头
Cloudflare 正式在所有计划下推出 Vary 头支持。这是 HTTP 协议中被长期忽视的机制。那些使用 Accept、Accept-Language 或 Accept-Encoding 做内容协商的站点，现在无需绕过缓存就能确保浏览器和 API 客户端拿到正确的响应。谁需要它？AI 价格雷达、模型 API 切换工具和订阅路径管理类站点，在高并发 API 调用时，它能直接提升缓存命中率，减少对上游的压力。怎么决策？检查你的接口是否已返回 Vary 头，再在 Cache Rules 中选择 normalize（推荐入门）、passthrough 或 bypass 三种行为之一。
Cloudflare Vary 支持的核心价值
Vary 头的作用是告诉中间缓存（Cloudflare），同一个 URL 可以返回多个有效内容。经典场景是浏览器请求 HTML，API 客户端请求 JSON。
GET /catalog HTTP/1.1
Host: example.com
Accept: text/html
原始服务器返回 HTML，并声明 Vary: Accept。另一个请求用 Accept: application/json，缓存会根据 Accept 值区分不同变体，避免混淆。
之前，Cloudflare 对 Vary 的支持有限（尤其非图片场景），容易导致缓存命中错误。2026 年 9 月 22 日官方博客正式上线新功能，客户无需额外代码即可管理。
如何在 Cache Rules 中配置 Vary
打开 /cache > Cache Rules，为规则添加 Vary 设置。优先选择 normalize 作为默认行为，对 Accept、Accept-Language、Accept-Encoding 等协商头进行标准化处理，让等效请求共享缓存。
配置示例表
| 头名称 | 默认行为 | 适用场景 | 推荐理由 |
|---|---|---|---|
| Accept | normalize | 内容类型协商 | 大量请求值映射到有限响应，共享缓存 |
| Accept-Language | normalize | 多语言内容 | 语言标签差异不影响最终内容 |
| Accept-Encoding | normalize | 压缩方案 | 常见场景，减少变体数量 |
| Cookie / User-Agent | bypass | 个性化或高基数头 | 避免碎片化缓存 |
| Vary: * | bypass | 任意请求字段可能变化 | 总是回源，不缓存 |
使用 normalize 时，Cloudflare 会规范化请求头值后匹配缓存；passthrough 则严格保留原始字节用于匹配；bypass 则不存储响应。你可以为每个头单独设置，也用默认行为覆盖未列出的。
实际走法：从配置到缓存命中
1. 确保原始服务器在响应中正确返回 Vary: Accept, Accept-Language 等头（包括错误响应）。
2. 创建 Cache Rule，匹配你的域名和 URL 模式。
3. 在规则中开启 Vary 支持，设置上述行为。
4. 发布后，测试：用不同 Accept 值发起请求，观察缓存键是否正确区分。
完整说明请参考 /guides 中的 Cache Rules 文档。
延伸阅读
风险与边界
代理服务（包括 Cloudflare）有自己的实现边界。使用时请以官方文档和站点当日数据为准，未必实时同步。非法律意见，仅供参考。