配置初始解析 IP

初始解析 IP（也称为令牌 IP）是 Gateway 为 DNS 查询分配的临时地址。借助这些地址，Gateway 可以在通常无法获取主机名信息的网络层，将基于主机名的流量关联到正确的策略或隧道。依赖此范围的功能列表，请参阅 Gateway 初始解析 IP。

默认情况下，初始解析 IP 从以下范围分配：

IPv4：172.64.128.0/20
IPv6：2606:4700:0cf1:4000::/64

这是默认范围。如果与现有网络冲突，你可以配置自定义 IPv4 初始解析 IP 范围。

IPv6 地址范围无法配置。

前提条件

你拥有 Cloudflare One Networks Write 权限（用于 API 访问），或者可以在仪表板中访问 Networking > IP addresses > Address space > Custom IPs。
新范围不会与账户中的现有路由或其他预留的 Cloudflare One 子网冲突。

查看当前范围

前往 Networking > IP addresses > Address space > Custom IPs。
前往 Custom IPs（自定义 IP） ↗
找到 Assign to 为 Initial Resolved IP 的行，在 Prefix 列中查看账户当前的 IPv4 范围。

向要查询的地址族对应的获取初始解析 IP 子网端点发送 GET 请求：

curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/zerotrust/subnets/initial_resolved_ip/$ADDRESS_FAMILY" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

更新范围

前往 Networking > IP addresses > Address space > Custom IPs。
前往 Custom IPs（自定义 IP） ↗
找到 Assign to 为 Initial Resolved IP 的行，选择三个点菜单，然后选择 Edit。
在 IP address 中输入新的 IPv4 范围。
选择 Save（保存）。

向更新初始解析 IP 子网端点发送 PUT 请求，并指定所需的网络范围：

curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/zerotrust/subnets/initial_resolved_ip/$ADDRESS_FAMILY" \
	--request PUT \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"comment": "example comment",
		"name": "IPv4 Gateway initial resolved IPs",
		"network": "172.64.128.0/20"
	}'

新的 CIDR 不能与账户中的现有专用路由或其他预留子网冲突。若发生冲突，请求会失败，响应中会说明冲突的路由或子网。

默认 IPv4 范围会自动通过 Cloudflare One Client 路由，无需配置 Split Tunnel。如果配置了自定义范围，请更新 Split Tunnel 配置，确保新范围的流量通过 Cloudflare One Client 路由。如果旧范围不再用于任何其他预留 IP 用途，也应将其移除。

初始解析 IP 的 TTL 约为 10 分钟。在更改范围前解析的 DNS 查询会继续使用原范围，直到 TTL 到期。之后，新的 DNS 查询会从新范围获取初始解析 IP。