目  录

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 arp-request

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 vpn-instance

1.1.10 ip route-static-group

1.1.11 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

     NewUK0: 0x0                 NewUK1: 0x0

     NewUK2: 0x0                 NewUK3: 0x0

     NewUK4: 0x0                 NewUK5: 0x0

     NewUK6: 0x0                 NewUK7: 0x0

   TopoNthp: 0                  ExtType: 0x0

    FIRType: Normal           Threshold: 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

     NewUK0: 0x0                 NewUK1: 0x0

     NewUK2: 0x0                 NewUK3: 0x0

     NewUK4: 0x0                 NewUK5: 0x0

     NewUK6: 0x0                 NewUK7: 0x0

   TopoNthp: 0                  ExtType: 0x0

    FIRType: Normal           Threshold: 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	本地接口地址
NewUK0	第一个新的协议保留数据
NewUK1	第二个新的协议保留数据
NewUK2	第三个新的协议保留数据
NewUK3	第四个新的协议保留数据
NewUK4	第五个新的协议保留数据
NewUK5	第六个新的协议保留数据
NewUK6	第七个新的协议保留数据
NewUK7	第八个新的协议保留数据
TopoNthp	（暂不支持子拓扑）下一跳所在拓扑索引，显示为0表示公网拓扑
ExtType	NIB扩展类型
FIRType	（暂不支持）等价路由FIR模式中下一跳所在链路的类型，取值包括： ·     Normal：表示普通链路 ·     Primary：表示主用链路 ·     Secondary：表示备用链路
Threshold	（暂不支持）等价路由FIR模式中主用链路的带宽使用率等级

 

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

<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

     NewUK0: 0x0                 NewUK1: 0x0

     NewUK2: 0x0                 NewUK3: 0x0

     NewUK4: 0x0                 NewUK5: 0x0

     NewUK6: 0x0                 NewUK7: 0x0

   TopoNthp: 0                  ExtType: 0x0

    FIRType: Normal           Threshold: 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

RealFIRType: Normal           RealThres: 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

     NewUK0: 0x0                 NewUK1: 0x0

     NewUK2: 0x0                 NewUK3: 0x0

     NewUK4: 0x0                 NewUK5: 0x0

     NewUK6: 0x0                 NewUK7: 0x0

   TopoNthp: 0                  ExtType: 0x0

    FIRType: Normal           Threshold: 0

     RefCnt: 1              FlushRefCnt: 0

       Flag: 0x12               Version: 1

    ExtFlag: 0x0

 2 nexthop(s):

PrefixIndex: 0              OrigNexthop: 2.2.2.2

  RelyDepth: 7              RealNexthop: 8.8.8.8

  Interface: Vlan11           LocalAddr: 12.12.12.12

  TunnelCnt: 0                      Vrf: default-vrf

   TunnelID: N/A               Topology: base

     Weight: 1000000              Flags: 0x0

RealFIRType: Normal           RealThres: 0

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

RealFIRType: Normal           RealThres: 0

 

...

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

字段	描述
NibID	NIB ID号
Sequence	NIB序列号
Type	NIB类型
Flushed	是否下刷FIB
Age	下一跳信息最近一次更新的时间
UserKey0	NIB协议保留数据1
VrfNthp	下一跳所在VPN索引，显示为0表示公网
UserKey1	NIB协议保留数据2
Nexthop	下一跳信息
IFIndex	接口索引
LocalAddr	本地接口地址
NewUK0	第一个新的协议保留数据
NewUK1	第二个新的协议保留数据
NewUK2	第三个新的协议保留数据
NewUK3	第四个新的协议保留数据
NewUK4	第五个新的协议保留数据
NewUK5	第六个新的协议保留数据
NewUK6	第七个新的协议保留数据
NewUK7	第八个新的协议保留数据
TopoNthp	（暂不支持子拓扑）下一跳所在拓扑索引，显示为0表示公网拓扑
ExtType	NIB扩展类型
FIRType	（暂不支持）等价路由FIR模式中下一跳所在链路的类型，取值包括： ·     Normal：表示普通链路 ·     Primary：表示主用链路 ·     Secondary：表示备用链路
Threshold	（暂不支持）等价路由FIR模式中主用链路的带宽使用率等级
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	当前下一跳的标志位
RealFIRType	（暂不支持）等价路由FIR模式中真实下一跳所在链路的类型，取值包括： ·     Normal：表示普通链路 ·     Primary：表示主用链路 ·     Secondary：表示备用链路 真实下一跳是路由经过迭代找到的直连下一跳
RealThres	（暂不支持）等价路由FIR模式中，真实下一跳所在主用链路的带宽使用率等级

 

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: Vlan-interface11

     TableID: 0x2           BkInterface: Vlan-interface12

        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

     FIRType: Normal          Threshold: 0

  MicroSegID: 0          RecurseMaskLen: N/A

  FIRLicense: Unrestricted

 

 Destination: 0.0.0.0/0

       NibID: 0x1100000b        NextHop: 2.2.2.11

   MainNibID: N/A             BkNextHop: N/A

     BkNibID: N/A             Interface: Vlan-interface13

     TableID: 0x2           BkInterface: Vlan-interface14

        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

     FIRType: Normal          Threshold: 0

  MicroSegID: 0          RecurseMaskLen: N/A

  FIRLicense: Unrestricted

 

...

表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类型的静态路由 ·     IPSGT：IP-SGT类型的静态路由
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	路由标记
FIRType	（暂不支持）等价路由FIR模式中下一跳所在链路的类型，取值包括： ·     Normal：表示普通链路 ·     Primary：表示主用链路 ·     Secondary：表示备用链路
Threshold	（暂不支持）等价路由FIR模式中主用链路的带宽使用率等级
MicroSegID	（暂不支持）路由携带的微分段ID
RecurseMaskLen	路由迭代时精确匹配的掩码长度（N/A表示采用最长匹配原则进行路由迭代）
FIRLicense	（暂不支持）控制等价静态路由FIR模式的License进程状态，取值包括： ·     Unrestricted：表示等价静态路由FIR模式不受License控制 ·     Disconnected：表示等价静态路由FIR模式受License控制，但是静态路由未连上License进程，请检查License进程是否异常 ·     Active：表示控制等价静态路由FIR模式的License处于有效状态 ·     Inactive：表示控制等价静态路由FIR模式的License处于失效状态 有关License的详细介绍，请参见“基础配置指导”中的“License管理”

 

1.1.4  ip route-static

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

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

【命令】

ip route-static dest-address { mask-length | mask } interface-type interface-number [ next-hop-address [ nexthop-index index-string ] ] [ backup-interface interface-type interface-number [ backup-nexthop backup-nexthop-address ] [ permanent ] | bfd { control-packet | echo-packet } | permanent | track track-entry-number ] [ preference preference ] [ tag tag-value ] [ recursive-lookup ] [ description text ]

ip route-static dest-address { mask-length | mask } interface-type interface-number next-hop-address [  nexthop-index index-string ] track-arp [ preference preference ] [ tag tag-value ] [ description text ]

ip route-static dest-address { mask-length | mask } next-hop-address [ nexthop-index index-string ] [ recursive-lookup host-route ] [ bfd control-packet bfd-source ip-address | permanent | track track-entry-number ] [ preference preference ] [ tag tag-value ] [ recursive-lookup ] [ description text ]

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

ip route-static 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 } | permanent | track track-entry-number ] [ preference preference ] [ tag tag-value ] [ recursive-lookup ] [ description text ]

ip route-static group group-name interface-type interface-number next-hop-address track-arp [ preference preference ] [ tag tag-value ] [ description text ]

ip route-static  group group-name next-hop-address [ recursive-lookup host-route ] [ bfd control-packet bfd-source ip-address | permanent | track track-entry-number ] [ preference preference ] [ tag tag-value ] [ recursive-lookup ] [ description text ]

ip route-static group group-name vpn-instance d-vpn-instance-name next-hop-address [ recursive-lookup host-route ] [ bfd control-packet bfd-source ip-address | permanent | track track-entry-number ] [ preference preference ] [ tag tag-value ] [ recursive-lookup ] [ 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 ]

【缺省情况】

未配置静态路由。

【视图】

系统视图

【缺省用户角色】

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中查找出接口。

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

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

nexthop-index index-string：指定路由的下一跳的索引标识。index-string表示索引标识，为1～93个字符的字符串，不区分大小写。如果未指定本参数，静态路由采用出接口和下一跳的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，双向转发检测）功能，对静态路由下一跳的可达性进行快速检测，当下一跳不可达时可以快速切换到备份路由。

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

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

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

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

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

track-arp：将静态路由与下一跳对应的ARP表项相关联。指定本参数后，当静态路由下一跳对应的ARP表项不存在时，该静态路由不激活。如果不指定本参数，则静态路由的激活状态与ARP表项无关。当使用本参数指定静态路由与下一跳对应的ARP表项联动时，建议通过ip route-static arp-request命令配置设备周期性向静态路由下一跳发送ARP请求，以免ARP表项老化导致该静态路由不激活。

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

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

recursive-lookup：开启静态路由下一跳循环迭代功能（即允许迭代到更大网段的路由）。如果不指定本参数，则表示关闭静态路由的下一跳循环迭代功能。

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

【使用指导】

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

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

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

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

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

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

·     对于广播类型接口，需要通过下一跳IP地址来获取下一跳的物理地址，配置时需要指定出接口和下一跳IP地址。特殊情况下也可以不配置下一跳IP地址，比如VXLAN的跨VPN引流组网。

配置静态路由时需要注意的是：

·     路由震荡时，使能BFD检测功能可能会加剧震荡，需谨慎使用。关于BFD的详细介绍，请参考“可靠性配置指导”中的“BFD”。

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

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

·     参数permanent不能和bfd、track一起进行配置。

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

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

静态路由进行路由迭代时，若迭代路由的目的地址范围包含该静态路由的目的地址，例如某条静态路由10.1.0.0/24的迭代路由的目的地址为10.1.0.0/16，则认为发生了循环迭代。在开启静态路由下一跳循环迭代功能之前，循环迭代会导致本次迭代失败并继续进行路由迭代。在开启静态路由下一跳循环迭代功能之后，只要迭代路由的出接口为设备的直连出接口，则即使发生了循环迭代，也认为本次迭代成功。经过循环迭代找到出接口的静态路由不允许被其他路由协议发布到其他设备。建议仅在某些特殊场景下开启循环迭代功能，例如在配置了微分段的组网环境下，需要允许静态路由进行循环迭代，从而可以迭代到目的地址范围较大的网段，并执行对应网段配置的流量控制策略。

参数recursive-lookup host-route和recursive-lookup互斥，不能同时配置。

【举例】

# 配置静态路由，其目的地址为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）

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

·     ip route-static-group

·     prefix

1.1.5  ip route-static arp-request

ip route-static arp-request命令用来配置向静态路由下一跳发送ARP请求功能。

undo ip route-static arp-request命令用来关闭向静态路由下一跳发送ARP请求功能。

【命令】

ip route-static arp-request [ interval interval ]

undo ip route-static arp-request

【缺省情况】

静态路由发送ARP请求功能处于关闭状态。

【视图】

系统视图

【缺省用户角色】

network-admin

【参数】

interval：发送ARP请求的时间间隔，取值范围为1～300，单位为秒，缺省值为5。

【使用指导】

设备上存在如下类型静态路由时，建议配置本命令：

·     迭代到主机路由的静态路由，包括指定recursive-lookup host-route参数只能迭代到主机路由的静态路由，或按照路由策略迭代到主机路由（通过protocol nexthop recursive-lookup命令配置）的静态路由。如果因下一跳主机不主动发送免费ARP等原因，可能会导致设备上该主机对应的ARP表项无法及时更新而老化，从而造成设备上无法生成该主机的主机路由、下一跳为该主机的静态路由因迭代到主机路由失败而无法激活。

·     指定了track-arp参数将下一跳与ARP表项相关联的静态路由。如果因下一跳不主动发送免费ARP等原因，可能会导致设备上该下一跳地址对应的ARP表项无法及时更新而老化删除，从而造成该静态路由不激活。

配置本命令后，对于迭代到主机路由的静态路由，设备将按照设置的时间间隔周期性地向不带出接口且下一跳迭代主机路由失败的静态路由下一跳发送ARP请求，当收到主机的ARP应答后，设备会将该主机路由添加到路由表中，迭代到该主机路由的静态路由便会自动激活，这时设备停止向该静态路由下一跳发送ARP请求；对于指定了track-arp参数将下一跳与ARP表项相关联的静态路由，设备将按照设置的时间间隔周期性地向关联ARP表项的静态路由下一跳发送ARP请求，当收到下一跳的ARP应答后，该静态路由便会自动激活，这时设备停止向该静态路由下一跳发送ARP请求。

有关ARP的详细介绍，请参见“三层技术-IP业务配置指导”中的“ARP”。

【举例】

# 配置向静态路由下一跳发送ARP请求功能，且发送时间间隔为10秒。

<Sysname> system-view

[Sysname] ip route-static arp-request interval 10

【相关命令】

·     ip route-static

·     protocol nexthop recursive-lookup（三层技术-IP路由命令参考/IP路由基础）

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 vlan-interface 10 2.2.2.2 backup-interface vlan-interface 11 backup-nexthop 3.3.3.3

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

1.1.9  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 [ nexthop-index index-string ] ] [ backup-interface interface-type interface-number [ backup-nexthop backup-nexthop-address ] [ permanent ] | bfd { control-packet | echo-packet } | permanent | track track-entry-number ] [ preference preference ] [ tag tag-value ] [ recursive-lookup ] [ description text ]

ip route-static vpn-instance s-vpn-instance-name  dest-address { mask-length | mask } interface-type interface-number next-hop-address [ nexthop-index index-string ] track-arp [ preference preference ] [ tag tag-value ] [ 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 [ nexthop-index index-string ] [ recursive-lookup host-route ] [ bfd control-packet bfd-source ip-address | permanent | track track-entry-number ] [ preference preference ] [ tag tag-value ] [ recursive-lookup ] [ description text ]

ip route-static vpn-instance s-vpn-instance-name dest-address { mask-length | mask } next-hop-address [ nexthop-index index-string ] [ recursive-lookup host-route ] [ public ] [ bfd control-packet bfd-source ip-address | permanent | track track-entry-number ] [ preference preference ] [ tag tag-value ] [ recursive-lookup ] [ 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 } | backup-interface interface-type interface-number [ backup-nexthop backup-nexthop-address ] [ permanent ] ] [ preference preference ] [ tag tag-value ] [ recursive-lookup ] [ description text ]

ip route-static vpn-instance s-vpn-instance-name group group-name interface-type interface-number next-hop-address track-arp [ preference preference ] [ tag tag-value ] [ 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 | permanent | track track-entry-number ] [ preference preference ] [ tag tag-value ] [ recursive-lookup ] [ description text ]

ip route-static vpn-instance s-vpn-instance-name group group-name vpn-instance d-vpn-instance-name next-hop-address [ recursive-lookup host-route ] [ bfd control-packet bfd-source ip-address | permanent | track track-entry-number ] [ preference preference ] [ tag tag-value ] [ recursive-lookup ] [ 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 ]

【缺省情况】

未为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中查找出接口。

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

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

nexthop-index index-string：指定路由的下一跳的索引标识。index-string表示索引标识，为1～93个字符的字符串，不区分大小写。如果未指定本参数，静态路由采用出接口和下一跳的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，双向转发检测）功能，对静态路由下一跳的可达性进行快速检测，当下一跳不可达时可以快速切换到备份路由。

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

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

echo-packet：通过BFD echo报文方式实现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实例中查找出接口。

track-arp：将静态路由与下一跳对应的ARP表项相关联。指定本参数后，当静态路由下一跳对应的ARP表项不存在时，该静态路由不激活。如果不指定本参数，则静态路由的激活状态与ARP表项无关。当使用本参数指定静态路由与下一跳对应的ARP表项联动时，建议通过ip route-static arp-request命令配置设备周期性向静态路由下一跳发送ARP请求，以免ARP表项老化导致该静态路由不激活。

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

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

recursive-lookup：开启静态路由下一跳循环迭代功能（即允许迭代到更大网段的路由）。如果不指定本参数，则表示关闭静态路由的下一跳循环迭代功能。

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

【使用指导】

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

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

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

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

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

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

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

配置静态路由时需要注意的是：

·     路由震荡时，使能BFD检测功能可能会加剧震荡，需谨慎使用。关于BFD的详细介绍，请参考“可靠性配置指导”中的“BFD”。

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

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

·     参数permanent不能和bfd、track一起进行配置。

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

静态路由进行路由迭代时，若迭代路由的目的地址范围包含该静态路由的目的地址，例如某条静态路由10.1.0.0/24的迭代路由的目的地址为10.1.0.0/16，则认为发生了循环迭代。在开启静态路由下一跳循环迭代功能之前，循环迭代会导致本次迭代失败并继续进行路由迭代。在开启静态路由下一跳循环迭代功能之后，只要迭代路由的出接口为设备的直连出接口，则即使发生了循环迭代，也认为本次迭代成功。经过循环迭代找到出接口的静态路由不允许被其他路由协议发布到其他设备。建议仅在某些特殊场景下开启循环迭代功能，例如在配置了微分段的组网环境下，需要允许静态路由进行循环迭代，从而可以迭代到目的地址范围较大的网段，并执行对应网段配置的流量控制策略。

参数recursive-lookup host-route和recursive-lookup互斥，不能同时配置。

【举例】

# 为实例名为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.10  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.11  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