目  录

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

1.1.9 ip route-static-group

1.1.10 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

   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

 

      NibID: 0x11000001        Sequence: 1

       Type: 0x41               Flushed: Yes

   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

 

......（省略部分显示信息）

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

字段	描述
Total number of nexthop(s)	总的下一跳个数
NibID	NIB ID号
Sequence	NIB序列号
Type	NIB类型
Flushed	是否下刷FIB
UserKey0	NIB协议保留数据1
UserKey1	NIB协议保留数据2
VrfNthp	下一跳所在VPN索引，显示为0表示公网
Nexthop	下一跳信息
IFIndex	接口索引
LocalAddr	本地接口地址
NewUK0	第一个新的协议保留数据
NewUK1	第二个新的协议保留数据
NewUK2	第三个新的协议保留数据
NewUK3	第四个新的协议保留数据
NewUK4	第五个新的协议保留数据
NewUK5	第六个新的协议保留数据
NewUK6	第七个新的协议保留数据
NewUK7	第八个新的协议保留数据
TopoNthp	下一跳所在拓扑索引，显示为0表示公网拓扑
ExtType	NIB扩展类型

 

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

<Sysname> display route-static nib verbose

Total number of nexthop(s): 44

 

      NibID: 0x11000000        Sequence: 0

       Type: 0x21               Flushed: Yes

   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

     RefCnt: 2              FlushRefCnt: 0

       Flag: 0x2                Version: 1

 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

 

      NibID: 0x11000001        Sequence: 1

       Type: 0x41               Flushed: Yes

   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

     RefCnt: 1              FlushRefCnt: 0

       Flag: 0x12               Version: 1

 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

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

 

......（省略部分显示信息）

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

字段	描述
NibID	NIB ID号
Sequence	NIB序列号
Type	NIB类型
Flushed	是否下刷FIB
UserKey0	NIB协议保留数据1
VrfNthp	下一跳所在VPN索引，显示为0表示公网
UserKey1	NIB协议保留数据2
Nexthop	下一跳信息
IFIndex	接口索引
LocalAddr	本地接口地址
NewUK0	第一个新的协议保留数据
NewUK1	第二个新的协议保留数据
NewUK2	第三个新的协议保留数据
NewUK3	第四个新的协议保留数据
NewUK4	第五个新的协议保留数据
NewUK5	第六个新的协议保留数据
NewUK6	第七个新的协议保留数据
NewUK7	第八个新的协议保留数据
TopoNthp	下一跳所在拓扑索引，显示为0表示公网拓扑
ExtType	NIB扩展类型
RefCnt	下一跳信息的引用计数
FlushRefCnt	下一跳信息的下刷引用计数
Flag	下一跳信息的标志位
Version	下一跳信息的版本号
x nexthop (s)	下一跳具体值（前面数值表示下一跳个数）
PrefixIndex	等价时下一跳序号
OrigNexthop	原始下一跳
RelyDepth	迭代深度
RealNexthop	真实下一跳
Interface	出接口
localAddr	本地接口地址
TunnelCnt	迭代到隧道的个数
Vrf	VPN实例名，显示为default-vrf表示公网
TunnelID	迭代到隧道的ID
Topology	拓扑名称，显示为base表示公网拓扑
Weight	等价路由各路由的权重，取值为0表示不是等价路由

 

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

 

 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

 

......（省略部分显示信息）

表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会话
TrackIndex	NQA Track索引
Label	标签
Preference	路由优先级
vrfIndexDst	目的所在VPN索引，显示为0表示公网
vrfIndexNH	下一跳所在VPN索引，显示为0表示公网
Permanent	永久静态路由标志（1表示永久静态路由）
Tag	路由标记

 

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 } 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 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

【参数】

vpn-instance s-vpn-instance-name：指定源VPN实例。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：开启静态路由下一跳循环迭代功能。如果不指定本参数，则表示关闭静态路由的下一跳循环迭代功能。

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地址。

permanent：指定为永久静态路由。即使在出接口down时，配置的永久静态路由仍然保持active状态。

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

public：指定静态路由下一跳处于公网实例。

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

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

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

【使用指导】

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

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

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

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

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

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

·     对于广播类型接口，需要通过下一跳IP地址来获取下一跳的物理地址，配置时需要指定出接口和下一跳IP地址。

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

·     路由震荡时，使能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参数迭代到主机路由，或按照路由策略迭代到主机路由时，如果因为下一跳主机不主动发送免费ARP等原因导致设备上主机路由对应的ARP表项不存在，就会造成主机路由不存在、静态路由无法激活，这种场景下可以配置本命令，定时向不带出接口且下一跳迭代失败的静态路由的下一跳发送ARP请求，当收到主机的ARP应答后，主机路由存在，静态路由便会自动激活，这时停止向该静态路由下一跳发送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 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 } 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 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 ]

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：开启静态路由下一跳循环迭代功能。如果不指定本参数，则表示关闭静态路由的下一跳循环迭代功能。

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：指定静态路由下一跳处于公网实例。

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

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

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.9  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.10  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