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

Early Hints

最后更新 查看 MarkdownAgent 设置

Early Hints 帮助浏览器更快地加载网页。Early Hints 在所有 pages.dev 域名和自定义域名上自动启用。

Early Hints 会自动缓存任何 preload ↗ 和 preconnect ↗ 类型的 Link 标头 ↗,作为 Early Hints 发送给浏览器。这些提示在完整响应准备完成之前发送给浏览器,浏览器可以据此更快地加载网页。在 Pages 中有两种创建这些 Link 标头的方式:

配置 Early Hints

可以使用以下两种方法之一创建 Early Hints。

1. 配置 _headers 文件

使用 _headers 文件 创建自定义标头。如果在网站的 /blog/ 部分包含特定样式表,可以创建以下规则:

/blog/*
  Link: </styles.css>; rel=preload; as=style

Pages 将附加此 Link: </styles.css>; rel=preload; as=style 标头。缓存后,Early Hints 将作为 Early Hint 发出此标头。

为简化编写体验,Pages 还会从具有以下属性的任何 <link> HTML 元素自动生成 Link 标头:

  • href
  • as(可选)
  • rel(preconnect、preload 或 modulepreload 之一)

包含任何其他附加属性(例如 fetchpriority、crossorigin 或 data-do-not-generate-a-link-header)的 <link> 元素不会用于生成 Link 标头,以防止意外丢失作为 Early Hint 丢弃的自定义优先级逻辑。

这样你可以直接在编写文档时创建 Early Hints,而无需在 HTML 和 _headers 文件之间切换。

<html>
	<head>
		<link rel="preload" href="/style.css" as="style" />
		<link rel="stylesheet" href="/style.css" />
	</head>
</html>

通过将以下内容添加到 _headers 文件来移除任何自动生成的 Link 标头:

/*
  ! Link

日志中的 Early Hints 探测

Cloudflare 会在所有 Pages 域名(包括自定义域名)上自动运行 Early Hints 探测请求。这些探测会出现在你的 Cloudflare 日志中,ClientRequestSource: earlyHintsCache,ClientRequestUserAgent 为 nginx-ssl early hints 或 bastion early hints。

探测返回 504 表示该 URL 尚未缓存 Early Hint(缓存未命中)。返回 200 表示已提供缓存的 Early Hint。这些探测是 Cloudflare 内部子请求 — 不会到达你的 Pages 项目或源站服务器,也不会影响最终用户。

从日志中过滤探测

要从 Log Explorer 查询或告警规则中排除 Early Hints 探测,请使用 ClientRequestSource != "earlyHintsCache" 进行筛选。

减少探测缓存未命中

当 Cloudflare 没有为某个 URL 缓存 Link 标头时,探测会返回 504。要将缓存未命中转换为命中并减少日志中的 504 数量,请使用 _headers 文件 或从 HTML 元素自动生成 Link 标头,在 Pages 项目中配置 Link 标头。

在 Pages 上禁用 Early Hints

无法为 Cloudflare Pages 禁用 Early Hints。如果需要完全控制 Early Hints 设置,请将项目从 Pages 迁移到 Workers。Workers 会遵循 zone 级别的 Early Hints 设置。

这篇文档对您有帮助吗?