目  录

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 default-preference

1.1.6 ip route-static fast-reroute auto

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

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

context-admin

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

context-admin

context-operator

【参数】

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

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

【使用指导】

非缺省vSystem不支持本命令。

【举例】

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

<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

      Color: 0                   COFlag: 0x0

     LinkID: 0x0

   SIDIndex: 0x0                SRPName:

 OriNexthop: 0.0.0.0

 

      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

      Color: 0                   COFlag: 0x0

     LinkID: 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
UserKey0	NIB协议保留数据1
UserKey1	NIB协议保留数据2
VrfNthp	下一跳所在VPN索引，显示为0表示公网
Nexthop	下一跳信息
IFIndex	接口索引
LocalAddr	本地接口地址
NewUK0	第一个新的协议保留数据
NewUK1	第二个新的协议保留数据
NewUK2	第三个新的协议保留数据
NewUK3	第四个新的协议保留数据
NewUK4	第五个新的协议保留数据
NewUK5	第六个新的协议保留数据
NewUK6	第七个新的协议保留数据
NewUK7	第八个新的协议保留数据
TopoNthp	（暂不支持）下一跳所在拓扑索引，显示为0表示公网拓扑
ExtType	下一跳扩展类型
Color	（暂不支持）Color扩展团体属性
COFlag	（暂不支持）Color属性的标志位
LinkID	（暂不支持）SDWAN TTE连接的Link ID
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

   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

      Color: 0                   COFlag: 0x0

     LinkID: 0x0

   SIDIndex: 0x0                SRPName:

 OriNexthop: 0.0.0.0

     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              Flags: 0x0

SRPolicyNID: 4294967295     SRInterface:

ColorWeight: 0                  Locator: N/A

 OrigLinkID: 0x0             RealLinkID: 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

      Color: 0                   COFlag: 0x0

     LinkID: 0x0

   SIDIndex: 0x0                SRPName:

 OriNexthop: 0.0.0.0

     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: XGE1/0/5          LocalAddr: 12.12.12.12

  TunnelCnt: 0                      Vrf: default-vrf

   TunnelID: N/A               Topology: base

     Weight: 1000000              Flags: 0x0

SRPolicyNID: 4294967295     SRInterface:

ColorWeight: 0                  Locator: N/A

 OrigLinkID: 0x0             RealLinkID: 0x0

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

 OrigLinkID: 0x0             RealLinkID: 0x0

 

...

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

字段	描述
Total number of nexthop(s)	总的下一跳个数
NibID	NIB ID号
Sequence	NIB序列号
Type	NIB类型
Flushed	是否下刷FIB
UserKey0	NIB协议保留数据1
VrfNthp	下一跳所在VPN索引，显示为0表示公网
UserKey1	NIB协议保留数据2
Nexthop	下一跳信息
IFIndex	接口索引
LocalAddr	本地接口地址
TopoNthp	（暂不支持子拓扑）下一跳所在拓扑索引，显示为0表示公网拓扑
RefCnt	下一跳信息的引用计数
FlushRefCnt	下一跳信息的下刷引用计数
Flag	下一跳信息的标志位
Version	下一跳信息的版本号
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表示没有该属性
OrigLinkID	（暂不支持）SDWAN TTE连接的原始Link ID
RealLinkID	（暂不支持）SDWAN TTE连接的真实Link ID

 

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

context-admin

context-operator

vsys-admin

vsys-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-GigabitEthernet1/0/5

     TableID: 0x2            BkInterface: Ten-GigabitEthernet1/0/6

        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: Ten-GigabitEthernet1/0/7

     TableID: 0x2            BkInterface: Ten-GigabitEthernet1/0/8

        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类型的静态路由
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命令用来删除指定的静态路由。

【命令】

缺省vSystem系统视图：

ip route-static { dest-address { mask-length | mask } | group group-name } interface-type interface-number [ dhcp | 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 ] [ preference preference ] [ tag tag-value ] [ description text ]

ip route-static { dest-address { mask-length | mask } | group group-name } next-hop-address [ bfd { control-packet bfd-source ip-address | static session-name } | permanent | track track-entry-number ] [ preference preference ] [ tag tag-value ] [ description text ]

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

ip route-static dest-address { mask-length | mask } vpn-instance d-vpn-instance-name [ track track-entry-number ] [ preference preference ] [ tag tag-value ] [ description text ]

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

非缺省vSystem系统视图：

ip route-static dest-address { mask-length | mask } interface-type interface-number [ dhcp | 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 ] [ preference preference ] [ tag tag-value ] [ description text ]

ip route-static dest-address { mask-length | mask } next-hop-address [ bfd { control-packet bfd-source ip-address | static session-name } | permanent | track track-entry-number ] [ preference preference ] [ tag tag-value ] [ description text ]

ip route-static dest-address { mask-length | mask } public [ track track-entry-number ] [ preference preference ] [ tag tag-value ] [ description text ]

undo ip route-static dest-address { mask-length | mask } [ interface-type interface-number [ next-hop-address ] | next-hop-address | public ] [ preference preference ]

【缺省情况】

未配置静态路由。

【视图】

系统视图

【缺省用户角色】

network-admin

context-admin

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

public:表示缺省vSystem。指定本参数用于非缺省vSystem访问缺省vSystem，这种情况下不需要指定下一跳IP地址。

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

dhcp：使用DHCP服务器为客户端指定的网关地址作为静态路由的下一跳地址。

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

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功能。

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”。

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），则配置的路由为缺省路由。当没有匹配的路由表项时，将使用缺省路由进行报文转发。

配置如下命令可以实现缺省vSystem与非缺省vSystem之间的互相通信：

·     在缺省vSystem系统视图下配置ip route-static dest-address { mask-length | mask } vpn-instance d-vpn-instance-name [ track track-entry-number ] [ preference preference ] [ tag tag-value ] [ description text ]命令，可以实现缺省vSystem访问非缺省vSystem，其中d-vpn-instance-name为与非缺省vSystem同名的VPN实例名称。

·     在非缺省vSystem系统视图下配置ip route-static dest-address { mask-length | mask } public [ track track-entry-number ] [ preference preference ] [ tag tag-value ] [ description text ]命令，可以实现非缺省vSystem访问缺省vSystem。

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

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

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

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

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

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

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

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

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

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

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

接口通过DHCP方式获取到IP地址和网关地址后，设备会自动生成一条目的地址为0.0.0.0/0、下一跳地址为Default router（DHCP服务器为客户端指定的网关地址）的静态路由，该路由无法与手工配置的静态路由形成等价路由。只有当手工指定的静态路由失效时，自动生成的静态路由才能指导报文转发。在手工指定和DHCP自动生成的静态路由均需要转发报文的场景下（例如双WAN出口的网络），需要执行本配置来创建基于DHCP的静态路由。

执行本命令时如果指定了dhcp参数，设备会自动生成一条以Default router为下一跳的静态路由，该路由只有在设备作为DHCP客户端获取到IP地址和网关地址后才会生效。该路由可以和手工配置的静态路由形成等价路由。DHCP服务器为客户端指定的网关地址发生变化时，设备自动将静态路由下一跳地址修改为变化后的网关地址。仅当静态路由的出接口为广播类型的接口时支持指定dhcp参数。

【举例】

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

【相关命令】

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

·     ip route-static-group

·     prefix

1.1.5  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

context-admin

【参数】

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

【使用指导】

非缺省vSystem不支持本命令。

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

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

【举例】

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

<Sysname> system-view

[Sysname] ip route-static default-preference 120

【相关命令】

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

1.1.6  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

context-admin

【使用指导】

非缺省vSystem不支持本命令。

如果在缺省vSystem视图下配置本功能，则在非缺省vSystem系统视图下配置的静态路由也会生效。

【举例】

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

<Sysname> system-view

[Sysname] ip route-static fast-reroute auto

1.1.7  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

context-admin

【使用指导】

非缺省vSystem不支持本命令。

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

【举例】

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

<Sysname> system-view

[Sysname] ip route-static 1.1.1.1 32 ten-gigabitethernet 1/0/5 2.2.2.2 backup-interface ten-gigabitethernet 1/0/6 backup-nexthop 3.3.3.3

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

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 [ dhcp | 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 ] [ 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 [ bfd { control-packet bfd-source ip-address | static session-name } | permanent | track track-entry-number ] [ preference preference ] [ tag tag-value ] [ description text ]

ip route-static vpn-instance s-vpn-instance-name dest-address { mask-length | mask } next-hop-address [ public ] [ bfd { control-packet bfd-source ip-address | static session-name } | permanent | track track-entry-number ] [ 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 [ track track-entry-number ] [ preference preference ] [ tag tag-value ] [ description text ]

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

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

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

【缺省情况】

未配置静态路由。

【视图】

系统视图

【缺省用户角色】

network-admin

context-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：指定静态路由的出接口类型和接口号。在指定静态路由的出接口类型和接口号时需要注意的事项，详见使用指导。

dhcp：使用DHCP服务器为客户端指定的网关地址作为静态路由的下一跳地址。

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

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功能。

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在公网IP路由表中查找出接口。如果未指定本参数，且未指定目的VPN实例，表示静态路由的下一跳属于源VPN实例，静态路由将根据配置的next-hop-address在源VPN实例的路由表中查找出接口。

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

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

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

【使用指导】

非缺省vSystem不支持本命令。

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

在缺省vSystem系统视图下配置ip route-static vpn-instance s-vpn-instance-name dest-address { mask-length | mask } vpn-instance d-vpn-instance-name [ track track-entry-number ] [ preference preference ] [ tag tag-value ] [ description text ]命令，可以实现不同的非缺省vSystem之间的互通，其中s-vpn-instance-name和d-vpn-instance-name均为与非缺省vSystem时同名的VPN实例名称。

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

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

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

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

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

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

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

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

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

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

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

接口通过DHCP方式获取到IP地址和网关地址后，设备会自动生成一条目的地址为0.0.0.0/0、下一跳地址为Default router（DHCP服务器为客户端指定的网关地址）的静态路由，该路由无法与手工配置的静态路由形成等价路由。只有当手工指定的静态路由失效时，自动生成的静态路由才能指导报文转发。在手工指定和DHCP自动生成的静态路由均需要转发报文的场景下（例如双WAN出口的网络），需要执行本配置来创建基于DHCP的静态路由。

执行本命令时如果指定了dhcp参数，设备会自动生成一条以Default router为下一跳的静态路由，该路由只有在设备作为DHCP客户端获取到IP地址和网关地址后才会生效。该路由可以和手工配置的静态路由形成等价路由。DHCP服务器为客户端指定的网关地址发生变化时，设备自动将静态路由下一跳地址修改为变化后的网关地址。仅当静态路由的出接口为广播类型的接口时支持指定dhcp参数。

【举例】

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

context-admin

【参数】

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

【使用指导】

非缺省vSystem不支持本命令。

【举例】

# 创建静态路由配置组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

context-admin

【参数】

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

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

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

【使用指导】

非缺省vSystem不支持本命令。

在静态路由配置组视图下可以多次配置该命令，添加多个前缀，并通过命令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