BIRD 中文文档

Appearance

第五章·第五节 路由属性 ​

⚠️ 注意

如果您发现了错误，欢迎 参与贡献。

💡 技巧小贴士

  • 本页内容较多，您可以使用 Ctrl/Command + F 快速查找本页面的关键词。

  • 如果想快速搜索全站内容，也可以在页面中单击 / 键 快速全文检索关键词。

  • 对于小屏用户，您可以点击右上角的 放大镜 (🔍) 图标以输入关键词进行全文检索。

请注意查看下方的本节目录，点击目录中的链接可以快速跳转到对应的内容。

📖 本节目录

💡 摘要 (Powered by OpenAI)

本文是 BIRD 用户指南的第五章第五节，主要介绍了 BIRD 的过滤器的路由属性 (Route Attributes)，包括路由表主键、路由类型、接口类型、MPLS 标签属性等内容。

基本概念 ​

过滤器隐含地传递 (implicitly passed) 了一条路由 (route)，并且它可以像访问变量一样访问其属性，包括常见的路由属性 (common route attributes)、特定协议的路由属性 (protocol-specific route attributes) 和自定义路由属性 (custom route attributes)。

  • 常见的路由属性 (common route attributes) 是强制性的（总被定义的），其余则为可选。
  • 尝试访问未定义的属性会导致运行时错误，可以使用 defined(attribute)来检查一个属性是否已被定义。对于这条规则的一个显著例外是 bgppath和*clist类型的属性，在大多数情况下，未定义的值被视为空的bgppath/*clist。
  • 属性 (attributes) 可以通过过滤器来定义。自定义属性必须首先通过 attribute 全局选项 声明。你可以使用 unset(attribute) 操作符来取消 (undefine) 可选属性。

常见的路由属性有：

💡 技巧小贴士

特定于协议的路由属性请参考 相应协议章节 中的描述。

路由表主键 ​

参见 关于路由 章节

  • 定义: net 前缀 (prefix) 或与路由 (route) 有关的任何其他内容
  • 类型: prefix
  • 值: 只读

路由类型 ​

路由范围 (Route Scope) ​

  • 定义: scope 路由范围 (route scope)
  • 类型: enum
  • 默认值: SCOPE_UNIVERSE
  • 值:
    • SCOPE_HOST 用于本地主机的路由
    • SCOPE_LINK 用于特定于物理链接的路由
    • SCOPE_SITE 和 SCOPE_ORGANIZATION 用于私有路由
    • SCOPE_UNIVERSE 用于全球可见的路由。
  • 此属性不被 BIRD 解释，可用于在过滤器中标记路由。

路由偏好 (Route Preference) ​

参见 关于路由 章节

  • 定义: preference 路由的偏好
  • 类型: int (整数)
  • 值: 0 - 65535

路由来源 (Source) ​

  • 定义: from 路由来源 (origination)
  • 类型: ip (IPv4 或 IPv6 地址)

路由网关 (Gateway) ​

  • 定义: gw 使用此路由转发的数据包应该被转发到的下一跳 (next hop)
  • 类型: ip (IPv4 或 IPv6 地址)

路由源协议 (Protocol) ​

  • 定义: proto 路由来源协议名称 (protocol name)
  • 类型: string (字符串)
  • 值: 只读

路由来源协议 (Source) ​

  • 定义: source 路由来源协议 (protocol)
  • 类型: enum (枚举)
  • 可选值:
    • RTS_STATIC 静态路由
    • RTS_INHERIT 继承路由
    • RTS_DEVICE 直连路由
    • RTS_RIP RIP 路由
    • RTS_OSPF OSPF 路由
      • RTS_OSPF_IA OSPF 间接路由
      • RTS_OSPF_EXT1 OSPF 外部类型 1 路由
      • RTS_OSPF_EXT2 OSPF 外部类型 2 路由
    • RTS_BGP BGP 路由
    • RTS_PIPE 管道路由
    • RTS_BABEL Babel 路由

数据包目的地类型 ​

  • 定义: dest 数据包转发目的地类型
  • 类型: enum (枚举)
  • 值:
    • RTD_ROUTER: 转发到邻近 (neighboring) 的路由器，只读
    • RTD_DEVICE: 转发到直接相联 (directly-connected) 的网络，只读
    • RTD_MULTIPATH: 转发到多重路径 (multipass) 目的地，只读
    • RTD_BLACKHOLE: 将被静默丢弃的数据包
    • RTD_UNREACHABLE: 返回 ICMP 主机不可达 (ICMP unreachable)
    • RTD_PROHIBIT: 返回 ICMP 管理禁止 (ICMP administratively prohibited) 消息的数据包

接口类型 ​

接口名 (Interface Name) ​

💡 技巧小贴士

英文汇聚路由 (sink routes)，比如：

  • 黑洞 (blockhole)
  • 不可达 (unreachable)
  • 禁止 (prohibit)
  • 多路径路由 (multipath routes)

没有关联的网络接口，因此 ifname 对于这些路由将返回空字符串 (empty string)。

注意

设置 ifname 会将路由被更改为直接路由，网关 (gateway) 会被取消设置。

  • 定义: 出口接口 (interface) 名称
  • 类型: string

接口索引 (Interface Index) ​

注意

创建/移除 iface 时索引可能会变化，并且对于未定义出站接口的路由会返回零 (zero)。

  • 定义: ifindex 出站接口的索引值 (index), 系统范围内的接口索引。可用于接口 (interface) 匹配
  • 类型: int
  • 值: 只读
  • 定义: onlink == true 表示指定的下一跳在接口上可访问，无视接口上配置的 IP 前缀。
  • 类型: bool
  • 值: true, false

通过设置 onlink = true, ifname 和 gw，可以使用 onlink 属性配置 下一跳 (next hop)

多路径权重 (Weight) ​

  • 定义: weight 路由下一跳的多路径权重
  • 类型: int
  • 值: 1 - 256

读取该数值将返回 第一个下一跳 (first next hop) 的权重，设置它则会将所有下一跳的权重设置为指定值。

因此，此属性对于操纵个别 ECMP 路由的下一跳不是很有用。

当然，在启用 merge paths 选项时，BGP 多路径 (BGP multipath) 与 ECMP 路由合并导出到 Kernel 协议时可以设置个别路由的权重。

MPLS 标签属性 ​

MPLS 出站标签 (MPLS Gateway) ​

💡 技巧小贴士

这是一个实验性选项，目前只支持第一个下一跳和标签堆栈中的一个标签，未来可能会更改以处理完整的 MPLS 标签堆栈 (full MPLS label stack)。

  • 定义: gw_mpls 路由的出站 MPLS 标签 (下一跳路由器对于此 标签交换路径 (label-switched path) 的入站 MPLS 标签)
  • 类型: int

读取返回标签值，设置它会将其设置到标签堆栈的开始。设置 隐式空标签 (implicit-NULL label)（3）会禁用 MPLS 标签堆栈。

内部度量 (Internal Metric) ​

  • 定义: igp_metric 指定对于没有 原生协议度量属性 (protocol metric attribute)（如 OSPF 路由的 ospf_metric1）的路由的网络距离。

主要被 BGP 用来比较到边界路由器的内部距离（见下文）。

  • 类型: int

MPLS 路由本地标签 (MPLS Label) ​

  • 定义: mpls_label 路由的本地 MPLS 标签
  • 类型: int

本属性由 MPLS 感知协议 (MPLS-aware protocols) 为带标签的路由生成。

可以在 导入过滤器 (import filter) 中设置实现 静态标签 (static label) 分配，但这也需要 静态 MPLS 标签策略 (static MPLS label policy)。

MPLS 标签策略 (MPLS Label Policy) ​

  • 定义: mpls_policy 对于 MPLS 感知协议 (MPLS-aware protocols), 此属性定义将用于路由的 MPLS 标签策略，可以在 导入过滤器 (import filter) 中设置它以更改每条路由的策略 (per-route basis)。
  • 类型: enum
  • 值:
    • MPLS_POLICY_NONE: 无标签
    • MPLS_POLICY_STATIC: 静态标签
    • MPLS_POLICY_PREFIX: 针对单一前缀的标签
    • MPLS_POLICY_AGGREGATE: 聚合标签
    • MPLS_POLICY_VRF: 针对单一 VRF 的标签

更多详情请参见 3-6 MPLS 标签策略

MPLS 类别 (MPLS Class) ​

  • 定义: mpls_class

当 MPLS 标签策略 被设置为 aggregate 时，可能需要比基于下一跳的单一聚合更精细的聚合。

当路由的此属性值不同时，即使它们有相同的下一跳，它们也不会在一个本地标签下聚合。

  • 类型: int

本文译者及原文信息 ​

Nelson

Nelson

译者

Hat

Hat

校对

展开原文属性

原文作者： <Ondrej Filip>, <Martin Mares>, <Maria Matejka>, <Ondrej Zajicek>

原文链接： https://bird.network.cz/?get_doc&v=20&f=bird-5.html#ss5.5

原文标题： 5.5 Route Attributes

展开译文属性

遵循协议： CC BY-NC-SA 4.0

译者： nelson

校对： hat

翻译时间： 2023-12-15

更新时间： 2024-09-17

本文链接： https://bird.xmsl.dev/docs/user-guide/5-5-route-attributes.html

译文采用 CC BY-NC-SA 4.0 协议发布

© 2025 BIRD 中文翻译计划 版权所有