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

名称服务器集

最后更新 查看 MarkdownAgent 设置

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 集。省略时,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。

Create Custom Nameserver Setbash
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": []
}

高级自定义 Nameserver 集合

若订阅了 Foundation DNS,将 advanced 设为 true 以创建 Advanced Custom Nameserver 集。Cloudflare 会将其地址分布到 Advanced anycast 网络组,以提高弹性。

请求中每个 nameserver 名称必须具有相同的 ip_count。Cloudflare 会选择 anycast 组。

Create Custom Nameserver Setbash
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。

重命名 Nameserver 集合

要重命名集合,请向 /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
Update Custom Nameserver Setbash
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 地址记录

即使 nameserver 名称属于使用 Cloudflare DNS 的域名,Cloudflare 也不会为您创建这些记录。

  1. 在每个 nameserver 名称的权威 DNS 提供商处,创建包含分配给该名称的地址的 A 和 AAAA 记录。

  2. 如果 nameserver 名称位于将使用该集合的 zone 内(in-bailiwick),请在父级添加其分配地址作为 glue(RFC 1912 ↗)。如果该 zone 使用 Cloudflare Registrar,请联系 Cloudflare Support 以添加 glue 记录。

将名称服务器集分配给 zone

在 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 Write
  • DNS Write
Update DNS Settingsbash
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"。

更新 nameserver

在使用该集合的 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 Write
  • DNS Write
Update DNS Settingsbash
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 使用该集合,并且这些移除已传播,即可删除该集合:

Delete Custom Nameserver Setbash
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 不会保留已删除集合的名称到地址分配。新集合可能会收到不同的地址。

这篇文档对您有帮助吗?