此页面由 Cloud Translation API 翻译。

配置缓存行为

媒体 CDN 使用 Google 覆盖全球的边缘缓存基础架构，源基础架构

您可以控制每个路由的内容缓存方式。这样，您就可以基于内容类型、客户端请求属性和您的新鲜度要求

可缓存性

以下部分介绍了媒体 CDN 缓存的响应以及如何改进缓存分流。

默认缓存行为

默认情况下，以下与缓存相关的设置适用于每个边缘缓存服务：

CACHE_ALL_STATIC 的默认缓存模式：
- 遵循源缓存指令，例如 Cache-Control 或 Expires，最长可配置的最大 TTL。
- 使用指定的 API 自动缓存静态媒体类型如果没有源缓存指令，则默认 TTL 为 3600 秒。
- 缓存 HTTP 200 和 206 状态代码（负缓存未启用）。
不缓存具有 no-store 或 private cache-control 的响应指令或无法缓存的内容。

响应不是静态内容或缺少有效缓存指令不会缓存。如需了解如何替换请参阅有关缓存模式的文档。

默认行为等效于以下 cdnPolicy。不包含以下查询的路线：配置的显式 cdnPolicy 的行为类似于具有以下特征配置：

cdnPolicy:
  cacheMode: CACHE_ALL_STATIC
  defaultTtl: 3600s
  cacheKeyPolicy:
    includeProtocol: false
    excludeHost: false
    excludeQueryString: false
  signedRequestMode: DISABLED
  negativeCaching: false

可缓存的响应

可缓存的响应是媒体 CDN 可以存储的 HTTP 响应从而缩短加载时间并非所有 HTTP 请求可缓存的响应。

您可以为每个路由配置缓存模式以覆盖此设置行为（例如，使用 CACHE_ALL_STATIC 缓存模式缓存常见则即使源未设置缓存控制指令。

符合不可缓存的响应会取代可缓存性。

下表介绍了缓存特定 HTTP 的要求响应。GET 和 HEAD 响应都必须遵循这些要求。

HTTP 属性	要求
状态代码	响应状态代码必须是 200、203、206、300、301、302、 307、308、400、403、404、405、410、451、500、501、502、503 或 504。
HTTP 方法	`GET` 和 `HEAD`
请求标头	系统会忽略大多数缓存请求指令。如需了解详情，请参阅缓存控制指令。
响应标头	包含有效的 HTTP 缓存指令，例如 `Cache-Control: max-age=3600, public`。具有缓存相应内容的缓存模式，或具有 `Expires` 标头，其中包含一个将来的日期。
响应大小	最多 100 GiB。

HTTP Age 标头已设置基于媒体 CDN 首次缓存响应的时间，表示自对象以源站防护位置。如果您的源生成 Age 响应标头，请使用 FORCE_CACHE_ALL 缓存模式防止在存在时间超过缓存 TTL 时重新验证。

如需详细了解媒体 CDN 如何解读 HTTP 缓存指令，请参阅缓存控制指令。

源要求

要让媒体 CDN 能够缓存超过 1 MiB，则源必须在针对 HEAD 和 GET 请求（除非另有说明）：

Last-Modified 或 ETag HTTP 响应标头（验证器）。
有效的 HTTP Date 标头。
有效的 Content-Length 标头。
Content-Range 响应标头，用于响应 Range GET 请求。 Content-Range 标头必须具有采用 bytes x-y/z 形式的有效值（其中 z 是对象大小）。

默认源协议为 HTTP/2。如果您的源仅支持 HTTP/1.1 则可以为每个源明确设置协议字段。

无法缓存的响应

下表详细说明了阻止响应的缓存。可缓存但匹配的响应 “uncacheable”条件不会被缓存。

HTTP 属性	要求
状态代码	未定义为可缓存的状态代码，例如 HTTP 401， HTTP 412 或 HTTP 505。这些状态代码通常代表客户所遇到的问题而非源状态缓存这些响应会导致“缓存内容” 投毒”用户触发的“不良”事件响应被缓存所有用户。
请求标头	对于包含 `Authorization` 请求的请求标头，响应必须包含 `public` Cache-Control 指令。请求中的 `no-store` 指令会导致响应不要缓存。如需了解详情，请参阅缓存控制指令。
响应标头	具有 `Set-Cookie` 标头。具有除 `Accept` 以外的 `Vary` 标头， `Accept-Encoding`、`Origin`、 `X-Origin`、`X-Goog-Allowed-Resources`、 `Sec-Fetch-Dest`、`Sec-Fetch-Mode` 或 `Sec-Fetch-Site`。 `CACHE_ALL_STATIC` 或 `USE_ORIGIN_HEADERS` 模式，具有 `no-store` 或 `private` 缓存控制指令。
响应大小	大于 100 GiB。

这些规则除了已配置的缓存模式之外，还适用。具体而言：

配置 CACHE_ALL_STATIC 缓存模式后，只有视为静态内容或响应标头中的有效缓存指令缓存。其他响应会按原样代理。
FORCE_CACHE_ALL 缓存模式会无条件缓存所有响应，但需要遵循前面所述的不可缓存性要求。
USE_ORIGIN_HEADERS 缓存模式需要设置响应有效缓存指令而不仅仅是作为可缓存的状态代码

注意：

未缓存的响应没有其缓存控制指令，或者其他标头会发生更改，并按原样代理。
响应的 Cache-Control 和 Expires 标头可以收起转换为单个 Cache-Control 字段。例如，包含 Cache-Control: public和Cache-Control: max-age=100位于不同的行中将收起为 Cache-Control: public,max-age=100。
不会计入不可缓存的响应（永远不会被缓存的响应）从结算角度看为 Cache Egress。

使用缓存模式

通过缓存模式，您可以配置媒体 CDN 在什么情况下应遵守源缓存指令、缓存静态媒体类型以及缓存所有响应而不受该来源的制约。

缓存模式在路由级别配置，与 TTL 替换项结合使用。您可以按主机、路径、查询参数和标头（任何可匹配的请求参数）。

默认情况下，媒体 CDN 使用 CACHE_ALL_STATIC 缓存模式，，它会将常见静态媒体类型自动缓存 1 小时（3600 秒），同时优先处理由源站指定的所有缓存指令（针对可缓存的响应）。
您可以增加或减少应用于没有通过设置max-ages-maxage cdnPolicy.defaultTtl 字段。
为了防止缓存不成功响应的时间超出预期，非 2xx（不成功）状态代码不会根据其 Content-Type（MIME 类型）且没有默认 TTL 。

可用的缓存模式，在各模式的 cdnPolicy.cacheMode 上设置如下表所示。

缓存模式	行为
`USE_ORIGIN_HEADERS`	要求源站响应设置有效的缓存指令和有效缓存标头。如需查看完整的要求列表，请参阅可缓存的响应。
`CACHE_ALL_STATIC`	自动缓存包含静态内容的成功响应，除非他们具有`no-store`或`private` 指令。系统会优先使用来自源站的有效缓存指令。静态内容包括视频、音频、图片和常见的网络资产，由 `Content-Type` 响应中的 MIME 类型定义标头。
`FORCE_CACHE_ALL`	无条件缓存成功的响应，替换所有缓存由源站设置的指令请勿为每个用户投放非公开内容（例如动态 HTML）或 API 响应）。
BYPASS_CACHE	与配置了此缓存模式的路由匹配的任何请求都会绕过即使存在与该缓存键匹配的已缓存对象也是如此。由于媒体 CDN 支持媒体 CDN，因此我们建议仅将其用于调试设计为全球级缓存基础设施，而非通用代理。

静态内容 MIME 类型

CACHE_ALL_STATIC 缓存模式允许媒体 CDN 执行以下操作：自动缓存常见的静态内容，例如视频、音频、图片和基于 Content-Type HTTP 中返回的 MIME 类型的通用 Web 资源响应标头。不过，无论媒体类型如何会优先处理源站中的任何显式 Cache-Control 或 Expires 标头响应。

下表列出了可以自动缓存的 MIME 类型 CACHE_ALL_STATIC 缓存模式。

如果响应没有 Content-Type，则系统不会自动缓存响应具有与以下值匹配的值的响应标头。您必须确保该响应设置了有效的缓存指令，或者您必须使用 FORCE_CACHE_ALL 缓存模式无条件缓存响应。

类别	MIME 类型
Web 资源	text/css text/ecmascript text/javascript application/javascript
字体	任何与“font/*”匹配的内容类型
图片	任何与“image/*”匹配的内容类型
视频	任何与“video/*”匹配的内容类型
音频	任何与“audio/*”匹配的内容类型
格式化文档类型	application/pdf and application/postscript

请注意以下几点：

源站的 Web 服务器软件必须为以下项设置 Content-Type：。许多网络服务器会自动设置 Content-Type 标头，包括 NGINX、Varnish 和 Apache。
Cloud Storage 设置 Content-Type 标头如果您使用 Google Cloud 控制台或 gsutil 工具上传内容。
如果响应可根据其 MIME 类型进行缓存，但具有 private 的 Cache-Control 响应指令或 no-store 或 Set-Cookie 标头，则不会缓存。

配置缓存 TTL

借助存留时间 (TTL) 覆盖，您可以为缓存内容设置默认 TTL 值并替换 max-age 和 s-maxage 缓存控件中设置的 TTL 值指令（或 Expires 标头）。

无论是通过替换设置还是使用缓存指令设置 TTL，乐观态度。很少访问或不受欢迎的内容可能会被从在达到 TTL 之前刷新缓存。

下表显示了三项 TTL 设置。

设置默认最小值最大值说明适用的缓存模式

设置	默认	最大值	说明	适用的缓存模式
Default TTL	1 小时（3600 秒）	1 年（31536000 秒）	当源站未指定 `max-age` 时设置的 TTL 或 `s-maxage` 标头。如果源站指定了 `s-maxage` 标头，则改用该标头默认 TTL 值。使用 `FORCE_CACHE_ALL` 无条件缓存所有数据时则使用默认 TTL 来设置缓存 TTL。所有其他值和指令会被忽略。	`CACHE_ALL_STATIC` `FORCE_CACHE_ALL`
Max TTL	1 天（86400 秒）	1 年（31536000 秒）	对于可缓存的响应，允许的最大 TTL。值大于上限为 `maxTtl`。	`CACHE_ALL_STATIC`
Client TTL	默认情况下未设置。	1 天（86400 秒）	对于可缓存响应，允许下游用于的最大 TTL （面向客户端）响应（如果需要不同于其他 TTL）值。	`CACHE_ALL_STATIC` `FORCE_CACHE_ALL`

Default TTL

1 小时
（3600 秒）

0 秒

1 年
（31536000 秒）

当源站未指定 max-age 时设置的 TTL 或 s-maxage 标头。

如果源站指定了 s-maxage 标头，则改用该标头默认 TTL 值。

使用 FORCE_CACHE_ALL 无条件缓存所有数据时则使用默认 TTL 来设置缓存 TTL。所有其他值和指令会被忽略。

CACHE_ALL_STATIC

FORCE_CACHE_ALL

Max TTL 1 天
（86400 秒） 0 秒 1 年
（31536000 秒）对于可缓存的响应，允许的最大 TTL。值大于上限为 maxTtl。 CACHE_ALL_STATIC

Client TTL

默认情况下未设置。

0 秒

1 天
（86400 秒）

对于可缓存响应，允许下游用于的最大 TTL （面向客户端）响应（如果需要不同于其他 TTL）值。

CACHE_ALL_STATIC

FORCE_CACHE_ALL

将任何 TTL 值设置为零（0 秒）会导致每个请求被重新验证在系统发出响应之前与源站共享数据，如果存在以下情况，则会增加源站的负载：过于宽泛

当缓存模式设为 Use Origin Headers 时，无法设置 TTL 设置配置，因为媒体 CDN 依赖源站来驱动行为

注意：

最大 TTL 的值必须始终大于（或等于）默认 TTL。
客户端 TTL 的值必须始终小于（或等于）该值 TTL 上限。
当媒体 CDN 替换源 TTL 值时， Cache-Control 标头也会反映该值。
如果源站设置了 Expires 标头和媒体 CDN 会替换有效 TTL（基于时间戳）、Expires 标头在下游响应中被替换为 Cache-Control 标头，客户端。

负缓存

负缓存定义了非成功 HTTP 状态代码（由媒体 CDN 缓存。

这样，您就可以缓存错误响应，例如重定向（HTTP 301 和 308）和未找到 (HTTP 404) 响应，并减少以扩大响应的负载。

默认情况下，负缓存处于停用状态。下表显示了每个状态代码的值未使用 negativeCachingPolicy。

状态代码	原因短语	TTL
HTTP 300	Multiple Choices	10 分钟
HTTP 301 和 HTTP 308	Permanent Redirect	10 分钟
HTTP 404	未找到	120 秒
HTTP 405	找不到方法	60 秒
HTTP 410	Gone	120 秒
HTTP 451	因法律原因而无法使用	120 秒
HTTP 501	Not Implemented	60 秒

默认的负缓存代码集与启发式可缓存的请参阅 HTTP RFC 9110、但以下情况除外：

不支持使用 HTTP 代码 414（URI 过长）进行缓存，以避免缓存投毒
缓存支持 HTTP 451（法律原因不可用），因为具体说明 HTTP RFC 7725。

如果您需要自行为每个状态代码配置 TTL，并覆盖默认值您可以配置一个 cdnPolicy.negativeCachingPolicy。这样，您就可以为媒体 CDN 允许的任何状态代码设置 TTL： 300、301、302、307、308、400、403、404、405、410、451、500、501、502、503 和 504。

例如，要为 HTTP 404（未找到）响应设置 5 秒的较短 TTL，请执行以下操作：并将 HTTP 405（不允许方法）响应的 TTL 设置为 10 秒，请使用并遵循 YAML 定义：

cdnPolicy:
  negativeCaching: true
  negativeCachingPolicy:
    "404": 5s
    "405": 10s
  # other status codes to apply TTLs for

为防止缓存中毒，我们不建议对二者都启用缓存状态代码 400（请求无效）或 403（禁止访问）。请确保您的源服务器通过仅检查请求的组成部分返回任一代码包含在缓存键中。例如，当如果没有正确的数据，源服务器会返回 403 错误响应 Authorization 标头。在这种情况下，缓存 403 错误响应会导致媒体 CDN 向所有后续直到 TTL 到期，即使这些请求具有正确的 Authorization 标头。

如需停用负缓存，请执行以下操作：

如需停用默认的负缓存行为，请将路线上的 cdnPolicy.negativeCaching: false。请注意，源响应具有有效缓存指令和可缓存状态代码仍将缓存。
可以防止对特定状态代码进行负缓存，但仍保留源缓存指令，请忽略状态代码（cdnPolicy.negativeCachingPolicy[].code）位于您的“negativeCachingPolicy”中定义。
若要针对特定状态明确忽略源缓存指令代码，如果是这样，请将 cdnPolicy.negativeCachingPolicy[].ttl 设置为 0（零）状态代码。

注意：

如果对路线启用了 negativeCaching，并且响应定义了有效缓存指令、响应。
如果您配置了显式 negativeCachingPolicy，并且存在 TTL 则政策中定义的 TTL 始终为。
由 negativeCachingPolicy 设置的 TTL 最大值为 1800 秒（30 分钟），但系统将遵循 TTL 较高的源缓存指令。
如果缓存模式配置为 FORCE_CACHE_ALL，源站指令在任何情况下都会被忽略。

缓存控制指令

媒体 CDN 的行为： Cache-Control 指令此处定义了

如果该指令不适用于请求或响应（例如 only-if-cached（仅限客户端的指令），然后按“N/A”标记。

指令	请求	响应
`no-cache`	`no-cache` 请求指令会被忽略，以防客户端可能会启动或强制对源进行重新验证	包含 `no-cache` 的响应已缓存，但需要通过源进行验证，然后才能投放。可以使用 `FORCE_CACHE_ALL` 缓存模式。
`no-store`	使用 `no-store` 的请求不会缓存对请求的响应。	系统不会缓存包含 `no-store` 的响应。可以使用 `FORCE_CACHE_ALL` 缓存模式。
`public`	不适用	如果存在 `public` 指令，则系统将缓存该响应，响应被视为可作为整体缓存，并且具有 `max-age` 或 `s-maxage` 指令，。使用 `CACHE_ALL_STATIC` 缓存或 `FORCE_CACHE_ALL` 模式，则不需要。
`private`	不适用	包含 `private` 指令的响应不会被媒体 CDN，即使该响应被视为可缓存。客户端（例如浏览器）可能仍会缓存结果。可以使用 `FORCE_CACHE_ALL` 缓存模式。使用 `no-store` 可阻止所有响应缓存。
`max-age=SECONDS`	max-age 请求指令会被忽略。缓存的响应是指就返回了该标头，就像请求中未包含此标头一样。	包含 `max-age` 指令的响应缓存最高定义的 `SECONDS`。
`s-maxage=SECONDS`	不适用	包含 `s-maxage` 指令的响应缓存最高定义的 `SECONDS`。如果同时存在 `max-age` 和 `s-maxage`， `s-maxage` 由服务器使用。请注意，`s-max-age`（两个连字符）无效：用于缓存目的
`min-fresh=SECONDS`	系统会忽略 `min-fresh` 请求指令。缓存的响应就会返回此标头，就像请求中未包含此标头一样。	不适用
`max-stale=SECONDS`	`max-stale` 请求指令会被忽略。系统会返回缓存的响应，就好像此标头未包含在请求。	不适用
`stale-while-revalidate=SECONDS`	不适用	无影响。此响应会传递给客户端。
`stale-if-error=SECONDS`	系统会忽略 `stale-if-error` 请求指令。缓存的则会返回此标头，就像请求中未包含此标头一样。	无影响。此响应会传递给客户端。
`must-revalidate`	不适用	使用 `must-revalidate` 重新验证的响应在源服务器过期后继续访问。
`proxy-revalidate`	不适用	包含 `proxy-revalidate` 的响应会使用源重新验证过期后的服务器。
`immutable`	不适用	无影响。此响应会传递给客户端。
`no-transform`	不适用	媒体 CDN 未应用任何转换。
`only-if-cached`	系统会忽略 `only-if-cached` 请求指令。缓存的则会返回此标头，就像请求中未包含此标头一样。	不适用

如果可能，媒体 CDN 符合 RFC 规范（HTTP RFC 7234），但偏向于优化缓存分流，并最大限度地减少客户端可能对命中率和总体来源负载

对于使用 HTTP/1.1 Expires 标头的响应：

Expires 标头的值必须是有效的 HTTP 日期，如下所示：在 RFC 7231 中定义
过去的日期值、无效日期或值 0 表示该内容已过期，需要重新验证。
如果 Cache-Control，媒体 CDN 会忽略 Expires 标头标头。

系统会忽略并传递 HTTP/1.0 Pragma 标头（如果存在响应）将其按原样传输给客户端

缓存键

您可以减少媒体 CDN 与考虑请求的唯一标识，并删除不同请求之间经常发生变化的组件。请求集组件通常被称为“缓存键”。

以下部分介绍了如何配置缓存键。

缓存键组成部分

缓存键是一组请求参数（例如主机、路径和查询参数）。

默认情况下，边缘缓存服务的缓存键包括请求主机、路径和查询参数，并且限定为 EdgeCacheService.

组件	是否默认包含？	详细信息
协议	否	通过 HTTP 和 HTTPS 发送请求会引用同一个缓存对象。如果您想向 http: 和 https: 请求返回不同的响应，将关联的 `cacheKeyPolicy.includeProtocol` 设置为 true 路由。
主机	是	不同的主机不会引用相同的缓存对象。如果您有多个主机名指向同一个 EdgeCacheService，并且投放相同的内容 `cdnPolicy.excludeHost` 设为 true。
路径	是	始终包含在缓存键中，无法删除。路径是缓存中对象的最小表示法。
查询参数	是	如果查询参数无法区分不同的响应，将 `cacheKeyPolicy.excludeQueryString` 设为 true。如果缓存键中只能包含一些查询参数，则将 `includedQueryParameters` 或 `excludedQueryParameters`（视情况而定）。
标头	否	将 `cacheKeyPolicy.includedHeaderNames` 设置为以下名称：要包含在缓存键中的标头。指定多个通过组合生成的值（例如，组合的标头值用于标识单个用户）显著降低缓存命中率可能会导致逐出率提高并性能降低。
Cookie	否	使用名称设置 `cacheKeyPolicy.includedCookieNames` 要添加到缓存键中的 Cookie 的数量。指定多个 Cookie，它们的值（例如，组合的 Cookie 值用于标识单个用户）显著降低缓存命中率可能会导致逐出率提高并性能降低。

请注意以下几点：

缓存键未附加到已配置的源站，因此您可以更新源配置（或完全替换源），不会出现“刷新”风险缓存（例如，在提供商之间迁移源存储时）。
缓存键受 EdgeCacheService 的限制。不同的 EdgeCacheService 设置不同的缓存命名空间，从而防止您不小心缓存了测试对象之间主机、路径或其他缓存关键组件将匹配。删除 EdgeCacheService 可有效地使服务。
缓存键的范围不限于单个路由。多个路由可能引用同一个缓存键，尤其是当这些路由与非例如请求标头或排除的参数。如果您希望多个路由共享同一缓存，返回不同的响应标头或 CORS 配置。
缓存键不包含网址重写配置。例如，缓存键基于而不是在最终的“重写”后请求。
在路由上配置签名请求时，签名属性会不包含在缓存键中。该请求将按照（已签名）查询参数或路径组成部分，以 edge-cache-token 开头和结尾的网址不属于网址的一部分。

包含或排除查询参数

您可以通过将特定查询参数包含在缓存键中或从中排除将参数名称设置为 includedQueryParameters 或 excludedQueryParameters 在给定路由上缓存键配置。

例如，若要添加 contentID 和 country 查询参数并忽略缓存键中的其他所有值：

cdnPolicy:
  cacheMode: CACHE_ALL_STATIC
  defaultTtl: 86400s
  cacheKeyPolicy:
    includedQueryParameters: ["contentID", "country"]

务必添加可唯一标识内容的查询参数，以及排除那些没有效果的关键字例如，排除分析查询参数播放会话 ID 或仅对客户端独有的其他参数。添加不必要的查询参数可能会降低缓存命中率。

或者，您也可以不指定要在缓存中包含的参数键，则可以选择要从缓存键中排除的参数。例如：从缓存中排除特定于客户端的播放 ID 和时间戳信息键，请配置以下内容：

cdnPolicy:
  cacheMode: CACHE_ALL_STATIC
  defaultTtl: 86400s
  cacheKeyPolicy:
    excludedQueryParameters: ["playback-id", "timestamp"]

对于给定路线，您可以指定 includedQueryParameters 或 excludedQueryParameters.

如果从不使用查询参数来跨请求唯一标识内容，您可以从路线的缓存键中删除所有查询参数。为此，将 excludeQueryString 设置为 true，如下所示：

cdnPolicy:
  cacheMode: CACHE_ALL_STATIC
  defaultTtl: 3600s
  cacheKeyPolicy:
    excludeQueryString: true

如果路由上启用了签名请求，用于签名的查询参数不包含在查询字符串中，如果包含，则会忽略。在缓存键中包含签名参数有效使每个用户请求具有唯一性，并要求每个请求从源站传送的内容。

查询参数排序

默认情况下，系统会对查询参数（查询字符串）进行排序以减少缓存命中因为客户端可能会重新排序或以其他方式请求相同的缓存费率对象具有不同的查询参数顺序。

例如，查询参数 b=world&a=hello&z=zulu&p=paris 和 “p=paris&a=hello&z=zulu&b=world”已按“a=hello&b=world&p=paris&z=zulu”排序在派生缓存键之前。这样，两个请求就可以映射到同一个缓存对象，从而避免对来源。

如果查询参数键有多个实例，且每个实例具有不同的参数会按完整值排序（例如，a=hello 是已排在 a=world 前面。无法停用排序功能。

包含标题

标头名称不区分大小写，并且按照媒体 CDN。

缓存键中不能包含以下标头：

以 access-control- 开头的任何标头
以 sec-fetch- 开头的任何标头
以 x-amz- 开头的任何标头
以 x-goog- 开头的任何标头
以 x-media-cdn- 开头的任何标头
accept-encoding
accept
authorization
cdn-loop
connection
content-md5
content-type
cookie
date
forwarded
from
host
if-match
if-modified-since
if-none-match
origin
proxy-authorization
range
referer
referrer
user-agent
want-digest
x-csrf-token
x-csrftoken
x-forwarded-for

要在缓存键中包含 HTTP 方法，请使用特殊标头名称 :method.

包含 Cookie

Cookie 名称区分大小写。

以 edge-cache- 开头（大写或小写的任何变体）的 Cookie 不得在缓存键中使用字母。

重新验证、逐出和到期

内容分发网络（包括媒体 CDN）由将最热门的内容缓存在尽可能靠近用户的位置。

媒体 CDN 的庞大存储空间，以及源站防护，限制执行逐出（即使是不热门）的需要内容。每天访问少量的内容最终会被逐出。

达到配置的 TTL 的缓存响应可能会立即被逐出对于热门内容，媒体 CDN 通过发出一个向源发出 HEAD 请求以确认标头是否已未更改。在某些情况下，使用以下任一或全部请求标头向源发送请求： If-None-Match和If-Modified-Since。在此示例中配置正确的源应返回 HTTP 304（未修改）响应，不包含正文字节（如果缓存的副本该响应。
设置 max-age 或 s-maxage 缓存的响应指令或使用TTL 替换，以指定较高的 TTL 值（例如 30 天）可能不会被存储在缓存中以完成 TTL。不保证即在缓存中存储对象的整个有效期特别是在访问频率较低的情况下。

如果您的逐出率很高，配置您的缓存键，以排除无法唯一标识响应。

其他注意事项

以下注意事项可能也适用于缓存。

`Vary` 标头

Vary 标头表明响应会根据客户端的请求标头。如果响应中存在 Vary 标头，媒体 CDN 不会对其进行缓存，除非标头指定其中一个标头被配置为缓存键设置或下列值之一：

Accept：用于指示客户端接受的媒体类型
Accept-Encoding：用于指示客户端的压缩类型接受
Available-Dictionary：用于提供用于压缩的字典
Origin/X-Origin：通常用于跨域资源共享
X-Goog-Allowed-Resources:：支持 Google Cloud 组织限制
Sec-Fetch-Dest/Sec-Fetch-Mode/Sec-Fetch-Site:：用于提取元数据请求标头

媒体 CDN 会通过以下方式缓存响应中具有 Vary 标头的响应：使用标头的值作为缓存键的一部分。如果 Vary 标头回答有多个值，这些值按字典顺序排序，缓存键是确定性的

媒体 CDN 可针对给定缓存键随机缓存多达 100 个变体从缓存中逐出超出该限制的变体。如果您明确指定使指定网址的缓存失效，或则所有变体都会失效。

绕过缓存

您可以刻意在路由上配置 BYPASS_CACHE 缓存模式，在匹配请求时绕过缓存如果您需要绕过缓存一小部分非关键流量，或调试源站连接。

如果您需要提供动态响应，例如 API 后端，建议配置外部应用负载平衡器。

建议您通常仅将它用于调试场景，以免发生意外的来源加载。绕过缓存时出站流量为按互联网出站流量费率计费。

缓存失效操作

请参阅缓存失效操作。

字节范围请求

媒体 CDN 支持单部分 HTTP 范围请求如 RFC 7233。

此外，媒体 CDN 还使用范围请求从源站提取更大的响应。这样，媒体 CDN 就可以分别对区块进行缓存，且不需要提取整个对象缓存一次

系统会以字节范围请求（“区块”）的形式提取大于 1 MiB 的对象，每个请求不超过 2 MiB。
在不支持字节的情况下，可以提取高达 1 MiB 的响应范围。
如果以下元素中不支持此字节范围，则系统不会提供大于此值的响应来源。

字节范围请求的来源支持取决于以下因素：

HTTP 状态代码 200（成功）或 206（部分内容）。
有效的 Content-Length 或 Content-Range 响应标头。
响应验证程序（ETag 或 Last-Modified）。

针对每个“分块”发出单独的来源填充请求（字节范围）记录为多个互不关联的日志条目，并与其父级客户端请求相关联。您可以通过“匹配请求” jsonPayload.cacheKeyFingerprint.

有关所记录内容的详情，请参阅 Cloud Logging 文档。

开放式范围请求

媒体 CDN 支持“开放式”Range 请求（例如，带有 Range: bytes=0- 的请求），使请求保持针对源的开放状态直到响应被源站关闭（例如，源站会写入所有字节）或超时。

开放式字节范围通常用于请求 Apple 的低延迟 HLS 片段：当每个 CMAF 数据块写入线路时，CDN 可以缓存并提供给客户端

在其他情况下，例如当不需要与 DASH 互操作时，媒体播放列表会指示播放器哪些字节代表各个分块：

  #EXTINF:4.08,
  fs270.mp4
  #EXT-X-PART:DURATION=1.02,URI="fs271.mp4",BYTERANGE=20000@0
  #EXT-X-PART:DURATION=1.02,URI="fs271.mp4",BYTERANGE=23000@20000
  #EXT-X-PART:DURATION=1.02,URI="fs271.mp4",BYTERANGE=18000@43000
  #EXT-X-PRELOAD-HINT:TYPE=PART,URI="fs271.mp4",BYTERANGE-START=61000

您可以使用 EdgeCacheOrigin.timeouts.readTimeout 配置值。这应该通常配置为目标时长的倍数（例如 2 倍）。

后续步骤

查看高级转送设置。
了解如何连接到不同的源站。
设置 TLS (SSL) 证书服务。
配置签名请求以进行身份验证访问内容的权限。