[index] AT-TQ7403-R コマンドリファレンス 5.5.5

# ip route

モード: グローバルコンフィグモード
カテゴリー: IP / 経路制御

`(config)# ip route [vrf VRFNAME] DESTINATION {GATEWAY & IFNAME | null} [<1-255>] [weight <1-255>] [description TEXTLINE]`

`(config)# no ip route [vrf VRFNAME] DESTINATION {GATEWAY & IFNAME | null} [<1-255>] [weight <1-255>]`

IP経路表にスタティック経路を追加する。
no形式で実行した場合は指定したスタティック経路を削除する。

### パラメーター

`vrf VRFNAME` | 経路の追加先となるVRFインスタンス名。省略時はグローバルVRFインスタンスに経路を追加する
`DESTINATION` | 宛先ネットワークアドレス。次のいずれかの形式で指定する。なお、デフォルト経路を追加する場合は、宛先ネットワークアドレスとして0.0.0.0/0または0.0.0.0 0.0.0.0を指定する
| `A.B.C.D/M` | IPアドレスとプレフィックス長で指定する形式
| `A.B.C.D W.X.Y.Z` | IPアドレスとサブネットマスクで指定する形式
`GATEWAY :=` | `A.B.C.D`
| 転送先（ネクストホップ）のIPアドレス。詳細は書式パターンを参照
`IFNAME` | 出力インターフェース名。詳細は書式パターンを参照
`null` | ブラックホール経路を登録する場合に指定する特殊なインターフェース名。nullを指定した場合、該当経路宛てのパケットは転送されずに破棄される。詳細は書式パターンを参照
`<1-255>` | 管理距離（経路選択時の優先度）。同じサブネット長のスタティック経路を複数登録する場合に、それらの間で優先順位を付けたい場合に本値を使用可能（フローティングスタティックルートの利用）。値が小さいほど優先度が高い。省略時はスタティック経路のデフォルト値である1となる
`weight <1-255>` | 該当経路のウェイト（重み付け）。本パラメーターは`GATEWAY`で転送先（ネクストホップ）のIPアドレスを指定している場合のみ利用可能（出力インターフェースを指定するときは利用できない）。同一宛先への最適経路が複数登録されている場合、該当宛先へのIPv4パケットはフロー単位でこれらの各経路にロードバランスされるが、その際各経路を使用するフローの数が各経路に設定されたウェイトの比になるよう調整される。なおロードバランス可能な経路数はmaximum-pathsコマンドの設定値が上限となる。本パラメーター省略時のウェイトは1
`description TEXTLINE` | 説明文。TEXTLINEは行末までがその値と見なされるため、スペースを含んでいてもよい

### 使用例

■ 172.20.53.0/24へのスタティック経路を登録する。

    awplus(config)# ip route 172.20.53.0/24 172.17.28.254 ↓

サブネットマスクを使って次のように指定しても同じ。

    awplus(config)# ip route 172.20.53.0 255.255.255.0 172.17.28.254 ↓

■ デフォルト経路を172.17.28.32に向ける。

    awplus(config)# ip route 0.0.0.0/0 172.17.28.32 ↓

転送先（ネクストホップ）がポイントツーポイントインターフェース上に存在する場合は、ネクストホップアドレス（GATEWAY）ではなく出力インターフェース（IFNAME）を指定する。

    awplus(config)# ip route 0.0.0.0/0 ppp0 ↓

■ 10.0.0.0/8宛てのパケットを転送せずに破棄するよう設定する。

    awplus(config)# ip route 10.0.0.0/8 null ↓

■ VRF環境におけるスタティック経路の設定例については、VRFの解説編を参照。

### 注意・補足事項

■ 管理距離255を持つ経路は「信頼できない経路」と見なされ、FIB（IP転送表）に登録されない（IPパケットの転送には使われない）。
■ 非ポイントツーポイントのトンネルインターフェースを使用してルーティングを行う場合は、ポイントツーポイントのトンネルインターフェースと異なりネクストホップアドレスを明確にする必要がある。そのため、本コマンドでスタティック経路を登録するときは、該当トンネルインターフェースを送出インターフェースとして指定するのではなく、ネクストホップアドレスを明示的に指定すること。
■ 経路追加時の書式には次のパターンがある。

> Note

> > 以下の説明において、「非ポイントツーポイントインターフェース」とは、次のインターフェースを指します（802.1Qサブインターフェースを含む）。
> > - Ethernetインターフェース
> > - ブリッジインターフェース
> > - L2TPv3トンネルインターフェース
> > - OpenVPN Tap(L2)トンネルインターフェース
> > - マルチポイントGREトンネルインターフェース
> > また、「ポイントツーポイントインターフェース」とは、次のインターフェースを指します。
> > - PPPoE/PPPインターフェース
> > - トンネルインターフェース（前記「非ポイントツーポイントインターフェース」に含まれるものを除く）

#### 非VRF環境

- ネクストホップ（転送先）が非ポイントツーポイントインターフェース上に存在する場合

  `ip route DESTINATION GATEWAY [<1-255>]`

- ネクストホップ（転送先）がポイントツーポイントインターフェース（IFNAME）上に存在する場合

  `ip route DESTINATION IFNAME [<1-255>]`

- 該当宛先のパケットを転送せずに破棄する場合

  `ip route DESTINATION null [<1-255>]`

#### VRF環境

##### VRFインスタンス内経路

宛先（DESTINATION）が同一VRFインスタンス内にある場合は、vrfパラメーターを除き、非VRF環境と同じ。詳細はVRFの解説編を参照。

- ネクストホップ（転送先）が非ポイントツーポイントインターフェース上に存在する場合

  `ip route [vrf VRFNAME] DESTINATION GATEWAY [<1-255>]`

- ネクストホップ（転送先）がポイントツーポイントインターフェース（IFNAME）上に存在する場合

  `ip route [vrf VRFNAME] DESTINATION IFNAME [<1-255>]`

- 該当宛先のパケットを転送せずに破棄する場合

  `ip route [vrf VRFNAME] DESTINATION null [<1-255>]`

##### VRFインスタンス間経路

VRFインスタンスをまたぐスタティック経路、すなわち宛先（DESTINATION）が他のVRFインスタンスに存在する経路を登録する場合は、次のパターンがある。詳細はVRFの解説編を参照。

- 宛先ネットワークが自装置に直接接続されている場合（他のルーターを介さず、自装置内で転送が完了する場合）
  出力インターフェース（IFNAME）だけを指定。

  `ip route [vrf VRFNAME] DESTINATION IFNAME [<1-255>]`

- ネクストホップが他装置の場合（宛先ネットワークへのパケットを他のルーターに転送する必要がある場合）
  ネクストホップアドレス（GATEWAY）と出力インターフェース（IFNAME）の両方を指定。

  `ip route [vrf VRFNAME] DESTINATION GATEWAY IFNAME [<1-255>]`

- 該当宛先のパケットを転送せずに破棄する場合

  `ip route [vrf VRFNAME] DESTINATION null [<1-255>]`

### コマンドツリー

    configure terminal (特権EXECモード)
        |
        +- ip route（グローバルコンフィグモード）

### 関連コマンド

ip vrf（グローバルコンフィグモード）
show ip route（非特権EXECモード）
show ip route database（非特権EXECモード）
show ip route summary（非特権EXECモード）

(C) 2024-2026 アライドテレシスホールディングス株式会社

PN: 613-003360 Rev.F