使用本指南将您自己的 IP 前缀导入到 Cloudflare。开始之前,必须联系您的账户团队,确认合同已包含 BYOIP,并且账户已具备所需的服务配置。
在导入前缀前,请查阅 BYOIP 特定服务条款 (BYOIP Service-Specific Terms) ↗。
您必须满足以下全部要求。如果任何注册、IRR、RPKI 或所有权验证检查失败,Cloudflare 将无法导入您的前缀。
- 您必须将前缀在以下区域互联网注册机构 (RIR) 之一进行注册:
- IPv4 前缀最小为 /24,和/或 IPv6 前缀最小为 /48、最大为 /32。
- 您的 互联网路由注册机构 (IRR) 记录必须包含:
- 与您要导入的每个前缀精确匹配的
route或route6对象 - 与 Cloudflare 将用于宣告该前缀的 ASN 相匹配的
origin
- 与您要导入的每个前缀精确匹配的
- 您的 路由源授权 (ROA) 必须准确。您必须通过 Cloudflare 的 RPKI 门户 ↗ 以及第二个来源(例如 Routinator ↗)进行验证。
- 您必须拥有 Cloudflare 账户 ID,以及本指南中各项操作所需权限的 API 令牌。如果您不熟悉 Cloudflare API,请参阅 Cloudflare API 基础知识。
-
使用 Add Prefix(添加前缀)端点 将该前缀添加到将拥有它的 Cloudflare 账户。
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/addressing/prefixes" --request POST --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" --json '{"cidr":"203.0.113.0/24","asn":13335,"delegate_loa_creation":true}'响应json { "result": { "id": "72823e95d6c64d48a8111fec81179816", "created_at": "2025-02-25T00:34:11.423722Z", "modified_at": "2025-02-25T00:34:11.423722Z", "cidr": "203.0.113.0/24", "account_id": "654c5f71c324478cc9f68d60065d4620", "description": "", "approved": "P", "on_demand_enabled": false, "on_demand_locked": false, "advertised": null, "advertised_modified_at": null, "loa_document_id": "b9ff4afe312246a8b2e7324d98f40b23", "asn": 13335, "ownership_validation_token": "<OWNERSHIP_VALIDATION_TOKEN>", "delegate_loa_creation": true, "irr_validation_state": "pending", "rpki_validation_state": "pending", "ownership_validation_state": "pending" } } -
保存响应中的前缀
id和ownership_validation_token。您将在后续步骤中使用它们。
通过将验证令牌添加到 IRR 记录或反向 DNS 来证明所有权。您只需使用其中一种方法。
-
复制添加前缀时返回的
ownership_validation_token。 -
在匹配的 IRR
route或route6对象的description或remarks字段中添加以下值。将<OWNERSHIP_VALIDATION_TOKEN>替换为您的令牌。cf-validation: <OWNERSHIP_VALIDATION_TOKEN>更新 IRR 对象的具体步骤取决于注册机构。有关更多信息,请参阅 IRR 最佳实践。
-
确定该前缀需要哪些反向 DNS 区域。IPv4 反向 DNS 委派通常按八位位组边界对齐,IPv6 委派按半字节(nibble)边界对齐。未与下一个边界对齐的前缀必须拆分为更小的反向区域。
示例
使用以下公式确定下一个委派边界处的区域数量:
2^(next boundary - current prefix length)IPv4 前缀
192.0.2.0/23需要两个/24反向区域:一个用于192.0.2.0/24,另一个用于192.0.3.0/24。IPv6 前缀
2001:db8::/34需要四个/36反向区域:2001:db8::/36、2001:db8:1000::/36、2001:db8:2000::/36和2001:db8:3000::/36。 -
创建所需的反向 DNS 区域。如果您使用 Cloudflare 作为权威 DNS,请参阅设置反向 DNS 区域。否则,请遵循您的 DNS 提供商说明。
-
在每个反向区域中,创建名为
cf-validation的 TXT 记录,其值为所有权验证令牌。cf-validation.<REVERSE_ZONE> IN TXT "<OWNERSHIP_VALIDATION_TOKEN>" -
在您的 RIR 处,将这些反向区域委派给托管它们的权威域名服务器。
发布验证令牌后,使用 Validate Prefix(验证前缀)端点 触发前缀验证检查:
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/addressing/prefixes/$PREFIX_ID/validate" --request POST --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"使用 Prefix Details(前缀详情)端点 监控验证。当 IRR、RPKI 和所有权检查通过时,该前缀的 approved 字段会返回 "V"。然后您可以移除所有权验证令牌,并继续创建服务绑定。
如果验证失败,请参阅排查前缀验证问题,更正报告的问题,然后再次触发验证。
您可以允许另一个 Cloudflare 账户使用该前缀的全部或部分。详情请参阅 前缀委派。
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/addressing/prefixes/$PREFIX_ID/delegations" --request POST --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" --json '{"cidr":"<IP_PREFIX_TO_DELEGATE>","delegated_account_id":"<DELEGATED_ACCOUNT_ID>"}'服务绑定决定哪个 Cloudflare 服务接收发往您前缀中某个 IP 地址的流量。请在前缀处于撤销 (withdrawn) 状态时配置服务绑定。
每个前缀都需要一个覆盖整个前缀的默认服务绑定。Cloudflare 会将没有更具体绑定的任何 IP 地址使用此绑定。
-
使用 List Services(列出服务)端点 查找将默认接收流量的服务的
id。 -
如有必要,使用 List Prefixes(列出前缀)端点 查找前缀
id。 -
使用 Create Service Binding(创建服务绑定)端点 将整个前缀绑定到默认服务。
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/addressing/prefixes/$PREFIX_ID/bindings" --request POST --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" --json '{"cidr":"203.0.113.0/24","service_id":"<DEFAULT_SERVICE_ID>"}'
创建更具体的绑定,将前缀中选定的地址发送到其他服务,例如 CDN 或 Spectrum。有关特定于服务的配置要求,请参阅 服务绑定。
Cloudflare 建议将连续 IP 地址分组为尽可能大的合适 CIDR,而不是为每个地址创建单独绑定。
示例
假设 203.0.113.0/24 默认使用 Spectrum,但地址 203.0.113.16 到 203.0.113.23 必须使用 CDN。这八个连续地址构成 203.0.113.16/29,因此您可以为该 CIDR 创建一个 CDN 绑定。
使用 Create Service Binding(创建服务绑定)端点 创建更具体的绑定。
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/addressing/prefixes/$PREFIX_ID/bindings" --request POST --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" --json '{"cidr":"203.0.113.16/29","service_id":"<SERVICE_ID>"}'响应中的初始预配状态为 provisioning:
{
"errors": [],
"messages": [],
"success": true,
"result": {
"cidr": "203.0.113.16/29",
"id": "<SERVICE_BINDING_ID>",
"provisioning": {
"state": "provisioning"
},
"service_id": "<SERVICE_ID>",
"service_name": "<SERVICE_NAME>"
}
}创建或删除服务绑定需要四到六个小时才能在 Cloudflare 网络中传播。使用 Get Service Binding(获取服务绑定)端点 监控其状态。请等到所有绑定都处于活动状态后再宣告 BGP 前缀。
Cloudflare 会以撤销 (withdrawn) 状态创建 BGP 前缀。在撤销期间,您可以配置服务绑定,但不能创建使用其 IP 地址的地址映射。
在默认绑定以及任何更具体的绑定都处于活动状态后,宣告该前缀:
-
使用 List BGP Prefixes(列出 BGP 前缀)端点 获取 BGP 前缀
id。 -
使用 Update BGP Prefix(更新 BGP 前缀)端点 宣告该前缀。
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/addressing/prefixes/$PREFIX_ID/bgp/prefixes/$BGP_PREFIX_ID" --request PATCH --header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" --json '{"on_demand":{"advertised":true}}'
在继续之前,请确认该前缀已宣告。路由在全球互联网上的传播可能需要数分钟。
如果该前缀将用于 CDN 入站 (ingress),请在 BGP 前缀宣告后再创建地址映射。地址映射决定 Cloudflare 为账户或 zone 中被代理的 DNS 记录返回哪些 BYOIP 地址。
-
确认 BGP 前缀已宣告,并且 CDN 服务绑定处于活动状态。
-
创建包含 Cloudflare 应返回的 BYOIP 地址的地址映射。
-
将该地址映射与相应的账户或 zone 关联。
-
在将生产流量切换过去之前,验证对被代理主机名的 DNS 查询是否返回预期的 BYOIP 地址。
仅与不使用 Cloudflare 被代理 DNS 响应的服务一起使用的前缀不需要地址映射。有关更多信息,请参阅关于地址映射。