首页/网络/BGP 与广域网速查/常用 set 语句清单
路由过滤与重分发66 条

常用 set 语句清单

BGP 策略中高频 set 语句:LOCAL_PREF、MED、weight、community、扩展社区、AS_PATH 预置、origin、next-hop、tag;各应用点支持的语句集合不同。

BGP 与广域网速查网络更新于 2026-10-13

set 语句一览

route-map 的 set 部分决定命中之后改写哪些属性。BGP 场景中最常用的是 LOCAL_PREF、MED、weight、community、扩展社区与 AS_PATH 预置;重分发场景还会用到 origin、tag 与 metric-type。每条 set 语句都有适用范围,写错方向或写在不支持的位置上时,配置能敲进去但不会产生效果。

  • set local-preference 150 —— 本 AS 出口偏好,仅 iBGP 邻居间传播
  • set metric 50 —— 设置 MED,传给 eBGP 对端,出 AS 不再传播
  • set weight 200 —— 本机权重,优先级最高且不对外传播
  • set community 65001:100 additive —— 追加社区标签,需邻居开启 send-community
  • set extcommunity rt 65001:100 additive —— 设置 VPN 路由目标(RT)
  • set as-path prepend 65001 65001 —— 加长 AS_PATH,仅在 eBGP 出方向有效
  • set origin igp —— 改写 ORIGIN,慎用以免掩盖真实来源
  • set tag 100 —— 重分发场景写入路由标记,用于防环
  • set metric-type type-1 —— 重分发到 OSPF 时指定外部路由类型
  • set ip next-hop 10.0.0.1 —— 改写下一跳,需保证对端可解析该地址

属性适用范围

set 对象传播范围常见误用
weight仅本机用在出方向期待对端感知
LOCAL_PREF本 AS 内 iBGP对 eBGP 出向设置,属性被剥离
MED传给 eBGP 对端,不再向后期待跨多跳 AS 传递
community可选传递,跨 AS 有效未开启 send-community
prependeBGP 出方向对 iBGP 邻居配置,无效果
tagIGP 内部使用期待 BGP 承载该字段

组合示例

组合示例
route-map RM-MIX permit 10
 match ip address prefix-list PFX-BIZ
 set local-preference 150
 set metric 50
 set community 65001:150 additive
!
router bgp 65001
 neighbor 10.0.0.2 route-map RM-MIX in
!
show ip bgp 10.100.0.0/16
# 核对 LocPrf / Metric / Community 三列

重分发场景的 set

重分发场景的 set
route-map RM-BGP2OSPF permit 10
 match ip address prefix-list PL-AGG
 set metric 100
 set metric-type type-2
 set tag 65001
!
router ospf 1
 redistribute bgp 65001 subnets route-map RM-BGP2OSPF
!
show ip ospf database external

基本信息

序列顺序自上而下匹配,命中即止
缺省行为未命中任何 permit 时按拒绝处理
生效时机入向立即影响本机选路,出向需软刷新让对端重收
验证命令show route-map <名> 看命中计数,show ip bgp <前缀> 看属性
命名建议名称体现方向与业务,例如 RM-CUST-A-IN
set origin 与 set ip next-hop 属于会掩盖真实信息的改写:前者让路由看起来来自 IGP,后者可能指向不可达地址导致路由失效。使用前先确认排障时仍能还原真实来源。

改写后的核对清单

  • 确认 route-map 的引用方向:入向影响本机选路,出向影响对端接收
  • 确认序列命中计数在增长,计数为零说明 match 条件没有匹配到任何路由
  • 用具体前缀的详细输出核对属性值,而不是只看路由数量是否变化
  • 出向改写后做一次软刷新,避免对端仍使用旧属性得出结论
  • 把本次改写的意图与回退方式写进变更记录,便于后续审计与撤销

易错点

  • 在错误方向使用 set 语句:如对 eBGP 出向设置 LOCAL_PREF,配置无效且无任何提示
  • 忽略属性适用范围:MED 出 AS 不传递、weight 不出本机,策略预期与实际不符
  • set 语句缺少 match:route-map 变成对所有路由无条件改写,影响面远超预期
  • 同时设置多个相关属性却不清楚比较顺序:weight 与 LOCAL_PREF 并存时前者决定结果
  • 改写下一跳但不验证可达性:路由存在却不被安装,问题表现为业务不通

数据来源与参考

  • Cisco: BGP route-map set 语句参考
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌