当仅 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 记录。
flatten_cname 在池内按端点配置,与 name、address、weight 及其他端点字段并列。你可以在 Cloudflare 仪表板、API 或 Terraform 中设置它。
在仪表板中,此设置显示为池中每个端点上的 Flatten CNAME(扁平化 CNAME) 开关。关闭该开关可将端点主机名作为 CNAME 记录返回。
-
在 Cloudflare 仪表板中,前往 Load Balancing 页面。
前往 Load Balancing ↗ -
选择 Pools(池) 选项卡。
-
在包含该端点的池上,选择 Edit(编辑)。
-
在 Endpoints(端点) 部分,找到要更改的端点。
-
关闭 Flatten CNAME(扁平化 CNAME)。
-
选择 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
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 的端点的主-主故障转移模式。