ไปที่คอนโซล

管理缓存行为

Firebase 托管使用的是强大的全球级 CDN,可使您的网站保持最快速度。

所请求的任何静态内容都会自动缓存在 CDN 中。如果您重新部署网站的内容,Firebase 托管会在下次请求之前自动清除整个 CDN 中所有缓存的静态内容。

但是,由于 Cloud Functions 和 Cloud Run 服务会动态生成内容,因此给定网址的内容可能会因用户输入或用户身份等而异。考虑到这一点,默认情况下,后端代码处理的请求不会缓存在 CDN 中。

但是,您可以为动态内容配置缓存行为。例如,如果某个函数只是定期生成新内容,您可以通过将生成的内容至少缓存一小段时间来加快您应用的速度。

您还可以降低函数执行费用,因为内容是通过 CDN 提供的,而不是通过已触发的函数提供的。要详细了解如何优化函数执行和服务,请参阅 Cloud FunctionsCloud Run 文档。

要详细了解缓存行为,请参阅 Google 的网络开发者文档

设置 Cache-Control

用于管理动态内容缓存的主要工具是 Cache-Control 标头。通过配置此标头,您可以告知浏览器和 CDN 可将您的内容缓存多长时间。在函数中设置 Cache-Control 的方式如下所示:

res.set('Cache-Control', 'public, max-age=300, s-maxage=600');

在此示例标头中,以下指令会执行三项操作:

  • public - 将缓存标记为 public。这意味着浏览器和中间服务器(即用于 Firebase 托管的 CDN)都可以缓存内容。

  • max-age - 告知浏览器和 CDN 可以缓存内容的秒数。当达到设置的时间时,浏览器和 CDN 必须使用源服务器重新验证内容。在示例标头中,我们允许浏览器和 CDN 将内容缓存五分钟(有关针对 CDN 缓存的特定控制措施,请参阅下文的 s-maxage)。

  • s-maxage - 仅替换针对 CDN 缓存的 max-age 指令;告知 CDN 可以缓存内容的秒数。当达到设置的时间时,CDN 必须使用源服务器重新验证内容。在示例标头中,我们仅替换针对 CDN 的 max-age 的相关设置,并允许 CDN 将内容缓存十分钟。

对于 max-ages-maxage,请将其值设置为允许用户收到过期内容的最长时间。如果页面每几秒更改一次,请使用较小的时间值。但是,其他类型的内容可以安全地缓存数小时、数天甚或数月。

您可以参阅 Mozilla 开发者网络以及 Google 的 Web 开发者文档,以详细了解 Cache-Control 标头。

何时提供缓存的内容?

浏览器和 CDN 会根据以下各项缓存您的内容:

  • 主机名
  • 路径
  • 查询字符串
  • Vary 标头中指定的请求标头的内容

Vary 标头

Vary 标头决定了应使用哪些请求标头提供适当的响应(缓存内容是否有效,或是否应使用源服务器重新验证该内容)。

大多数情况下,您无需担心 Vary 标头。Firebase 托管可自动针对常见情况为您的响应设置适当的 Vary 标头。这包括确保将您正在使用的任何会话 Cookie 或授权标头设为缓存键的一部分,以防意外泄露内容。

在某些高级使用场景中,您可能需要其他标头来影响缓存。在这种情况下,您可以只在响应中设置 Vary 标头:

res.set('Vary', 'Accept-Encoding, X-My-Custom-Header');

如果采用这些设置,两个具有不同 X-My-Custom-Header 标头的相同请求会分别被缓存。

使用 Cookie

将 Firebase 托管与 Cloud Functions 或 Cloud Run 搭配使用时,Cookie 通常会从传入的请求中剥离出来。这是实现高效的 CDN 缓存行为所必需的。只有特别指定的 __session Cookie 可以传入到应用执行过程中。

__session Cookie(如果存在)会自动成为缓存键的一部分,也就是说,使用不同 Cookie 的两个用户绝不会收到彼此的已缓存响应。只有在您的应用根据用户授权提供不同的内容时,您才能使用 __session Cookie。