目  录

1 静态路由

1.1 静态路由配置命令

1.1.1 delete static-routes all

1.1.2 display route-static nib

1.1.3 display route-static routing-table

1.1.4 ip route-static

1.1.5 ip route-static bfd

1.1.6 ip route-static default-preference

1.1.7 ip route-static fast-reroute auto

1.1.8 ip route-static primary-path-detect bfd echo

1.1.9 ip route-static recursive-lookup segment-routing-ipv6

1.1.10 ip route-static recursive-lookup tunnel

1.1.11 ip route-static vpn-instance

1.1.12 ip route-static-group

1.1.13 prefix

 

1 静态路由

1.1  静态路由配置命令

1.1.1  delete static-routes all

delete static-routes all命令用来删除所有静态路由。

【命令】

delete [ vpn-instance vpn-instance-name ] static-routes all

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

vpn-instance vpn-instance-name：删除指定VPN实例的所有静态路由。vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。如果未指定本参数，则表示删除公网的所有静态路由。

【使用指导】

 

使用本命令删除静态路由时，系统会提示确认，确认后才会删除所配置的所有静态路由。

使用undo ip route-static命令可以删除一条静态路由，而使用delete static-routes all命令可以删除包括缺省路由在内的所有静态路由。

【举例】

# 删除所有静态路由。

<Sysname> system-view

[Sysname] delete static-routes all

This will erase all IPv4 static routes and their configurations, you must reconf

igure all static routes.

Are you sure?[Y/N]:y

【相关命令】

·     ip route-static

1.1.2  display route-static nib

display route-static nib命令用来显示静态路由下一跳信息。

【命令】

display route-static nib [ nib-id ] [ verbose ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

nib-id：路由邻居ID值，取值范围为十六进制数1～ffffffff。如果未指定本参数，则显示所有的静态路由下一跳信息。

verbose：显示详细信息。如果未指定本参数，则显示概要信息。

【举例】

# 显示静态路由下一跳信息。

<Sysname> display route-static nib

Total number of nexthop(s): 44

 

      NibID: 0x11000000        Sequence: 0

       Type: 0x21               Flushed: Yes

        Age: 00h01m50s

   UserKey0: 0x111              VrfNthp: 0

   UserKey1: 0x0                Nexthop: 0.0.0.0

    IFIndex: 0x111            LocalAddr: 0.0.0.0

 MemberPort: 0x0

   TopoNthp: 0                 ExtType1: 0x0

   ExtType2: 0x0

      Color: 0                   COFlag: 0x0

   SIDIndex: 0x0                SRPName:

 OriNexthop: 0.0.0.0

 

      NibID: 0x11000001        Sequence: 1

       Type: 0x41               Flushed: Yes

        Age: 00h01m50s

   UserKey0: 0x0                VrfNthp: 5

   UserKey1: 0x0                Nexthop: 2.2.2.2

    IFIndex: 0x0              LocalAddr: 0.0.0.0

 MemberPort: 0x0

   TopoNthp: 0                 ExtType1: 0x0

   ExtType2: 0x0

      Color: 0                   COFlag: 0x0

   SIDIndex: 0x0                SRPName:

 OriNexthop: 0.0.0.0

 

...

表1-1 display route-static nib命令显示信息描述表

字段	描述
Total number of nexthop(s)	总的下一跳个数
NibID	NIB ID号
Sequence	NIB序列号
Type	NIB类型
Flushed	是否下刷FIB
Age	下一跳信息最近一次更新的时间
UserKey0	NIB协议保留数据1
UserKey1	NIB协议保留数据2
VrfNthp	下一跳所在VPN索引，显示为0表示公网
Nexthop	下一跳信息
IFIndex	接口索引
LocalAddr	本地接口地址
MemberPort	聚合组成员端口的索引值
NewUK0	第一个新的协议保留数据，如果没有此属性，则不显示该字段
NewUK1	第二个新的协议保留数据，如果没有此属性，则不显示该字段
NewUK2	第三个新的协议保留数据，如果没有此属性，则不显示该字段
NewUK3	第四个新的协议保留数据，如果没有此属性，则不显示该字段
NewUK4	第五个新的协议保留数据，如果没有此属性，则不显示该字段
NewUK5	第六个新的协议保留数据，如果没有此属性，则不显示该字段
NewUK6	第七个新的协议保留数据，如果没有此属性，则不显示该字段
NewUK7	第八个新的协议保留数据，如果没有此属性，则不显示该字段
NewUK8	第九个新的协议保留数据，如果没有此属性，则不显示该字段
NewUK9	第十个新的协议保留数据，如果没有此属性，则不显示该字段
NewUK10	第十一个新的协议保留数据，如果没有此属性，则不显示该字段
NewUK11	第十二个新的协议保留数据，如果没有此属性，则不显示该字段
NewUK12	第十三个新的协议保留数据，如果没有此属性，则不显示该字段
TopoNthp	（暂不支持）下一跳所在拓扑索引，显示为0表示公网拓扑
ExtType1	第一个NIB扩展类型
ExtType2	第二个NIB扩展类型
Color	Color扩展团体属性
COFlag	Color属性的标志位
SIDIndex	SID的索引值
SRPName	SR-MPLS TE Policy的名称
OriNexthop	路由的原始下一跳地址，如果是从BGP更新消息中获得的路由，则该地址为接收到的消息中的下一跳IP地址

 

# 显示静态路由下一跳详细信息。

<Sysname> display route-static nib verbose

Total number of nexthop(s): 44

 

      NibID: 0x11000000        Sequence: 0

       Type: 0x21               Flushed: Yes

        Age: 00h01m50s

   UserKey0: 0x111              VrfNthp: 0

   UserKey1: 0x0                Nexthop: 0.0.0.0

    IFIndex: 0x111            LocalAddr: 0.0.0.0

 MemberPort: 0x0

   TopoNthp: 0                 ExtType1: 0x0

   ExtType2: 0x0

      Color: 0                   COFlag: 0x0

   SIDIndex: 0x0                SRPName:

 OriNexthop: 0.0.0.0

     RefCnt: 2              FlushRefCnt: 0

       Flag: 0x2                Version: 1

    ExtFlag: 0x0

 1 nexthop(s):

PrefixIndex: 0              OrigNexthop: 0.0.0.0

  RelyDepth: 0              RealNexthop: 0.0.0.0

  Interface: NULL0            LocalAddr: 0.0.0.0

  TunnelCnt: 0                      Vrf: default-vrf

   TunnelID: N/A               Topology: base

     Weight: 1000000              Flags: 0x0

SRPolicyNID: 4294967295     SRInterface:

ColorWeight: 0                  Locator: N/A

 MemberPort: N/A

 

      NibID: 0x11000001        Sequence: 1

       Type: 0x41               Flushed: Yes

        Age: 00h01m50s

   UserKey0: 0x0                VrfNthp: 5

   UserKey1: 0x0                Nexthop: 2.2.2.2

    IFIndex: 0x0              LocalAddr: 0.0.0.0

 MemberPort: 0x0

   TopoNthp: 0                 ExtType1: 0x0

   ExtType2: 0x0

      Color: 0                   COFlag: 0x0

   SIDIndex: 0x0                SRPName:

 OriNexthop: 0.0.0.0

     RefCnt: 1              FlushRefCnt: 0

       Flag: 0x12               Version: 1

    ExtFlag: 0x0

 1 nexthop(s):

PrefixIndex: 0              OrigNexthop: 2.2.2.2

  RelyDepth: 9              RealNexthop: 0.0.0.0

  Interface: NULL0            LocalAddr: 0.0.0.0

  TunnelCnt: 0                      Vrf: default-vrf

   TunnelID: N/A               Topology: base

     Weight: 1000000              Flags: 0x0

SRPolicyNID: 4294967295     SRInterface:

ColorWeight: 0                  Locator: N/A

 MemberPort: N/A

 

...

表1-2 display route-static nib verbose命令显示信息描述表

字段	描述
Total number of nexthop(s)	总的下一跳个数
NibID	NIB ID号
Sequence	NIB序列号
Type	NIB类型
Flushed	是否下刷FIB
Age	下一跳信息最近一次更新的时间
UserKey0	NIB协议保留数据1
VrfNthp	下一跳所在VPN索引，显示为0表示公网
UserKey1	NIB协议保留数据2
Nexthop	下一跳信息
IFIndex	接口索引
LocalAddr	本地接口地址
MemberPort	聚合组成员端口的索引值
NewUK0	第一个新的协议保留数据，如果没有此属性，则不显示该字段
NewUK1	第二个新的协议保留数据，如果没有此属性，则不显示该字段
NewUK2	第三个新的协议保留数据，如果没有此属性，则不显示该字段
NewUK3	第四个新的协议保留数据，如果没有此属性，则不显示该字段
NewUK4	第五个新的协议保留数据，如果没有此属性，则不显示该字段
NewUK5	第六个新的协议保留数据，如果没有此属性，则不显示该字段
NewUK6	第七个新的协议保留数据，如果没有此属性，则不显示该字段
NewUK7	第八个新的协议保留数据，如果没有此属性，则不显示该字段
NewUK8	第九个新的协议保留数据，如果没有此属性，则不显示该字段
NewUK9	第十个新的协议保留数据，如果没有此属性，则不显示该字段
NewUK10	第十一个新的协议保留数据，如果没有此属性，则不显示该字段
NewUK11	第十二个新的协议保留数据，如果没有此属性，则不显示该字段
NewUK12	第十三个新的协议保留数据，如果没有此属性，则不显示该字段
TopoNthp	（暂不支持）下一跳所在拓扑索引，显示为0表示公网拓扑
ExtType1	第一个NIB扩展类型
ExtType2	第二个NIB扩展类型
Color	Color扩展团体属性
COFlag	Color属性的标志位
SIDIndex	SID的索引值
SRPName	SR-MPLS TE Policy的名称
OriNexthop	路由的原始下一跳地址，如果是从BGP更新消息中获得的路由，则该地址为接收到的消息中的下一跳IP地址
RefCnt	下一跳信息的引用计数
FlushRefCnt	下一跳信息的下刷引用计数
Flag	下一跳信息的标志位
Version	下一跳信息的版本号
ExtFlag	下一跳信息的扩展标志位
x nexthop (s)	下一跳具体值（前面数值表示下一跳个数）
PrefixIndex	等价时下一跳序号
OrigNexthop	原始下一跳
RelyDepth	迭代深度
RealNexthop	真实下一跳
Interface	出接口
localAddr	本地接口地址
TunnelCnt	迭代到隧道的个数
Vrf	VPN实例名，显示为default-vrf表示公网
TunnelID	迭代到隧道的ID
Topology	（暂不支持）拓扑名称，显示为base表示公网拓扑
Weight	等价路由各路由的权重，取值为0表示不是等价路由
Flags	当前下一跳的标志位
SRPolicyNID	SR-MPLS TE Policy迭代路由的下一跳ID
SRInterface	SR-MPLS TE Policy迭代路由的出接口
ColorWeight	SR-MPLS TE Policy中Color属性的权重值
Locator	SID所属Locator段的IPv6前缀，N/A表示没有该属性
MemberPort	聚合组成员端口编号，N/A表示没有该属性

 

1.1.3  display route-static routing-table

display route-static routing-table命令用来显示静态路由表信息。

【命令】

display route-static routing-table [ vpn-instance vpn-instance-name ] [ ip-address { mask-length | mask } ]

【视图】

任意视图

【缺省用户角色】

network-admin

network-operator

【参数】

vpn-instance vpn-instance-name：显示指定VPN实例的信息。vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。如果未指定本参数，则显示公网的信息。

ip-address：目的IP地址，点分十进制。如果未指定本参数，则显示所有的静态路由表信息。

mask-length：网络掩码长度，取值范围为0～32。

mask：网络掩码，点分十进制格式。

【举例】

# 显示静态路由表信息。

<Sysname> display route-static routing-table

Total number of routes: 24

 

Status: * - valid

 

*Destination: 0.0.0.0/0

       NibID: 0x1100000a         NextHop: 2.2.2.10

   MainNibID: N/A              BkNextHop: N/A

     BkNibID: N/A              Interface: Ten-GigabitEthernet3/1/1

     TableID: 0x2            BkInterface: Ten-GigabitEthernet3/1/2

        Flag: 0x82d01           BfdSrcIp: N/A

     DbIndex: 0xd             BfdIfIndex: 0x0

        Type: Normal         BfdVrfIndex: 0

  TrackIndex: 0xffffffff           Label: NULL

  Preference: 60             vrfIndexDst: 0

     BfdMode: N/A             vrfIndexNH: 0

   Permanent: 0                      Tag: 0

   BfdStatic: bfd01

 

 Destination: 0.0.0.0/0

       NibID: 0x1100000b         NextHop: 2.2.2.11

   MainNibID: N/A              BkNextHop: N/A

     BkNibID: N/A              Interface: Ten-GigabitEthernet3/1/3

     TableID: 0x2            BkInterface: Ten-GigabitEthernet3/1/4

        Flag: 0x82d01           BfdSrcIp: N/A

     DbIndex: 0xd             BfdIfIndex: 0x0

        Type: Normal         BfdVrfIndex: 0

  TrackIndex: 0xffffffff           Label: NULL

  Preference: 60             vrfIndexDst: 0

     BfdMode: N/A             vrfIndexNH: 0

   Permanent: 0                      Tag: 0

 

...

表1-3 display route-static routing-table命令显示信息描述表

字段	描述
Total number of routes	总的路由条数
Destination	目的地址/掩码
NibID	下一跳信息ID
MainNibID	FRR静态路由主下一跳信息ID
BkNibID	FRR静态路由备下一跳信息ID
NextHop	此路由的下一跳地址
BkNextHop	此路由的备份下一跳地址
Interface	出接口，即到该目的网段的数据包将从此接口发出
BkInterface	备份出接口
TableID	路由所在的表ID
Flag	路由标志位
DbIndex	路由所在DB的DB索引
Type	路由类型： ·     Normal：普通类型的静态路由 ·     DHCP：DHCP类型的静态路由 ·     NAT：NAT类型的静态路由 ·     IPsec：IPsec类型的静态路由
BfdSrcIp	BFD非直连会话源地址
BfdIfIndex	BFD使用的接口索引
BfdVrfIndex	BFD所在VPN索引，显示为0表示公网
BfdMode	BFD模式： ·     N/A：未配置BFD会话 ·     Ctrl：控制报文方式的BFD会话 ·     Echo：echo报文方式的BFD会话
TrackIndex	NQA Track索引
Label	标签
Preference	路由优先级
vrfIndexDst	目的所在VPN索引，显示为0表示公网
vrfIndexNH	下一跳所在VPN索引，显示为0表示公网
Permanent	永久静态路由标志（1表示永久静态路由）
Tag	路由标记
BfdStatic	路由关联的静态BFD会话名称。如果未配置，则不显示该字段

 

1.1.4  ip route-static

ip route-static命令用来配置静态路由。

undo ip route-static命令用来删除指定的静态路由。

【命令】

ip route-static { dest-address { mask-length | mask } | group group-name } { interface-type interface-number [ next-hop-address ] [ backup-interface interface-type interface-number [ backup-nexthop backup-nexthop-address ] [ permanent ] | bfd { control-packet | echo-packet | static session-name } | permanent | track track-entry-number ] | next-hop-address [ recursive-lookup host-route ] [ bfd { control-packet bfd-source ip-address | static session-name } | permanent | track track-entry-number ] | vpn-instance d-vpn-instance-name next-hop-address [ recursive-lookup host-route ] [ bfd { control-packet bfd-source ip-address | static session-name } | permanent | track track-entry-number ] } [ preference preference ] [ tag tag-value ] [ no-advertise ] [ description text ]

undo ip route-static { dest-address { mask-length | mask } | group group-name } [ interface-type interface-number [ next-hop-address ] | next-hop-address | vpn-instance d-vpn-instance-name next-hop-address ] [ preference preference ]

ip route-static { dest-address { mask-length | mask } | group group-name } vpn-instance d-vpn-instance-name [ preference preference ] [ tag tag-value ] [ no-advertise ] [ description text ]

undo ip route-static { dest-address { mask-length | mask } | group group-name } [ vpn-instance d-vpn-instance-name ]

ip route-static dest-address { mask-length | mask } sr-policy policy-name [ preference preference ] [ tag tag-value ] [ no-advertise ] [ description text ]

undo ip route-static dest-address { mask-length | mask } [ sr-policy policy-name ] [ preference preference ]

ip route-static dest-address { mask-length | mask } { remote-sid remote-sid locator-prefix-len | srv6-policy { color color-value end-point ipv6 ipv6-address | name policy-name } [ sid sid ] } * [ preference preference ] [ tag tag-value ] [ no-advertise ] [ description text ]

undo ip route-static dest-address { mask-length | mask } [ remote-sid remote-sid locator-prefix-len | srv6-policy { color color-value end-point ipv6 ipv6-address | name policy-name } ] * [ preference preference ]

【缺省情况】

未配置静态路由。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

dest-address：静态路由的目的IP地址，点分十进制格式。

mask-length：网络掩码长度，取值范围为0～32。

mask：网络掩码，点分十进制格式。

group group-name：指定静态路由配置组。group-name 表示配置组名称，为1～31个字符的字符串，区分大小写。

vpn-instance d-vpn-instance-name：指定目的VPN实例。d-vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。如果指定目的VPN实例，但未指定next-hop-address参数，则静态路由将在目的VPN实例中查找出接口。如果指定目的VPN实例，且指定了next-hop-address参数，静态路由将根据配置的next-hop-address在目的VPN中查找出接口。

interface-type interface-number：指定静态路由的出接口类型和接口号。在指定静态路由的出接口类型和接口号时需要注意的事项，详见使用指导。

next-hop-address：指定路由的下一跳的IP地址，点分十进制格式。在指定路由的下一跳的IP地址时需要注意的事项，详见使用指导。

recursive-lookup host-route：指定静态路由只能迭代到主机路由。

backup-interface interface-type interface-number：备份出接口。对于备份出接口为非P2P类型的接口时（包括NBMA类型接口或广播类型接口），必须同时指定其对应的备份下一跳地址。interface-type interface-number为指定的接口类型和编号。

backup-nexthop backup-nexthop-address：备份下一跳地址。

bfd：使能BFD（Bidirectional Forwarding Detection，双向转发检测）功能，对静态路由下一跳的可达性进行快速检测，当下一跳不可达时可以快速切换到备份路由。关于BFD的详细介绍，请参考“可靠性配置指导”中的“BFD”。

control-packet：通过BFD控制报文方式实现BFD功能。

bfd-source ip-address：BFD源IP地址。建议配置为Loopback接口IP地址。

echo-packet：通过BFD echo报文方式实现BFD功能。

static session-name：将静态路由与静态BFD会话相关联。session-name表示静态BFD会话名称，为1～64个字符的字符串，区分大小写。指定的静态BFD会话可以不存在，但要使配置生效，必须创建静态BFD会话。

permanent：指定为永久静态路由。指定本参数后，静态路由会一直生效，不受出接口状态的影响，即使在出接口down时，配置的永久静态路由仍然保持active状态。

track track-entry-number：将静态路由与Track项相关联，track-entry-number为Track项的序号，取值范围为1～1024。关于Track的详细介绍，请参见“可靠性配置指导”中的“Track”。

sr-policy policy-name：配置静态路由迭代到指定的SR-MPLS TE Policy。policy-name表示SR-MPLS TE Policy名称，为1～59个字符的字符串，区分大小写。有关SR-MPLS TE Policy的详细介绍，请参见“Segment Routing配置指导”中的“SR-MPLS TE Policy”。

remote-sid remote-sid locator-prefix-len：配置静态路由以SRv6 BE方式转发报文。remote-sid为SRv6 BE目的节点的SRv6 SID，locator-prefix-len为该SRv6 SID的Locator段的长度。根据remote-sid和locator-prefix-len可以唯一确定一个Locator段，设备将对报文进行SRv6封装，查找Locator段对应的IGP路由将报文转发出去。

srv6-policy name policy-name：配置静态路由迭代到指定名称的SRv6 TE Policy。policy-name表示SRv6 TE Policy名称，为1～59个字符的字符串，区分大小写。有关SRv6 TE Policy的详细介绍，请参见“Segment Routing配置指导”中的“SRv6 TE Policy”。

srv6-policy color color-value end-point ipv6 ipv6-address：配置静态路由迭代到指定Color值和目的节点地址的SRv6 TE Policy。color-value表示SRv6 TE Policy的Color值，取值范围0～4294967295。ipv6-address表示SRv6 TE Policy的Endpoint地址。

sid sid：指定尾节点的SRv6 SID。报文经SRv6 TE Policy转发后，再依据该SRv6 SID继续进行转发。

preference preference：指定静态路由的优先级，取值范围为1～255，缺省值为60。

tag tag-value：静态路由Tag值，用于标识该条静态路由，以便在路由策略中根据Tag对路由进行灵活的控制。tag-value的取值范围为1～4294967295，缺省值为0。关于路由策略的详细信息，请参见“三层技术-IP路由配置指导”中的“路由策略”。

no-advertise：指定静态路由不能对外发布，该静态路由可以被引入到IGP或BGP协议的路由表中，但不能发布给邻居。如果为同一个静态路由前缀配置了多个不同的下一跳，则只有最优路由才会下发到IP路由表中。在最优路由被引入到IGP或BGP协议的路由表时：

·     如果最优路由只有一个，需确保最优路由配置了本参数，否则该静态路由仍可以被发布出去。

·     如果最优路由有多个，则这些路由需要都配置本参数，否则未配置本参数的静态路由仍可以被发布出去。

description text：配置的静态路由描述信息，取值范围为1～150个字符。除“?”外，可以包含空格等特殊字符。

【使用指导】

如果目的IP地址和掩码都为0.0.0.0（或掩码为0），则配置的路由为缺省路由。当没有匹配的路由表项时，将使用缺省路由进行报文转发。

对不同的优先级配置，可采用不同的路由管理策略。例如，为同一目的地配置多条路由，如果指定相同的优先级，则实现路由负载分担；如果指定不同的优先级，则实现路由备份。

配置静态路由时，可根据实际需要指定出接口或下一跳地址。需要注意的是：

·     对于Null0接口，配置了出接口就不需要配置下一跳地址。

·     对于点到点接口，配置时可以只指定出接口，不指定下一跳地址。这样，即使对端地址发生了变化也无须改变配置。

·     对于NBMA、P2MP等接口，需要进行IP地址到链路层地址的映射，建议同时配置出接口和下一跳IP地址。

·     对于广播类型接口，因为可能有多个下一跳，配置时必须同时指定出接口和下一跳IP地址。

配置静态路由与BFD联动时，需要注意的是：

·     使用静态BFD会话检测静态路由下一跳的可达性时，需要将静态路由出接口的IP地址作为静态BFD会话的源地址，将静态路由下一跳的IP地址作为静态BFD会话的对端地址。

·     路由震荡时，使能BFD检测功能可能会加剧震荡，需谨慎使用。

配置静态路由关联Track项时，需要注意的是：

·     如果Track模块通过NQA探测私网静态路由中下一跳的可达性，静态路由下一跳的VPN实例号与NQA测试组配置的实例号必须相同，才能进行正常的探测。

·     在静态路由进行迭代时，Track项监测的应该是静态路由真正的下一跳，而不是配置的下一跳。否则，可能导致错误地将有效路由判断为无效路由。

当使用recursive-lookup host-route参数指定静态路由迭代到主机路由时，需要在下一跳对应的出接口上配置arp route-direct advertise命令开启ARP直连路由通告功能，通告32位主机路由。

按配置组配置静态路由时，配置组下的所有前缀会应用相同的下一跳、出接口信息。

如果同时配置remote-sid remote-sid locator-prefix-len和srv6-policy，则静态路由优先迭代到SRv6 TE Policy，当SRv6 TE Policy不可用时静态路由将以SRv6 BE方式转发报文。

参数remote-sid和sid互斥，不能同时配置。

【举例】

# 配置静态路由，其目的地址为1.1.1.1/24，指定下一跳为2.2.2.2，Tag值为45，描述信息为“for internet”。

<Sysname> system-view

[Sysname] ip route-static 1.1.1.1 24 2.2.2.2 tag 45 description for internet

【相关命令】

·     arp route-direct advertise（三层技术-IP业务命令参考/ARP）

·     bfd static（可靠性命令参考/BFD）

·     display ip routing-table protocol（三层技术-IP路由命令参考/IP路由基础）

·     ip route-static-group

·     prefix

1.1.5  ip route-static bfd

ip route-static bfd命令用来配置静态路由的BFD会话参数。

undo ip route-static bfd命令用来取消静态路由BFD会话参数的配置。

【命令】

控制报文方式单跳检测和echo报文方式检测的BFD会话参数：

ip route-static bfd interface-type interface-number next-hop-address { detect-multiplier detect-multiplier | min-echo-receive-interval min-echo-receive-interval | min-receive-interval min-receive-interval | min-transmit-interval min-transmit-interval } *

undo ip route-static bfd interface-type interface-number next-hop-address

控制报文方式多跳检测的会话参数：

ip route-static bfd [ vpn-instance d-vpn-instance-name ] next-hop-address source-ip ip-address { detect-multiplier detect-multiplier | min-receive-interval min-receive-interval | min-transmit-interval min-transmit-interval } *

undo ip route-static bfd [ vpn-instance d-vpn-instance-name ] next-hop-address

【缺省情况】

未配置静态路由的BFD会话参数，使用通用BFD会话参数作为静态路由的BFD会话参数。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

interface-type interface-number：指定静态路由的出接口类型和接口编号。

vpn-instance d-vpn-instance-name：指定目的VPN实例。d-vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。如果未指定本参数，表示静态路由的下一跳位于公网。

next-hop-address：指定路由的下一跳的IP地址，点分十进制格式。

source-ip ip-address：指定BFD报文的源IP地址，点分十进制格式。

detect-multiplier detect-multiplier：BFD检测时间倍数，取值范围为3～50。缺省值为5。

min-echo-receive-interval min-echo-receive-interval：接收echo报文的最小时间间隔，单位为毫秒。取值范围为3～10000。

min-receive-interval min-receive-interval：接收BFD控制报文的最小时间间隔，单位为毫秒。取值范围为3～10000。

min-transmit-interval min-transmit-interval：发送BFD控制报文的最小时间间隔，单位为毫秒。取值范围为3～10000。

【使用指导】

通过本命令可为单条静态路由提供BFD会话参数，静态路由BFD会话的检测时间=detect-multiplier×max（min-echo-receive-interval，min-receive-interval，min-transmit-interval），关于实际检测时间的计算方法请参见“可靠性命令参考”中的“BFD”。

指定了静态路由的出接口类型和接口号时，对于不同方式的BFD会话，能够生效的参数不同，具体如下：

·     对于echo报文方式的BFD会话，仅min-echo-receive-interval和detect-multiplier参数可以生效。

·     对于控制报文方式单跳检测的BFD会话，仅min-receive-interval、min-transmit-interval和detect-multiplier参数可以生效。

静态路由获取BFD会话参数的机制如下：

·     如果未配置任何静态路由的BFD会话参数，则所有静态路由均使用通用BFD会话参数。

·     如果配置了静态路由的BFD会话参数，获取BFD会话参数的方式如下：

¡     对于使用echo报文方式或控制报文方式单跳检测的静态路由，根据出接口和下一跳IP地址获取BFD会话参数。

¡     对于使用控制报文方式多跳检测的静态路由，根据下一跳IP地址与BFD源IP地址获取BFD会话参数。对于在目的VPN中查找出接口的静态路由，根据VPN实例、下一跳IP地址与BFD源IP地址获取BFD会话参数。

¡     如果本命令仅配置了部分BFD会话参数，则对于配置的BFD会话参数，静态路由使用本命令配置的值；对于未配置的参数，静态路由使用通用BFD会话参数。

【举例】

# 为出接口为Ten-GigabitEthernet3/1/1、下一跳地址为1.2.3.4的静态路由配置BFD会话参数：BFD检测时间倍数为20，接收BFD echo报文的最小时间间隔为1000毫秒。

<Sysname> system-view

[Sysname] ip route-static bfd ten-gigabitethernet 3/1/1 1.2.3.4 detect-multiplier 20 min-echo-receive-interval 1000

1.1.6  ip route-static default-preference

ip route-static default-preference命令用来配置静态路由的缺省优先级。

undo ip route-static default-preference命令用来恢复缺省情况。

【命令】

ip route-static default-preference default-preference

undo ip route-static default-preference

【缺省情况】

静态路由的缺省优先级为60。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

default-preference：静态路由缺省优先级的值，取值范围为1～255。

【使用指导】

如果在配置静态路由时没有指定优先级，就会使用缺省优先级。

重新配置缺省优先级后，新设置的缺省优先级仅对新增的静态路由有效。

【举例】

# 配置静态路由的缺省优先级为120。

<Sysname> system-view

[Sysname] ip route-static default-preference 120

【相关命令】

·     display ip routing-table protocol（三层技术-IP路由命令参考/IP路由基础）

1.1.7  ip route-static fast-reroute auto

ip route-static fast-reroute auto命令用来配置静态路由自动快速重路由功能。

undo ip route-static fast-reroute auto命令用来关闭静态路由自动快速重路由功能。

【命令】

ip route-static fast-reroute auto

undo ip route-static fast-reroute auto

【缺省情况】

静态路由自动快速重路由功能处于关闭状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【举例】

# 配置静态路由自动快速重路由功能。

<Sysname> system-view

[Sysname] ip route-static fast-reroute auto

1.1.8  ip route-static primary-path-detect bfd echo

ip route-static primary-path-detect bfd echo命令用来使能静态路由中主用链路的BFD（Echo方式）检测功能。

undo ip route-static primary-path-detect bfd命令用来关闭静态路由中主用链路的BFD（Echo方式）检测功能。

【命令】

ip route-static primary-path-detect bfd echo

undo ip route-static primary-path-detect bfd

【缺省情况】

静态路由中主用链路的BFD（Echo方式）检测功能处于关闭状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

配置本功能后，静态路由的快速重路由特性中的主用链路将使用BFD（Echo方式）进行检测。

【举例】

# 配置静态路由快速重路由特性中主用链路使能BFD（Echo方式）功能。

<Sysname> system-view

[Sysname] ip route-static 1.1.1.1 32 ten-gigabitethernet 3/1/1 2.2.2.2 backup-interface ten-gigabitethernet 3/1/2 backup-nexthop 3.3.3.3

[Sysname] ip route-static primary-path-detect bfd echo

1.1.9  ip route-static recursive-lookup segment-routing-ipv6

ip route-static recursive-lookup segment-routing-ipv6命令用来配置允许IPv4静态路由继承迭代路由的SRv6 SID信息。

undo ip route-static recursive-lookup segment-routing-ipv6命令用来恢复缺省情况。

【命令】

ip route-static recursive-lookup segment-routing-ipv6

undo ip route-static recursive-lookup segment-routing-ipv6

【缺省情况】

不允许IPv4静态路由继承迭代路由的SRv6 SID信息。

【视图】

系统视图

【缺省用户角色】

network-admin

【使用指导】

如果静态路由的下一跳不是直连的，则需要进行路由迭代。当静态路由的下一跳迭代到SRv6 BE或SRv6 TE Policy路径时，缺省情况下，静态路由不会继承迭代路由的SRv6 SID信息，即设备不会为满足匹配该静态路由的报文添加迭代路由的SRv6 SID信息。

配置本功能后，如果静态路由的下一跳迭代到了SRv6 BE或SRv6 TE Policy路径，则静态路由会继承迭代路由的SRv6 SID信息，设备会对匹配该静态路由的报文添加SID信息，然后添加SRv6封装信息、并将封装后的报文以SRv6 BE方式或通过SRv6 TE Policy转发出去。

有关SRv6 BE的详细介绍，请参见“Segment Routing配置指导”中的“IP L3VPN over SRv6”或“公网IP over SRv6”。有关SRv6 TE Policy的详细介绍，请参见“Segment Routing配置指导”中的“SRv6 TE Policy”。

【举例】

# 配置允许IPv4静态路由继承迭代路由的SRv6 SID信息。

<Sysname> system-view

[Sysname] ip route-static recursive-lookup segment-routing-ipv6

1.1.10  ip route-static recursive-lookup tunnel

ip route-static recursive-lookup tunnel命令用来配置允许静态路由迭代LSP隧道。

undo ip route-static recursive-lookup tunnel命令用来恢复缺省情况。

【命令】

ip route-static recursive-lookup tunnel [ prefix-list ipv4-prefix-list-name ] [ tunnel-policy tunnel-policy-name ]

undo ip route-static recursive-lookup tunnel

【缺省情况】

静态路由不能迭代到LSP隧道。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

prefix-list ipv4-prefix-list-name：IPv4地址前缀列表名，为1～63个字符的字符串，区分大小写。只有通过IP前缀列表过滤的静态路由才能迭代到LSP隧道。如果未指定本参数，则允许所有静态路由迭代到LSP隧道。

tunnel-policy tunnel-policy-name：隧道策略名称，为1～126字符的字符串，区分大小写。静态路由只能迭代到满足相应隧道策略的LSP隧道。如果未指定本参数，静态路由可以迭代到任意LSP隧道。

【使用指导】

缺省情况下，静态路由只能根据IP转发迭代到出接口和下一跳地址，不会迭代到LSP隧道。配置了该命令后，静态路由将优先迭代到LSP隧道。迭代LSP隧道失败后，可以按照IP转发迭代到出接口和下一跳。

在系统视图下多次执行本命令，最后一次执行的命令生效。

【举例】

# 配置允许静态路由迭代到LSP隧道。

<Sysname> system-view

[Sysname] ip route-static recursive-lookup tunnel

1.1.11  ip route-static vpn-instance

ip route-static vpn-instance命令用来为VPN实例配置静态路由。

undo ip route-static vpn-instance命令用来删除为VPN实例配置的静态路由。

【命令】

ip route-static vpn-instance s-vpn-instance-name dest-address { mask-length | mask } interface-type interface-number [ next-hop-address ] [ backup-interface interface-type interface-number [ backup-nexthop backup-nexthop-address ] ] [ permanent ] [ preference preference ] [ tag tag-value ] [ no-advertise ] [ description text ]

ip route-static vpn-instance s-vpn-instance-name dest-address { mask-length | mask } vpn-instance d-vpn-instance-name next-hop-address [ recursive-lookup host-route ] [ bfd { control-packet bfd-source ip-address | static session-name } | permanent | track track-entry-number ] [ preference preference ] [ tag tag-value ] [ no-advertise ] [ description text ]

ip route-static vpn-instance s-vpn-instance-name dest-address { mask-length | mask } next-hop-address [ recursive-lookup host-route ] [ public ] [ bfd { control-packet bfd-source ip-address | static session-name } | permanent | track track-entry-number ] ] [ preference preference ] [ tag tag-value ] [ no-advertise ] [ description text ]

ip route-static vpn-instance s-vpn-instance-name group group-name interface-type interface-number [ next-hop-address [ bfd { control-packet | echo-packet | static session-name } | backup-interface interface-type interface-number [ backup-nexthop backup-nexthop-address ] | permanent | track track-entry-number ] ] [ permanent | track track-entry-number ] [ preference preference ] [ tag tag-value ] [ no-advertise ] [ description text ]

ip route-static vpn-instance s-vpn-instance-name group group-name next-hop-address [ recursive-lookup host-route ] [ public ] [ bfd { control-packet bfd-source ip-address | static session-name } | permanent | track track-entry-number ] [ preference preference ] [ tag tag-value ] [ no-advertise ] [ description text ]

undo ip route-static vpn-instance s-vpn-instance-name { dest-address { mask-length | mask } | group group-name } [ interface-type interface-number [ next-hop-address ] | next-hop-address [ public ] | vpn-instance d-vpn-instance-name next-hop-address ] [ preference preference ]

ip route-static vpn-instance s-vpn-instance-name dest-address { mask-length | mask } { public | vpn-instance d-vpn-instance-name } [ preference preference ] [ tag tag-value ] [ no-advertise ] [ description text ]

ip route-static vpn-instance s-vpn-instance-name group group-name { public | vpn-instance d-vpn-instance-name } [ preference preference ] [ tag tag-value ] [ no-advertise ] [ description text ]

undo ip route-static vpn-instance s-vpn-instance-name { dest-address { mask-length | mask } | group group-name } [ public | vpn-instance d-vpn-instance-name ]

ip route-static vpn-instance s-vpn-instance-name dest-address { mask-length | mask } sr-policy policy-name [ preference preference ] [ tag tag-value ] [ no-advertise ] [ description text ]

undo ip route-static vpn-instance s-vpn-instance-name dest-address { mask-length | mask } [ sr-policy policy-name ] [ preference preference ]

ip route-static vpn-instance s-vpn-instance-name dest-address { mask-length | mask } { remote-sid remote-sid locator-prefix-len | srv6-policy { color color-value end-point ipv6 ipv6-address | name policy-name } [ sid sid ] } * [ preference preference ] [ tag tag-value ] [ no-advertise ] [ description text ]

undo ip route-static vpn-instance s-vpn-instance-name dest-address { mask-length | mask } [ remote-sid remote-sid locator-prefix-len | srv6-policy { color color-value end-point ipv6 ipv6-address | name policy-name } ] * [ preference preference ]

【缺省情况】

未为VPN实例配置静态路由。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

s-vpn-instance-name：MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。每个VPN实例都有自己的路由表，配置的静态路由将被加入指定VPN实例的路由表。

dest-address：静态路由的目的IP地址，点分十进制格式。

mask-length：网络掩码长度，取值范围为0～32。

mask：网络掩码，点分十进制格式。

group group-name：指定静态路由配置组。group-name 表示配置组名称，为1～31个字符的字符串，区分大小写。

vpn-instance d-vpn-instance-name：指定目的VPN实例。d-vpn-instance-name表示MPLS L3VPN的VPN实例名称，为1～31个字符的字符串，区分大小写。如果指定目的VPN实例，但未指定next-hop-address参数，则静态路由将在目的VPN实例中查找出接口。如果指定目的VPN实例，且指定了next-hop-address参数，静态路由将根据配置的next-hop-address在目的VPN中查找出接口。

interface-type interface-number：指定静态路由的出接口类型和接口号。在指定静态路由的出接口类型和接口号时需要注意的事项，详见使用指导。

next-hop-address：指定路由的下一跳的IP地址，点分十进制格式。在指定路由的下一跳的IP地址时需要注意的事项，详见使用指导。

recursive-lookup host-route：指定静态路由只能迭代到主机路由。

backup-interface interface-type interface-number：备份出接口。对于备份出接口为非P2P类型的接口时（包括NBMA类型接口或广播类型接口），必须同时指定其对应的备份下一跳地址。interface-type interface-number为指定的接口类型和编号。

backup-nexthop backup-nexthop-address：备份下一跳地址。

bfd：使能BFD（Bidirectional Forwarding Detection，双向转发检测）功能，对静态路由下一跳的可达性进行快速检测，当下一跳不可达时可以快速切换到备份路由。关于BFD的详细介绍，请参考“可靠性配置指导”中的“BFD”。

control-packet：通过BFD控制报文方式实现BFD功能。

bfd-source ip-address：BFD源IP地址。建议配置为Loopback接口IP地址。

echo-packet：通过BFD echo报文方式实现BFD功能。

static session-name：将静态路由与静态BFD会话相关联。session-name表示静态BFD会话名称，为1～64个字符的字符串，区分大小写。指定的静态BFD会话可以不存在，但要使配置生效，必须创建静态BFD会话。

permanent：指定为永久静态路由。指定本参数后，静态路由会一直生效，不受出接口状态的影响，即使在出接口down时，配置的永久静态路由仍然保持active状态。

track track-entry-number：将静态路由与Track项相关联，track-entry-number为Track项的序号，取值范围为1～1024。关于Track的详细介绍，请参见“可靠性配置指导”中的“Track”。

public：指定公网实例。如果指定next-hop-address参数后再指定公网实例，表示下一跳是公网地址，静态路由将根据next-hop-address在公网实例中查找出接口。如果仅指定next-hop-address参数，未指定公网实例，则静态路由将根据next-hop-address在源VPN实例中查找出接口。如果未指定next-hop-address参数，但指定公网实例，则静态路由将在公网实例中查找出接口。

sr-policy policy-name：配置静态路由迭代到指定的SR-MPLS TE Policy。policy-name表示SR-MPLS TE Policy名称，为1～59个字符的字符串，区分大小写。有关SR-MPLS TE Policy的详细介绍，请参见“Segment Routing配置指导”中的“SR-MPLS TE Policy”。

remote-sid remote-sid locator-prefix-len：配置静态路由以SRv6 BE方式转发报文。remote-sid为SRv6 BE目的节点的SRv6 SID，locator-prefix-len为该SRv6 SID的Locator段的长度。根据remote-sid和locator-prefix-len可以唯一确定一个Locator段，设备将对报文进行SRv6封装，查找Locator段对应的IGP路由将报文转发出去。

srv6-policy name policy-name：配置静态路由迭代到指定SRv6 TE Policy。policy-name表示SRv6 TE Policy名称，为1～59个字符的字符串，区分大小写。有关SRv6 TE Policy的详细介绍，请参见“Segment Routing配置指导”中的“SRv6 TE Policy”。

srv6-policy color color-value end-point ipv6 ipv6-address：配置静态路由迭代到指定Color值和目的节点地址的SRv6 TE Policy。color-value表示SRv6 TE Policy的Color值，取值范围0～4294967295。ipv6-address表示SRv6 TE Policy的Endpoint地址。

sid sid：指定尾节点的SRv6 SID。报文经SRv6 TE Policy转发后，再依据该SRv6 SID继续进行转发。

preference preference：指定静态路由的优先级，取值范围为1～255，缺省值为60。

tag tag-value：静态路由Tag值，用于标识该条静态路由，以便在路由策略中根据Tag对路由进行灵活的控制。tag-value的取值范围为1～4294967295，缺省值为0。关于路由策略的详细信息，请参见“三层技术-IP路由配置指导”中的“路由策略”。

no-advertise：指定静态路由不能对外发布，该静态路由可以被引入到IGP或BGP协议的路由表中，但不能发布给邻居。如果为同一个静态路由前缀配置了多个不同的下一跳，则只有最优路由才会下发到IP路由表中。在最优路由被引入到IGP或BGP协议的路由表时：

·     如果最优路由只有一个，需确保最优路由配置了本参数，否则该静态路由仍可以被发布出去。

·     如果最优路由有多个，则这些路由需要都配置本参数，否则未配置本参数的静态路由仍可以被发布出去。

description text：配置的静态路由描述信息，取值范围为1～150个字符。除“?”外，可以包含空格等特殊字符。

【使用指导】

如果目的IP地址和掩码都为0.0.0.0（或掩码为0），则配置的路由为缺省路由。当没有匹配的路由表项时，将使用缺省路由进行报文转发。

对不同的优先级配置，可采用不同的路由管理策略。例如，为同一目的地配置多条路由，如果指定相同的优先级，则实现路由负载分担；如果指定不同的优先级，则实现路由备份。

配置静态路由时，如果指定了目的VPN实例，但未指定下一跳地址，则源VPN实例和目的VPN实例不能相同。

配置静态路由时，可根据实际需要指定出接口或下一跳地址。需要注意的是：

·     对于Null0接口，配置了出接口就不需要配置下一跳地址。

·     对于点到点接口，配置时可以只指定出接口，不指定下一跳地址。这样，即使对端地址发生了变化也无须改变配置。

·     对于NBMA、P2MP等接口，需要进行IP地址到链路层地址的映射，建议同时配置出接口和下一跳IP地址。

·     对于广播类型接口，如以太网接口、VLAN接口等，因为可能有多个下一跳，配置时必须同时指定出接口和下一跳。

配置静态路由与BFD联动时，需要注意的是：

·     使用静态BFD会话检测静态路由下一跳的可达性时，需要将静态路由出接口的IP地址作为静态BFD会话的源地址，将静态路由下一跳的IP地址作为静态BFD会话的对端地址，静态BFD会话所属的VPN实例需要与下一跳所处的VPN实例相同。

·     路由震荡时，使能BFD检测功能可能会加剧震荡，需谨慎使用。

配置静态路由关联Track项时，需要注意的是：

·     如果Track模块通过NQA探测私网静态路由中下一跳的可达性，静态路由下一跳的VPN实例号与NQA测试组配置的实例号必须相同，才能进行正常的探测。

·     在静态路由进行迭代时，Track项监测的应该是静态路由真正的下一跳，而不是配置的下一跳。否则，可能导致错误地将有效路由判断为无效路由。

按配置组配置静态路由时，配置组下的所有前缀会应用相同的下一跳、出接口信息。如果配置组不存在或者配置组中没有任何前缀，则不会创建静态路由。

如果同时配置remote-sid remote-sid locator-prefix-len和srv6-policy，则静态路由优先迭代到SRv6 TE Policy，当SRv6 TE Policy不可用时静态路由将以SRv6 BE方式转发报文。

参数remote-sid和sid互斥，不能同时配置。

如果某VPN实例已经被指定为目的VPN实例，那么为此VPN实例配置静态路由时不支持vpn-instance d-vpn-instance-name参数。

配置指定目的VPN实例的静态路由时不支持除VXLAN隧道外的隧道。

若策略节点的动作只设置了报文的缺省下一跳和缺省SRv6 TE Policy，那么不能为此策略节点匹配规则包含的VPN实例配置静态路由，dest-address参数也不能是策略节点匹配规则中包含的目的IP地址。关于策略路由的详细介绍，请参考“三层技术-IP路由”中的“策略路由”。

【举例】

# 为实例名为vpn1的VPN实例配置静态路由，其目的地址为1.1.1.1/24，指定下一跳为VPN实例vpn2的地址2.2.2.2，Tag值为45，描述信息为“for internet”。

<Sysname> system-view

[Sysname] ip route-static vpn-instance vpn1 1.1.1.1 24 vpn-instance vpn2 2.2.2.2 tag 45 description for internet

【相关命令】

·     display ip routing-table protocol（三层技术-IP路由命令参考/IP路由基础）

·     ip route-static-group

·     prefix

1.1.12  ip route-static-group

ip route-static-group命令用来创建静态路由配置组，并进入静态路由配置组视图。如果指定的静态路由配置组已经存在，则直接进入静态路由配置组视图。

undo ip route-static-group命令用来删除静态路由配置组。

【命令】

ip route-static-group group-name

undo ip route-static-group group-name

【缺省情况】

不存在静态路由配置组。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

group-name：指定静态路由配置组。group-name表示静态路由配置组名称，为1～31个字符的字符串，区分大小写。

【举例】

# 创建静态路由配置组test，并进入静态路由配置组视图。

<Sysname> system-view

[Sysname] ip route-static-group test

[Sysname-route-static-group-test]

【相关命令】

·     ip route-static

·     prefix

1.1.13  prefix

prefix命令用来在静态路由配置组中增加前缀。

undo prefix命令用来在静态路由配置组中删除前缀。

【命令】

prefix dest-address { mask-length | mask }

undo prefix dest-address { mask-length | mask }

【缺省情况】

静态路由配置组中未配置前缀。

【视图】

静态路由配置组视图

【缺省用户角色】

network-admin

【参数】

dest-address：静态路由的目的IP地址，点分十进制格式。

mask-length：网络掩码长度，取值范围为0～32。

mask：网络掩码，点分十进制格式。

【使用指导】

在静态路由配置组视图下可以多次配置该命令，添加多个前缀，并通过命令ip route-static group批量创建静态路由；如果已经通过命令ip route-static group批量创建了静态路由，后续向配置组中增加前缀，则会一并生成该前缀对应的静态路由。

【举例】

# 在静态路由配置组test中，增加前缀1.1.1.1/32。

<Sysname> system-view

[Sysname] ip route-static-group test

[Sysname-route-static-group-test] prefix 1.1.1.1 32

【相关命令】

·     ip route-static

·     ip route-static-group