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

端点的 CNAME 扁平化

最后更新 查看 MarkdownAgent 设置

当仅 DNS(灰云) 负载均衡器选择地址为主机名(例如 origin.example.com)的端点时,Cloudflare 会将该主机名解析为 IP 地址,并向客户端返回 A/AAAA 记录。这就是 CNAME 扁平化,与 Cloudflare DNS 中的 CNAME 扁平化 工作方式一致。

某些使用场景(例如自行执行基于 DNS 的流量引导的第三方端点)要求负载均衡器返回 CNAME 记录本身,而不是已解析的 IP。池端点上的 flatten_cname 属性可让你按端点选择退出扁平化。

何时使用

在端点上将 flatten_cname 关闭(flatten_cname: false),适用于以下情况:

  • 你希望客户端收到指向第三方 SaaS 提供商或云端点(例如 origin-b.example.com)的 CNAME 应答。
  • 该端点解析得到的地址在下游是动态的、具备地理位置感知或具备客户端感知。
  • 你正在两个主机名端点之间进行故障转移,并希望客户端直接解析每个提供商的主机名。

对于普通的基于 IP 或主机名的端点(你只需要快速的 A/AAAA 应答),保持 flatten_cname 开启(flatten_cname: true,默认值)。

适用条件

仅当以下条件全部成立时,flatten_cname 才会改变解析器输出:

条件 所需值
负载均衡器代理模式 仅 DNS(灰云)。已代理的负载均衡器必须返回 Cloudflare anycast IP,因此会忽略此设置。
端点地址 主机名(CNAME 目标)。对于原始 IPv4/IPv6 端点地址,此设置无效。
负载均衡器主机名 不是 zone apex。zone apex 不允许 CNAME 记录,因此负载均衡器在 apex 会回退到扁平化。
被选中的端点 流量引导选中了此特定端点。当流量引导在同一池中选中端点 B 时,在端点 A 上设置 flatten_cname: false 不会生效。

如果被选中的端点将 flatten_cname 设置为 false,但上表中任一条件不满足,负载均衡器仍会扁平化该 CNAME,并像开关开启时一样返回 A/AAAA 记录。

配置 CNAME 扁平化

flatten_cname 在池内按端点配置,与 name、address、weight 及其他端点字段并列。你可以在 Cloudflare 仪表板、API 或 Terraform 中设置它。

在仪表板中,此设置显示为池中每个端点上的 Flatten CNAME(扁平化 CNAME) 开关。关闭该开关可将端点主机名作为 CNAME 记录返回。

  1. 在 Cloudflare 仪表板中,前往 Load Balancing 页面。

    前往 Load Balancing ↗
  2. 选择 Pools(池) 选项卡。

  3. 在包含该端点的池上,选择 Edit(编辑)。

  4. 在 Endpoints(端点) 部分,找到要更改的端点。

  5. 关闭 Flatten CNAME(扁平化 CNAME)。

  6. 选择 Save(保存)。

Flatten CNAME(扁平化 CNAME) 仅适用于地址为主机名的端点。使用 IP 地址的端点无法关闭它。

使用 Create Pool 或 Edit Pool,并在 origins 数组中为每个端点设置 flatten_cname。

Required API token permissions

At least one of the following token permissions is required:
  • Load Balancing: Monitors and Pools Write
Create Poolbash
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/load_balancers/pools" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"name": "primary-pool",
		"origins": [
				{
						"name": "origin-a",
						"address": "origin-a.example.com",
						"enabled": true,
						"weight": 1,
						"flatten_cname": false
				},
				{
						"name": "origin-b",
						"address": "origin-b.example.com",
						"enabled": true,
						"weight": 1,
						"flatten_cname": false
				},
				{
						"name": "fallback-ip",
						"address": "203.0.113.10",
						"enabled": true,
						"weight": 1
				}
		]
	}'

省略时,flatten_cname 默认为 true,从而保留现有池和端点的当前行为。

在 cloudflare_load_balancer_pool 资源中为每个端点设置该属性。

resource "cloudflare_load_balancer_pool" "primary" {
  account_id = var.account_id
  name       = "primary-pool"

  origins = [
    {
      name          = "origin-a"
      address       = "origin-a.example.com"
      enabled       = true
      weight        = 1
      flatten_cname = false
    },
    {
      name          = "origin-b"
      address       = "origin-b.example.com"
      enabled       = true
      weight        = 1
      flatten_cname = false
    },
    {
      name    = "fallback-ip"
      address = "203.0.113.10"
      enabled = true
      weight  = 1
    }
  ]
}

验证

使用 dig 查询负载均衡器主机名:

dig lb.example.com A +short
  • 如果流量引导选中了 flatten_cname 为 false 的端点,应答部分会包含指向端点地址的 CNAME 记录(例如 origin-a.example.com.)。客户端(或其解析器)负责进一步解析该 CNAME。
  • 如果流量引导选中了 flatten_cname 为 true 的端点(或地址为 IP 的端点),应答会包含已解析的 A/AAAA 记录。

由于应答取决于流量引导选中的端点,当池中混合了 flatten_cname: false 的主机名端点和 IP 端点时,对同一负载均衡器重复执行 dig 查询,完全可能在 CNAME 和 A/AAAA 应答之间交替。

健康监视器

端点健康监视器不受此设置影响。Cloudflare 始终将端点主机名解析为 IP,并使用未缓存的 DNS 查找探测底层服务。关闭扁平化只会改变 DNS 查询时返回给客户端的内容——健康状态仍会反映真实后端的可达性。

分析

按端点的请求计数和流量引导决策仍可在负载均衡分析中查看,并以端点名称为键。这样你可以跟踪流量如何分布到返回 CNAME 的端点。

限制

  • 已代理(橙云)负载均衡器:会忽略 flatten_cname。已代理的负载均衡器必须解析到 Cloudflare anycast IP,才能提供 Cloudflare 的 HTTP/HTTPS 代理功能。
  • zone apex 负载均衡器:会忽略 flatten_cname,因为 zone apex 不允许 CNAME 记录。
  • IP 端点:flatten_cname 无效——没有可扁平化或返回的 CNAME。
  • DNS 解析器缓存:与任何仅 DNS 负载均衡器一样,下游解析器可能按 TTL 缓存返回的记录。忽略 TTL 的客户端可能继续使用先前缓存的 CNAME 或 A 应答。
  • 套餐要求:面向启用了 Load Balancing 附加组件的 Enterprise 客户。

相关内容

  • DNS CNAME 扁平化 — 非负载均衡器 DNS 记录的等效功能。
  • 代理模式 — 何时使用仅 DNS 与已代理的负载均衡。
  • 常见配置 — 包括可受益于返回 CNAME 的端点的主-主故障转移模式。

这篇文档对您有帮助吗?