Nameserver 集合是账户级分组,包含两个到五个自定义 nameserver 名称及 Cloudflare 分配给这些名称的 IP 地址。你只需创建一次集合,即可将其分配给同一账户中的 zone。每个集合都有一个用于标识它的名称。
名称服务器集是独立于 zone、账户 和 tenant 自定义 nameserver 的配置。一个 zone 要么使用名称服务器集,要么使用上述配置之一,二者不能同时使用。现有配置无法转换为名称服务器集。
Nameserver 集合目前处于 Beta 阶段,Enterprise 客户可通过 API 或仪表板使用。
要使用名称服务器集,zone 必须与该集合位于同一账户中。
- Cloudflare 会为集合中的每个 nameserver 名称同时分配 IPv4 和 IPv6 地址。
- 每个名称服务器集要么是标准的,要么是 Advanced。
- nameserver 名称可以属于任意域名,即使该域名并未作为 zone 存在于 Cloudflare 中。
- 同一 nameserver 名称可以在账户内的多个集合中使用。
- 集合不可变。你可以创建和删除集合,但不能修改集合。之后只能更改名称。
- Cloudflare 不会为名称服务器集创建或更新 DNS 记录。您需要自行管理所需的
A、AAAA和NS记录,以及 DNS 要求的 glue。 - 目前,名称服务器集尚不能用作新 zone 的 DNS zone 默认值。
每个名称服务器集都属于一个 IP 集。省略时,ip_set 编号默认为 1。IP 集控制 Cloudflare 可以分配哪些地址:
- 具有相同
ip_set编号和advanced值的集合可以复用地址。 - 具有不同
ip_set编号或advanced值的集合使用独立的地址组。
例如,ip_set: 1 的标准集合与 ip_set: 1 的 Advanced 集合使用不同的 IP 集。
zone 不能使用与其父 zone、其子域名,或另一账户中同名 zone 相同的 nameserver IP 地址。若要在某个 zone 及其子域名上使用相同类型的集合,请创建具有不同 ip_set 编号的集合。
以下限制适用于名称服务器集:
| 项目 | 限制 |
|---|---|
| 每个集合中的 nameserver 名称 | 2 到 5 |
| 每个 nameserver 名称的 IPv4 和 IPv6 地址 | 每种 1 到 3 个(ip_count,默认为 1) |
Advanced 集合中的所有 nameserver 名称必须使用相同的 ip_count 值。
顶层的 name 是集合的标签。选择一个便于日后查找或识别该集合的名称。
集合名称在账户内必须唯一。
在 Cloudflare 仪表板中,前往账户的 DNS Settings 页面,在 Nameserver sets 下创建和管理集合。
前往 DNS Settings(DNS 设置) ↗要通过 API 创建集合,请使用 Create Custom Nameserver Set 端点。
添加顶层 name 以标识集合。nameservers 中的每个 nameserver 名称在集合内必须唯一且全部小写。国际化域名必须使用 Punycode。
省略 advanced 或将其设为 false 以创建标准名称服务器集。标准集合可以为每个 nameserver 名称使用不同的 ip_count。
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/dns_settings/nameserver_sets" \
--request POST \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
--json '{
"name": "Production",
"ip_set": 1,
"nameservers": [
{
"name": "ns1.example.com"
},
{
"name": "ns2.example.com",
"ip_count": 2
}
]
}'响应中包含集合 ID、集合名称,以及分配给每个 nameserver 名称的地址:
{
"result": {
"id": "0e1f2a3b4c5d6e7f8091a2b3c4d5e6f7",
"name": "Production",
"advanced": false,
"ip_set": 1,
"nameservers": [
{
"name": "ns1.example.com",
"ipv4": ["192.0.2.1"],
"ipv6": ["2001:db8::1"]
},
{
"name": "ns2.example.com",
"ipv4": ["192.0.2.2", "192.0.2.3"],
"ipv6": ["2001:db8::2", "2001:db8::3"]
}
],
"created_on": "2026-01-15T12:00:00Z"
},
"success": true,
"errors": [],
"messages": []
}若订阅了 Foundation DNS,将 advanced 设为 true 以创建 Advanced Custom Nameserver 集。Cloudflare 会将其地址分布到 Advanced anycast 网络组,以提高弹性。
请求中每个 nameserver 名称必须具有相同的 ip_count。Cloudflare 会选择 anycast 组。
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/dns_settings/nameserver_sets" \
--request POST \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
--json '{
"name": "Production Advanced",
"advanced": true,
"ip_set": 1,
"nameservers": [
{
"name": "ns1.example.com",
"ip_count": 1
},
{
"name": "ns2.example.com",
"ip_count": 1
},
{
"name": "ns3.example.com",
"ip_count": 1
}
]
}'Advanced 集合的响应会为每个地址包含 anycast 组:
{
"result": {
"id": "1f2a3b4c5d6e7f8091a2b3c4d5e6f708",
"name": "Production Advanced",
"advanced": true,
"ip_set": 1,
"nameservers": [
{
"name": "ns1.example.com",
"ipv4": ["192.0.2.1"],
"ipv4_groups": ["a"],
"ipv6": ["2001:db8::1"],
"ipv6_groups": ["a"]
},
{
"name": "ns2.example.com",
"ipv4": ["192.0.2.2"],
"ipv4_groups": ["b"],
"ipv6": ["2001:db8::2"],
"ipv6_groups": ["b"]
},
{
"name": "ns3.example.com",
"ipv4": ["192.0.2.3"],
"ipv4_groups": ["c"],
"ipv6": ["2001:db8::3"],
"ipv6_groups": ["c"]
}
],
"created_on": "2026-01-15T12:00:00Z"
},
"success": true,
"errors": [],
"messages": []
}ipv4_groups 和 ipv6_groups 数组与对应的地址数组一一映射。每个组值标识同一索引处地址所属的 anycast 组。
组 a 和 b 由两组互不重叠的数据中心通告。每组尽可能均匀地分布在全球。组 c 由所有 Cloudflare 数据中心通告,因此包含 a 和 b 中的每个数据中心。示例请参阅 Anycast 网络组。
一个账户不能包含两个 nameserver 名称和地址完全相同的集合。
要列出账户中的集合,向同一端点发送 GET 请求,并使用 page 和 per_page 查询参数分页。要检索单个集合,在路径中追加其 ID。
要重命名集合,请向 /accounts/{account_id}/dns_settings/nameserver_sets/{nameserver_set_id} 发送 PATCH 请求,并且只包含新的 name:
Required API token permissions
At least one of the following token permissions is required:Account DNS Settings Write
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/dns_settings/nameserver_sets/$NAMESERVER_SET_ID" \
--request PATCH \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
--json '{
"name": "Production primary"
}'选择一个在账户内唯一的集合名称。只能更新顶层的 name 字段。
重命名集合不会影响 DNS 解析,也不需要更改 DNS 记录或委派设置。
即使 nameserver 名称属于使用 Cloudflare DNS 的域名,Cloudflare 也不会为您创建这些记录。
-
在每个 nameserver 名称的权威 DNS 提供商处,创建包含分配给该名称的地址的
A和AAAA记录。 -
如果 nameserver 名称位于将使用该集合的 zone 内(in-bailiwick),请在父级添加其分配地址作为 glue(RFC 1912 ↗)。如果该 zone 使用 Cloudflare Registrar,请联系 Cloudflare Support 以添加 glue 记录。
在 Cloudflare 仪表板中,前往 zone 的 DNS Settings 页面,在 Nameserver sets 下分配集合。
前往 Settings(设置) ↗要通过 API 分配集合,请使用 Update DNS Settings for a Zone 端点:
Required API token permissions
At least one of the following token permissions is required:Zone DNS Settings WriteDNS Write
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/dns_settings" \
--request PATCH \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
--json '{
"nameservers": {
"type": "custom",
"nameserver_set_id": "0e1f2a3b4c5d6e7f8091a2b3c4d5e6f7"
}
}'如果集合中的地址已被父 zone、子域名 zone 或另一账户中的同名 zone 使用,分配会失败。在这种情况下,请使用具有不同 ip_set 编号的集合。
分配集合会替换该 zone 现有的 Cloudflare 品牌标准或 Advanced Nameserver,或其现有的名称服务器集。标准和 Advanced Custom Nameserver 集在 zone DNS 设置中都使用 type: "custom"。
在使用该集合的 zone 的 registrar 处——如果该 zone 是被委派的,则在父 zone 中——将 nameserver 设为集合中的所有 nameserver 名称。
若要让 zone 激活并在未使用多提供商 DNS 的情况下保持 Active,以下各组值必须完全匹配:
- 集合中的 nameserver 名称与父级返回的
NS记录集 - 对于每个 nameserver 名称,其分配的 IPv4 地址与实时
A应答 - 对于每个 nameserver 名称,其分配的 IPv6 地址与实时
AAAA应答
Cloudflare 会分别验证每个 nameserver 名称的地址应答。分配给某个名称的地址不能用来满足另一个名称的要求,即使整个集合中的记录包含所有已分配地址。
在启用多提供商 DNS 时,父级返回的 NS 记录集中必须包含每个预期的 nameserver 名称。每个 nameserver 名称还必须返回分配给它的每一个 IPv4 和 IPv6 地址。允许存在额外的名称和地址。
Cloudflare 不会单独验证父级 glue。in-bailiwick nameserver 仍需要可用的 glue 才能完成递归解析。out-of-bailiwick nameserver 本质上不需要父级 glue。
已分配给 zone 的集合无法删除。要停止在某个 zone 上使用自定义 nameserver,请将 nameserver 类型改回 cloudflare.standard 或 cloudflare.advanced,并在该 zone 的 registrar 处更新 nameserver:
Required API token permissions
At least one of the following token permissions is required:Zone DNS Settings WriteDNS Write
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/dns_settings" \
--request PATCH \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
--json '{
"nameservers": {
"type": "cloudflare.standard"
}
}'在委派或 nameserver 变更传播后,移除过时的 A、AAAA 和父级 glue 记录。等待这些移除操作完成传播。
一旦没有任何 zone 使用该集合,并且这些移除已传播,即可删除该集合:
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/dns_settings/nameserver_sets/$NAMESERVER_SET_ID" \
--request DELETE \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"Cloudflare 不会保留已删除集合的名称到地址分配。新集合可能会收到不同的地址。