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

快速入门

最后更新 查看 MarkdownAgent 设置

使用本指南将您自己的 IP 前缀导入到 Cloudflare。开始之前,必须联系您的账户团队,确认合同已包含 BYOIP,并且账户已具备所需的服务配置。

在导入前缀前,请查阅 BYOIP 特定服务条款 (BYOIP Service-Specific Terms) ↗。

开始之前

您必须满足以下全部要求。如果任何注册、IRR、RPKI 或所有权验证检查失败,Cloudflare 将无法导入您的前缀。

1. 添加并验证您的前缀

添加您的前缀

  1. 使用 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"
      }
    }
  2. 保存响应中的前缀 id 和 ownership_validation_token。您将在后续步骤中使用它们。

验证前缀所有权

通过将验证令牌添加到 IRR 记录或反向 DNS 来证明所有权。您只需使用其中一种方法。

  1. 复制添加前缀时返回的 ownership_validation_token。

  2. 在匹配的 IRR route 或 route6 对象的 description 或 remarks 字段中添加以下值。将 <OWNERSHIP_VALIDATION_TOKEN> 替换为您的令牌。

    cf-validation: <OWNERSHIP_VALIDATION_TOKEN>

    更新 IRR 对象的具体步骤取决于注册机构。有关更多信息,请参阅 IRR 最佳实践。

  1. 确定该前缀需要哪些反向 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。

  2. 创建所需的反向 DNS 区域。如果您使用 Cloudflare 作为权威 DNS,请参阅设置反向 DNS 区域。否则,请遵循您的 DNS 提供商说明。

  3. 在每个反向区域中,创建名为 cf-validation 的 TXT 记录,其值为所有权验证令牌。

    cf-validation.<REVERSE_ZONE> IN TXT "<OWNERSHIP_VALIDATION_TOKEN>"
  4. 在您的 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>"}'

2. 创建服务绑定

服务绑定决定哪个 Cloudflare 服务接收发往您前缀中某个 IP 地址的流量。请在前缀处于撤销 (withdrawn) 状态时配置服务绑定。

创建默认服务绑定

每个前缀都需要一个覆盖整个前缀的默认服务绑定。Cloudflare 会将没有更具体绑定的任何 IP 地址使用此绑定。

  1. 使用 List Services(列出服务)端点 查找将默认接收流量的服务的 id。

  2. 如有必要,使用 List Prefixes(列出前缀)端点 查找前缀 id。

  3. 使用 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:

响应json
{
	"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 前缀。

3. 宣告 BGP 前缀

Cloudflare 会以撤销 (withdrawn) 状态创建 BGP 前缀。在撤销期间,您可以配置服务绑定,但不能创建使用其 IP 地址的地址映射。

在默认绑定以及任何更具体的绑定都处于活动状态后,宣告该前缀:

  1. 使用 List BGP Prefixes(列出 BGP 前缀)端点 获取 BGP 前缀 id。

  2. 使用 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}}'

在继续之前,请确认该前缀已宣告。路由在全球互联网上的传播可能需要数分钟。

4. 为 CDN 配置地址映射

如果该前缀将用于 CDN 入站 (ingress),请在 BGP 前缀宣告后再创建地址映射。地址映射决定 Cloudflare 为账户或 zone 中被代理的 DNS 记录返回哪些 BYOIP 地址。

  1. 确认 BGP 前缀已宣告,并且 CDN 服务绑定处于活动状态。

  2. 创建包含 Cloudflare 应返回的 BYOIP 地址的地址映射。

  3. 将该地址映射与相应的账户或 zone 关联。

  4. 在将生产流量切换过去之前,验证对被代理主机名的 DNS 查询是否返回预期的 BYOIP 地址。

仅与不使用 Cloudflare 被代理 DNS 响应的服务一起使用的前缀不需要地址映射。有关更多信息,请参阅关于地址映射。

这篇文档对您有帮助吗?