Cloudflare 可以从完整或部分缓存文件中提供 HTTP range 请求。Origin Range Requests 让 Cloudflare 以与缓存对齐的字节范围从源站获取符合条件的文件。
Cloudflare 仅对到达时符合缓存条件的 GET 请求使用部分文件路径。源站响应稍后可能被证明不可缓存。在这种情况下,Cloudflare 仍可以使用源站 range 获取,但不会存储响应字节。
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 的 GET 会以 200 OK 返回完整文件。在冷缓存未命中时,第一次源站请求也会省略 Range。
如果只缓存了文件的一部分,Cloudflare 可能会向源站请求缺失的字节。客户端仍会收到一个完整的 200 OK 响应。
以下请求在成功时返回 206 Partial Content:
Range: bytes=100-199Range: bytes=100-Range: bytes=-100
如果结束位置超出文件大小,Cloudflare 会将其缩短。大于文件的后缀 range 会以 206 Partial Content 返回完整文件。
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 返回完整文件。
在以下情况下,Cloudflare 会将请求作为非 range 请求处理:
- range 语法无法解析
- range 单位不是
bytes - 数字过大而无法解析
- 标头包含超过 300 个 range,或在 Cloudflare 不使用 Origin Range Requests 而提供完整缓存文件时恰好包含 300 个 range
这通常会以 200 OK 返回完整文件。条件请求可以返回 304 Not Modified,源站错误仍然适用。
当 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 |
可选。如果存在,其存在性及精确值必须在同一缓存表示的各响应中保持一致。 |
完整文件大小也必须在各响应之间保持一致。违反这些要求可能会阻止缓存,或导致提前结束提供给客户端的响应。
如果源站忽略 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 一起使用。