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

SaaS 的 Early Hints

最后更新 查看 MarkdownAgent 设置

Early Hints 允许浏览器在源服务器编译完整响应的同时开始加载资源。这可提升最终用户的网页加载速度。作为 SaaS 提供商,你可能希望为部分自定义主机名优先考虑速度。使用自定义元数据,你可以按自定义主机名启用 Early Hints。


前提条件

在为 SaaS 使用 Early Hints 之前,你需要创建自定义主机名。如果尚未完成,请参阅 Cloudflare for SaaS 快速入门。


通过 API 按自定义主机名启用 Early Hints

  1. 查找你的 zone ID,可在 Cloudflare 仪表板中获取。

  2. 在 API Tokens(API 令牌) ↗ 页面的 Global API Key(全局 API 密钥) 下查找你的身份验证密钥。

  3. 如果要创建新的自定义主机名,请发出类似下方示例的 API 调用,并指定 "early_hints": "on":

Required API token permissions

At least one of the following token permissions is required:
  • SSL and Certificates Write
Create Custom Hostnamebash
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/custom_hostnames" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"hostname": "<CUSTOM_HOSTNAME>",
		"ssl": {
				"method": "http",
				"type": "dv",
				"settings": {
						"http2": "on",
						"min_tls_version": "1.2",
						"tls_1_3": "on",
						"early_hints": "on"
				},
				"bundle_method": "ubiquitous",
				"wildcard": false
		}
	}'
  1. 对于现有自定义主机名,使用 GET 调用获取其 id 和当前 ssl.settings 值:

Required API token permissions

At least one of the following token permissions is required:
  • SSL and Certificates Write
  • SSL and Certificates Read
List Custom Hostnamesbash
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/custom_hostnames?hostname=%7Bhostname%7D" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

例如,响应可能包含以下设置:

{
  "ssl": {
    "settings": {
      "ciphers": [
        "ECDHE-ECDSA-AES128-GCM-SHA256",
        "ECDHE-RSA-AES128-GCM-SHA256"
      ],
      "early_hints": "off",
      "http2": "on",
      "min_tls_version": "1.2",
      "tls_1_3": "on"
    }
  }
}
  1. 从响应中复制完整的 ssl.settings 对象。仅将 early_hints 更改为 on,然后发出 PATCH 调用:

Required API token permissions

At least one of the following token permissions is required:
  • SSL and Certificates Write
Edit Custom Hostnamebash
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/custom_hostnames/$CUSTOM_HOSTNAME_ID" \
	--request PATCH \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"ssl": {
				"settings": {
						"ciphers": [
								"ECDHE-ECDSA-AES128-GCM-SHA256",
								"ECDHE-RSA-AES128-GCM-SHA256"
						],
						"early_hints": "on",
						"http2": "on",
						"min_tls_version": "1.2",
						"tls_1_3": "on"
				}
		}
	}'

PATCH 请求会替换现有的 ssl.settings 对象。此示例复制了示例响应中的所有设置。请复制你收到的响应值,并省略响应中不存在的设置。

这篇文档对您有帮助吗?