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

配置路由

最后更新 查看 MarkdownAgent 设置

Magic Transit Virtual Network 使用路由表将流量从 Cloudflare 的全球网络通过下一跳(next-hop)引导至您连接的网络。您可以通过静态路由配置,或通过 IPsec 和 GRE 隧道或采用 Dataplane v2 的 CNI(封闭测试版)上的 BGP 对等互连学习到的路由,向 Magic Transit Virtual Network 路由表添加条目。

有关与以下内容相关的所有技术方面的更多信息,请参阅 流量引导(Traffic Steering):

  • 路由的优先级和权重
  • 流量的区域范围划分以降低延迟
  • BGP 对等互连

配置静态路由

创建静态路由

  1. 转到 Routes(路由) 页面。

    前往 Routes(路由) ↗
  2. 在 Routes(路由) 选项卡中,选择 Create route(创建路由),然后选择 WAN 作为路由类型。

  3. 在 Description(描述) 中为您的路由输入描述性名称。

  4. 在 Prefix(前缀) 中输入您的 IP 地址范围。例如,10.10.10.100/24。

  5. 在 Tunnel/Next hop(隧道/下一跳) 中,从您在 配置隧道端点 中创建的隧道中选择一条作为路由。

  6. 选择路由的 Priority(优先级)。数字越低,优先级越高。

  7. (可选)为您的路由选择 Weight(权重)。有关示例,请参阅 设置静态路由的优先级和权重。

  8. (可选)如果需要将路由范围限定到特定区域,可以在 Region code(区域代码) 中进行设置。

  9. (可选)我们强烈建议在添加路由之前,通过选择 Test routes(测试路由) 来测试您的路由。

  10. 选择 Add routes(添加路由)。

通过 API 创建一个 POST 请求,以创建一个或多个静态路由。

示例:

Required API token permissions

At least one of the following token permissions is required:
  • Magic WAN Write
  • Magic Transit Write
Create a Routebash
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/magic/routes" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"nexthop": "<IP_NEXT_HOP>",
		"prefix": "<YOUR_IP_PREFIX>",
		"priority": 0,
		"id": "023e105f4ecef8ad9ca31a8372d0c353",
		"description": "<ROUTE_DESCRIPTION>",
		"scope": {
				"colo_names": [
						"den01"
				],
				"colo_regions": [
						"APAC"
				]
		},
		"weight": 0
	}'
{
  "errors": [
    {
      "code": 1000,
      "message": "message"
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message"
    }
  ],
  "result": {
    "routes": [
      {
        "nexthop": "203.0.113.1",
        "prefix": "192.0.2.0/24",
        "priority": 0,
        "id": "023e105f4ecef8ad9ca31a8372d0c353",
        "description": "New route for new prefix 203.0.113.1",
        "scope": {
          "colo_names": [
            "den01"
          ],
          "colo_regions": [
            "APAC"
          ]
        },
        "weight": 0
      }
    ]
  },
  "success": true
}

编辑静态路由

  1. 在 Routes(路由) 选项卡中,找到要修改的路由。
  2. 选择其旁边的三个点 > Edit(编辑)。
  3. 输入更新后的路由信息。
  4. (可选)我们强烈建议在添加路由之前,通过选择 Test routes(测试路由) 来测试您的路由。
  5. 选择 Edit routes(编辑路由)。

通过 API 创建一个 PUT 请求,以更新一个或多个静态路由。

示例:

Required API token permissions

At least one of the following token permissions is required:
  • Magic WAN Write
  • Magic Transit Write
Update Routebash
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/magic/routes/$ROUTE_ID" \
	--request PUT \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"nexthop": "<IP_NEXT_HOP>",
		"prefix": "<YOUR_IP_PREFIX>",
		"priority": 0,
		"id": "023e105f4ecef8ad9ca31a8372d0c353",
		"description": "<ROUTE_DESCRIPTION>",
		"scope": {
				"colo_names": [
						"den01"
				],
				"colo_regions": [
						"APAC"
				]
		},
		"weight": 0
	}'
{
  "errors": [
    {
      "code": 1000,
      "message": "message"
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message"
    }
  ],
  "result": {
    "modified": true,
    "modified_route": {
      "nexthop": "203.0.113.1",
      "prefix": "192.0.2.0/24",
      "priority": 0,
      "id": "023e105f4ecef8ad9ca31a8372d0c353",
      "description": "New route for new prefix 203.0.113.1",
      "scope": {
        "colo_names": [
          "den01"
        ],
        "colo_regions": [
          "APAC"
        ]
      },
      "weight": 0
    }
  },
  "success": true
}

删除静态路由

  1. 在 Routes(路由) 选项卡中,找到要删除的静态路由。
  2. 选择其旁边的三个点 > Delete(删除)。
  3. 勾选复选框确认该操作,然后选择 Delete(删除)。

通过 API 创建一个 DELETE 请求,以删除静态路由。

示例:

Required API token permissions

At least one of the following token permissions is required:
  • Magic WAN Write
  • Magic Transit Write
Delete Routebash
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/magic/routes/$ROUTE_ID" \
	--request DELETE \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"
{
  "errors": [
    {
      "code": 1000,
      "message": "message"
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message"
    }
  ],
  "result": {
    "deleted": true,
    "deleted_route": {
      "nexthop": "203.0.113.1",
      "prefix": "192.0.2.0/24",
      "priority": 0,
      "id": "023e105f4ecef8ad9ca31a8372d0c353",
      "description": "New route for new prefix 203.0.113.1",
      "scope": {
        "colo_names": [
          "den01"
        ],
        "colo_regions": [
          "APAC"
        ]
      },
      "weight": 0
    }
  },
  "success": true
}

配置 BGP 路由

使用以下 on-ramp 时可以使用 BGP 对等互连:

为 BGP 对等互连选择 ASN

Magic Transit Virtual Network 路由表由客户管理。您可以同时选择 Cloudflare 端的 ASN(自治系统号)和您客户设备的 ASN。客户设备 ASN 可以是 2 字节或 4 字节。Magic Transit 使用的公共 ASN 会在接入过程中进行验证。

默认情况下,每个 BGP 对等互连会话都使用相同的 Cloudflare 端 ASN 来代表与 Magic Transit Virtual Network 路由表的对等互连。此 ASN 称为 CF Account ASN(Cloudflare 账户 ASN),并设置为 13335。您可以将其配置为私有 2 字节 ASN(64512 到 65534 之间的任何值,例如 65000)。

CF Account ASN 适用于您账户中的所有 BGP 会话,包括 IPsec/GRE 隧道和 CNI。它必须与每条隧道上的客户设备 ASN 不同。

设置此 ASN:

  1. 转到 Routes 页面。

    前往 Routes(路由) ↗
  2. 选择 WAN configuration(WAN 配置)。

  3. 在 CF Account ASN(Cloudflare 账户 ASN) 中输入 Cloudflare 的 ASN。

  4. 选择 Update(更新)。

创建一个 PUT 请求以更新您账户的 BGP 设置。以下示例将 CF Account ASN 设置为 65000:

Update BGP Settingsbash
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/magic/bgp/settings" \
	--request PUT \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"cloudflare_asn": 65000
	}'

Magic Transit 客户还应注意以下几点:

  • Cloudflare 端 ASN 永远不会在 Cloudflare 边缘的任播宣告的 AS_PATH 中公开。在这些宣告中,Cloudflare 将始终使用 13335 的 Cloudflare ASN,并且可以选择在前头附加一个自带的 ASN,如 Cloudflare ASN 与您自己的 ASN 的对比 中所述。
  • 客户设备 ASN 可以是私有 ASN,或者是他们在边缘进行 Magic Transit 任播宣告所使用的 ASN:这对于 Cloudflare 全球网络边缘任播宣告前缀的 ASN 没有影响。

设置 BGP 对等互连

您需要配置两个 ASN:

  • 名为 CF Account ASN(Cloudflare 账户 ASN) 的 Cloudflare 账户范围的 ASN。
  • 为您想要配置 BGP 的每个 on-ramp 分配一个 ASN。

如果您已经设置了 Cloudflare 账户 ASN,请跳过下面的第二和第三步。

为互连设置 BGP

  1. 转到 Routes 页面。

    前往 Routes(路由) ↗
  2. 选择 WAN configuration(WAN 配置)。

  3. 在 CF Account ASN(Cloudflare 账户 ASN) 中输入 Cloudflare 的 ASN,然后选择 Update(更新)。

  4. 转到 Interconnects(互连)。

    前往 Interconnects(互连) ↗
  5. 找到要配置 BGP 的带有 Dataplane v2 的 CNI 互连 > 选择其旁边的 三个点 > Configure BGP(配置 BGP)。

  6. 在 Customer device ASN 中,输入您的网络 ASN。

  7. 在 MD5 key 中,您可以选择输入网络的密钥。请注意,这旨在防止意外的误配置,而不是一种安全机制。

  8. (可选)在 Additional Advertised prefix list 中,输入您想要与现有路由一起播发的任何其他前缀。如果您不想播发额外的路由,请将此项留空。此处配置的典型前缀包括:

    • 指向 0.0.0.0/0(默认路由)的路由 —— 如果使用 Magic Transit with Egress,这将吸引所有发往互联网的流量。
    • 指向 100.96.0.0/12 的路由 —— 这是 Cloudflare One 客户端默认使用的 CGNAT 空间部分。
  9. 选择 Save(保存)。

为 IPsec/GRE 隧道设置 BGP

  1. 转到 Routes 页面。

    前往 Routes(路由) ↗
  2. 选择 WAN configuration(WAN 配置)。

  3. 在 CF Account ASN(Cloudflare 账户 ASN) 中输入 Cloudflare 的 ASN,然后选择 Update(更新)。

  4. 转到 Connectors(连接器)。

    前往 Connectors(连接器) ↗
  5. 在 IPsec/GRE tunnels(IPsec/GRE 隧道) 中,找到要配置 BGP 的隧道 > 选择其旁边的 三个点 > Configure BGP(配置 BGP)。

  6. 在 Customer device ASN 中,输入您的网络 ASN。

  7. 在 MD5 key 中,您可以选择输入网络的密钥。请注意,这旨在防止意外的误配置,而不是一种安全机制。

  8. (可选)在 Additional Advertised prefix list 中,输入您想要与现有路由一起播发的任何其他前缀。如果您不想播发额外的路由,请将此项留空。此处配置的典型前缀包括:

    • 指向 0.0.0.0/0(默认路由)的路由 —— 如果使用 Magic Transit with Egress,这将吸引所有发往互联网的流量。
    • 指向 100.96.0.0/12 的路由 —— 这是 Cloudflare One 客户端默认使用的 CGNAT 空间部分。
  9. 选择 Save(保存)。

GRE/IPsec 隧道的注意事项

如果您正在为隧道(GRE 或 IPsec)配置 BGP 对等互连,您必须注意以下几点:

  • 您的客户终端设备 (CPE) 必须发起 BGP 对等互连会话。Cloudflare 将不会主动发起。

  • 您的 BGP 说话者(speaker)必须与隧道的 IPv4 接口地址进行对等互连。您的 CPE 可以使用任何 IPv4 地址作为其对等互连连接的本侧地址;它不需要使用来自 /31 或 /30 接口子网的另一个地址。

  • 保持时间(Hold time)必须不少于 30 秒。Cloudflare 建议至少为 90 秒。Cloudflare 播发的保持时间为 240 秒,因此如果您设置的值大于 240 秒,协商后的保持时间将为 240 秒。

  • 连接重试时间(Connect retry time)应该较低(例如,5 秒或 10 秒)。

  • 您的 CPE 在一个 BGP 会话上最多可以播发 5,000 个前缀。

  • MD5 身份验证是可选的。您最多可以使用 80 个字符。支持的字符包括 a-zA-Z0-9'!@#$%^&*()+[]{}<>/.,;:_-~`= \\|

过滤 BGP 路由

BGP 过滤配置文件控制您与 Cloudflare 的对等互连会话中交换的路由。它们适用于 GRE 或 IPsec 隧道上的 BGP。

每个账户范围的配置文件需要一个唯一名称、一个匹配操作,以及最多 1,000 个无类别域间路由 (CIDR) 目标。

匹配操作的行为如下:

匹配操作 行为
allow 接受匹配的路由并拒绝其他所有路由。
deny 拒绝匹配的路由并接受其他所有路由。

每个 CIDR 目标都有一种匹配模式,用于确定前缀及其子网是否匹配:

匹配模式 语法 匹配内容
精确前缀 10.0.0.0/8 仅 10.0.0.0/8。
前缀及更具体的路由 10.0.0.0/8+ 10.0.0.0/8 以及每个更具体的子网。
精确长度 10.0.0.0/8{16} 10.0.0.0/8 内的每个 /16 子网。
长度范围 10.0.0.0/8{16,24} 该前缀内从 /16 到 /24 的每个子网。

每条隧道支持一个导入过滤器和一个导出过滤器。

导入过滤器适用于 Cloudflare 从对等体接收的路由。被拒绝的路由不会进入 Magic 路由表。 被拒绝的路由仍保留在本地路由信息库 (RIB-in) 中。将过滤器放宽后,这些路由会在无需路由刷新的情况下加入 Magic 路由表。

导出过滤器适用于选择向对等体播发的路由。隧道 extra_prefixes 字段中的前缀会绕过导出过滤器。

创建配置文件

  1. 转到 Routes(路由) 页面。

    前往 Routes(路由) ↗
  2. 在 BGP filter profiles(BGP 过滤配置文件) 选项卡中,选择 Create filter profile(创建过滤配置文件)。

  3. 为过滤配置文件输入描述性 Name(名称),并可选择添加 Description(描述)。

  4. 选择 Allow(允许) 或 Deny(拒绝) 作为路由匹配目标时要执行的 Action(操作)。

  5. 在 CIDR prefix(CIDR 前缀) 中输入 CIDR 前缀以添加 Target(目标)。选择此目标应使用的 Match(匹配) 模式。

  6. 如果要添加更多目标,选择 Add target(添加目标)。

  7. 选择 Create(创建)。

使用 API 需要你的账户 ID 和 API token。

以下请求会为企业子网创建一个 allow 配置文件:

Create BGP Filter Profilebash
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/magic/bgp/filter_profiles" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"name": "Allowed on-premises imports",
		"description": "Corporate subnets accepted from the customer router",
		"match_action": "allow",
		"targets": [
				"10.0.0.0/8+",
				"192.168.0.0/16",
				"2001:db8::/32+"
		]
	}'

配置文件目标具有以下要求:

  • 目标必须使用有效的 CIDR 网络地址,且不含空格。Cloudflare 会拒绝重复或等价的目标。
  • 配置文件支持 IPv4 和 IPv6 目标,但不支持 IPv4 映射的 IPv6 目标。

分配配置文件

  1. 转到 Connectors(连接器) 页面并选择 IPsec/GRE tunnels(IPsec/GRE 隧道)。

    前往 Connectors(连接器) ↗
  2. 选择 Create a tunnel(创建隧道) 以创建新隧道,或从现有隧道旁边的三点菜单中选择 Configure BGP(配置 BGP)。

  3. 从 Import filter profile(导入过滤配置文件) 中选择一个配置文件。要移除它,请选择所选配置文件旁边的 X。

  4. 对 Export filter profile(导出过滤配置文件) 重复此操作。

  5. 选择 Add tunnels(添加隧道) 或 Save(保存)。

以下请求将导入和导出配置文件分配给 GRE 隧道。将每个字段设置为您账户中的配置文件 ID。

Required API token permissions

At least one of the following token permissions is required:
  • Magic WAN Write
  • Magic Transit Write
Update GRE Tunnelbash
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/magic/gre_tunnels/$GRE_TUNNEL_ID" \
	--request PUT \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"bgp": {
				"import_filter_id": "a1b2c3d4e5f647890a1b2c3d4e5f6789",
				"export_filter_id": "b2c3d4e5f6a78901b2c3d4e5f6a78901"
		}
	}'

要移除已分配的配置文件,请将其对应字段设置为 null。

配置文件分配具有以下行为和限制:

  • 更改配置文件或隧道的配置文件分配不会重置 BGP 会话。
  • 您无法删除正在使用的配置文件。请先从所有隧道分离该配置文件。
  • Cloudflare 在导入过滤之前强制执行 5,000 条路由的 RIB-in 限制。被拒绝的路由仍计入此限制。

这篇文档对您有帮助吗?