跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

Range 请求行为

最后更新 查看 MarkdownAgent 设置

Cloudflare 可以从完整或部分缓存文件中提供 HTTP range 请求。Origin Range Requests 让 Cloudflare 以与缓存对齐的字节范围从源站获取符合条件的文件。

请求资格

Cloudflare 仅对到达时符合缓存条件的 GET 请求使用部分文件路径。源站响应稍后可能被证明不可缓存。在这种情况下,Cloudflare 仍可以使用源站 range 获取,但不会存储响应字节。

HEAD 请求和其他方法不使用此路径。

HEAD 请求

包含 Range 的 HEAD 请求可以返回 200 OK、206 Partial Content、304 Not Modified 或 416 Range Not Satisfiable。HEAD 响应永远没有正文。206 Partial Content 响应包含 Content-Range。当 Cloudflare 在不使用 Origin Range Requests 的情况下提供完整缓存文件时,匹配的 If-Range 验证器可以保留 206 Partial Content 响应,而不匹配则返回 200 OK。Cloudflare 会忽略其他 HEAD 请求路径上的 If-Range。

客户端响应行为

不含 Range 的请求

成功的、无条件且不含 Range 的 GET 会以 200 OK 返回完整文件。在冷缓存未命中时,第一次源站请求也会省略 Range。

如果只缓存了文件的一部分,Cloudflare 可能会向源站请求缺失的字节。客户端仍会收到一个完整的 200 OK 响应。

一个有效 range

以下请求在成功时返回 206 Partial Content:

  • Range: bytes=100-199
  • Range: bytes=100-
  • Range: bytes=-100

如果结束位置超出文件大小,Cloudflare 会将其缩短。大于文件的后缀 range 会以 206 Partial Content 返回完整文件。

无法满足的 range

Cloudflare 会在以下情况下返回 416 Range Not Satisfiable:

  • 空 range,例如 bytes=
  • 零长度后缀,例如 bytes=-0
  • 反转的 range 边界
  • 起始位置位于文件末尾或之后的 range
  • 针对空的未压缩文件的 range
  • 在 Origin Range Requests 适用时出现重叠或乱序的 range

由 Cloudflare 生成的 416 Range Not Satisfiable 响应正文为空。它包含 Content-Range: bytes */<FILE_SIZE>。

当 Cloudflare 在不使用 Origin Range Requests 的情况下提供完整缓存文件时,它会忽略重叠或乱序的 range,通常以 200 OK 返回完整文件。

被忽略的 Range 标头

在以下情况下,Cloudflare 会将请求作为非 range 请求处理:

  • range 语法无法解析
  • range 单位不是 bytes
  • 数字过大而无法解析
  • 标头包含超过 300 个 range,或在 Cloudflare 不使用 Origin Range Requests 而提供完整缓存文件时恰好包含 300 个 range

这通常会以 200 OK 返回完整文件。条件请求可以返回 304 Not Modified,源站错误仍然适用。

多个 range

当 Origin Range Requests 适用时,2 到 300 个有效、升序且不重叠的 range 会返回 multipart 206 Partial Content 响应。Cloudflare 会省略无法满足的单个 range。如果只剩下一个 range,响应仍为 multipart。如果没有剩余 range,Cloudflare 会返回 416 Range Not Satisfiable。

当 Cloudflare 在不使用 Origin Range Requests 的情况下提供完整缓存文件时,剩下的一个可满足 range 会产生单 range 的 206 Partial Content 响应。

条件请求

If-None-Match 和 If-Modified-Since 优先于 Range。它们可以产生 304 Not Modified 响应。

否则,与缓存的 ETag 或 Last-Modified 值精确匹配的 If-Range 值会保留 range 行为。不匹配会导致 Cloudflare 忽略 Range 并使用完整响应路径。

解压

如果 Cloudflare 必须解压完整的已编码响应,它会忽略 Range。Cloudflare 会以 200 OK 发送完整的未压缩正文。这适用于缓存响应以及从源站收到的响应。

针对空的已编码响应的 range 请求会返回空的 200 OK,而不是 416 Range Not Satisfiable。

源站请求行为

Cloudflare 会将源站 range 请求对齐到 1 MiB 缓存边界。例如,如果客户端请求 1 KiB 的 range,Cloudflare 可能从源站获取 1 MiB 的 range,并仅将所请求的 1 KiB 返回给客户端。Cloudflare 也可能将一个客户端请求拆分为多个单 range 源站请求。源站看到的 Range 值可能与客户端标头不同。在配置源站日志、请求限制、速率限制或请求签名时,请考虑此行为。

Cloudflare 会向 Origin Range Requests 生成的每个源站请求添加 Accept-Encoding: identity。这包括由该功能处理的完整文件 GET。它不会禁用 Cloudflare 与客户端之间的正常压缩。

部分响应要求

要使 Cloudflare 缓存源站的 206 Partial Content 响应,该响应必须满足以下要求:

响应字段 要求
Content-Encoding 响应必须未编码。
Content-Range 包含具体 range。其起始必须与 Cloudflare 的请求匹配。其结束必须与所请求的结束或文件末尾(以先到者为准)匹配。包含完整文件大小。
Content-Length 包含等于所返回区间长度的数值。
Transfer-Encoding 省略此标头。
ETag 可选。如果存在,其存在性及精确值必须在同一缓存表示的各响应中保持一致。

完整文件大小也必须在各响应之间保持一致。违反这些要求可能会阻止缓存,或导致提前结束提供给客户端的响应。

不遵循 Range 的源站响应

如果源站忽略 Cloudflare 生成的 Range 标头并返回完整的 200 OK,Cloudflare 可以使用该响应。Cloudflare 必须下载完整文件,然后可能会将所请求的 range 返回给客户端。

如果源站返回已编码的 206 Partial Content 响应,Cloudflare 不会缓存它。在客户端响应开始之前,Cloudflare 可以发送该单个响应而不缓存。响应开始后,Cloudflare 会提前结束它,客户端收到的字节会少于承诺数量。

在由多个请求组装的响应过程中,其他不兼容的源站响应也可能提前结束客户端响应。

缓存限制

Origin Range Requests 不会使原本不符合条件的请求或响应变为可缓存。Cloudflare 会根据 Content-Range 中的完整大小检查最大可缓存文件大小。请求较小的 range 不会绕过此限制。

Origin Range Requests 不支持与 Cache Reserve 一起使用。

这篇文档对您有帮助吗?