HN 日本語サマリー

← 一覧へ戻る
プログラミング

タスク中心のiproute2ユーザーガイド

Task-centered iproute2 user guide (baturin.org)

26 pointsby greengreengrass3 コメント

要約

このドキュメントは、Linuxネットワークツールであるiproute2の包括的かつタスク中心のユーザーガイドです。ip、tc、bridge、ssコマンドの使用法に焦点を当て、アドレス管理、ネイバーテーブル、ネットワークリンク、ブリッジ、トンネル、ルーティングテーブル、ネットワーク名前空間などの一般的なネットワーキングタスクをどのように実行するかを説明します。公式マニュアルページにはない、実用的な使用例を提供することを目的としています。

全文翻訳

Task-centered iproute2 user guide

Overview of iproute2

iproute2 は、レガシーなツール(ifconfig、vconfig、brctl、route、arp など)に取って代わった Linux のネットワークツールキットです。これらの古いツールは、古いスクリプトとの互換性のためにのみ維持されており、Linux カーネルの多くの新しいネットワーク機能へのアクセスを提供しません。

元々は Alex Kuznetsov によって書かれ、現在は Stephen Hemminger がメンテナンスしています。

ほとんどのネットワーク機能は ip コマンドに統合されています。トラフィックポリシー(QoS)を管理するための tc、ソフトウェアブリッジインターフェイスを管理するための bridge、そして netstat の代替となる ss もあります。

これらのコマンドは通常 iproute2 または iproute と呼ばれるパッケージに含まれています。最近のほとんどの Linux ディストリビューションではデフォルトでインストールされています。ip コマンドは /sbin にインストールされることがあり、デフォルトでは特権のないユーザーの $PATH に含まれていない場合があります。

About this document

歴史的に、ドキュメントは iproute2 の弱点でした。公式のマニュアルページには利用可能なオプションが記載されていますが、使用例はほとんど提供されていません。このニーズはサードパーティのドキュメントによって満たされてきました。

このドキュメントは、ip および bridge コマンドの包括的かつ使いやすいガイド、および ss に関する情報を提供することを目的としています。tc をこのスタイルで文書化することは、別の大きなプロジェクトになるでしょう。

このドキュメントは タスク中心 です。利用可能なサブコマンドをリストアップするのではなく、iproute2 コマンドを使用してさまざまなタスクを実行する方法を説明します。

Contributing

このドキュメントは Daniil Baturin によってメンテナンスされており、CC-BY-SA 4.0 — 強力なコピーレフト、フリーカルチャーライセンス — の下で配布されています。

貢献はいつでも歓迎されます。ソースファイルは github.com/dmbaturin/iproute2-cheatsheet で見つけることができます。

git clone https://github.com/dmbaturin/iproute2-cheatsheet.git

比喩的なコーヒー を購入してメンテナーを支援することもできます。

このドキュメントは「現状有姿」で提供され、いかなる保証もありません。著者は、それを使用したことによるいかなる損害についても責任を負いません。いつものように、入力する前に考え、Enter キーを押す前に二度考えてください。

Typographic conventions

メタ構文変数はシェルライクな構文 ${something} で記述されます。オプションのコマンド部分は角括弧 [] で囲まれます。必須の引数は山括弧 <> で囲まれます。

General notes

設定を変更するすべてのコマンドには root 権限が必要です。情報を表示するだけのコマンドには、通常、特別な権限は必要ありません。

/etc/iproute2 には設定ファイルがあり、主にルーティングテーブルのようなネットワークスタックエンティティにシンボリック名を割り当てるために使用されます。これらのファイルは ip コマンドを実行するたびに再読み込みされるため、変更を適用するために何もする必要はありません。

Abbreviating commands

任意の ip コマンドは省略形にすることができます。例えば、ip address add 192.0.2.1/24 dev eth0 は ip addr a 192.0.2.1/24 dev eth0 または ip a a 192.0.2.1/24 dev eth0 と書くことができます。

場合によっては、単語を省略することもできます。例えば、show および list という単語は常に省略可能です。ip address は ip address show および ip address list と同等です。

省略形システムは常に一貫しているわけではないことに注意してください。ip a a 192.0.2.1/24 dev eth0 の dev キーワードは、他のすべての単語が省略可能であっても、省略できません。

このドキュメントでは、読みやすさを向上させるために、意図的にすべてのコマンドを完全な形式で提供しています。スクリプトでは完全な形式を使用することをお勧めします。なぜなら、読者は省略形に慣れていない可能性があり、コードは書かれるよりもはるかに頻繁に読まれるからです。

Scripting considerations

ディストリビューションが ifconfig を削除することに対する一般的な不満は、スクリプトの書き直しを余儀なくされることです。しかし、iproute2 は機械可読な出力をサポートしているため、スクリプトにはより適しています。

以下の出力オプションを提供します。

  • -o (--oneline)
    各改行をバックスラッシュに置き換えます。最も初期のバージョンからサポートされています。

  • -br (--brief)
    簡潔で機械指向の出力を生成します。awk/cut で解析するのに最適です。少なくとも 4.11 以降でサポートされています。

  • -j (--json)
    JSON 出力を生成します。シェル以外のスクリプトに最適です。--pretty および --brief オプションをサポートします。少なくとも 4.13 以降でサポートされています。

出力の比較を以下に示します(スペースを節約するため、--json --pretty および --json --brief は省略しています)。

$ ip --oneline address show lo
1: lo    inet 127.0.0.1/8 scope host lo\       valid_lft forever preferred_lft forever
1: lo    inet6 ::1/128 scope host \       valid_lft forever preferred_lft forever

$ ip --brief address show lo
lo               UNKNOWN        127.0.0.1/8 ::1/128 

$ ip --json --brief address show lo
[{"ifname": "lo", "operstate": "UNKNOWN", "addr_info": [{"local": "127.0.0.1", "prefixlen": 8},{"local": "::1", "prefixlen": 128}]}, {}, {}]

IPv4 and IPv6 addresses


iproute2 は、ドット区切り10進数マスクとプレフィックス長の値の両方を受け入れます。つまり、192.0.2.10/24 と 192.0.2.10/255.255.255.0 の両方が有効な形式です。

Show all addresses
ip address show

すべての show コマンドは、IPv4 または IPv6 アドレスのみを表示するために -4 または -6 オプションを使用できます。デフォルトでは、すべての IP アドレスが表示されます。

Show addresses for a single interface
ip address show ${interface name} 

例:

ip address show eth0
Show addresses only for running interfaces
ip address show up
Show only static or dynamic IPv6 addresses

静的に設定されたアドレスのみを表示します:

ip address show [dev ${interface}] permanent

自動設定で学習されたアドレスのみを表示します:

ip address show [dev ${interface}] dynamic
Add an address to an interface
ip address add ${address}/${mask} dev ${interface name}

例:

ip address add 192.0.2.10/27 dev eth0

ip address add 2001:db8:1::/48 dev tun10

いくつでもアドレスを追加できます。

複数のアドレスを追加した場合、マシンはそれらすべてに対してパケットを受け入れます。最初に追加されたアドレスが「プライマリ アドレス」になります。インターフェイスのプライマリ アドレスは、デフォルトで送信パケットの送信元アドレスとして使用されます。追加したすべてのアドレスはセカンダリ アドレスになります。

Add an address with a human-readable description
ip address add ${address}/${mask} dev ${interface name} label ${interface name}:${description} 

例:

ip address add 192.0.2.1/24 dev eth0 label eth0:WANaddress

ラベルは、一部の後方互換性の問題により、インターフェイス名で始まり、その後にコロンが続く必要があります。そうしないと、エラーが発生します。ラベルを16文字未満に保ってください。そうしないと、RTNETLINK answers: Numerical result out of range というエラーが発生します。

Notes

IPv6 アドレスの場合、このコマンドは効果がありません。アドレスは正しく追加されますが、ラベルは無視されます。

Delete an address from an interface
ip address delete ${address}/${prefix} dev ${interface name}

例:

ip address delete 192.0.2.1/24 dev eth0

ip address delete 2001:db8::1/64 dev tun1

インターフェイス名は必須です。カーネルは、どのアドレスを削除したいインターフェイスから削除するかを自動的に推測しようとしません。そのような推測は常に一意であるとは限りません。Linux では、同じアドレスを複数のインターフェイスに設定することが許可されており、有効なユースケースがあります(Cisco の世界では、これは「unnumbered interfaces」として知られています)。

Remove all addresses from an interface
ip address flush dev ${interface name}

例:

ip address flush dev eth1

デフォルトでは、このコマンドは IPv4 および IPv6 アドレスの両方を削除します。IPv4 または IPv6 アドレスのみを削除したい場合は、ip -4 address flush または ip -6 address flush を使用します。

Change the primary address

プライマリとセカンダリの IPv4 アドレスを入れ替えたり、新しいプライマリ IPv4 アドレスを明示的に設定したりする方法はありません。常にプライマリ アドレスを最初に設定するようにしてください。

sysctl 変数 net.ipv4.conf.${interface}.promote_secondaries が 1 に設定されている場合、プライマリ アドレスを削除すると、最初のセカンダリ アドレスがプライマリになります。これは、net.ipv4.conf.default.promote_secondaries=1 でグローバルに有効にできます。

promote_secondaries が 0 に設定されている場合、プライマリ アドレスを削除すると、そのインターフェイスからすべてのセカンダリ アドレスも削除されることに注意してください。この設定は Linux ディストリビューションによって異なるため、プライマリ アドレスを変更しようとする前に必ず確認してください。

プライマリ IPv6 アドレスが削除されると、セカンダリ IPv6 アドレスは常にプライマリに昇格します。

Neighbor (ARP and NDP) tables


このコマンドは、アメリカ英語 (ip neighbor) とイギリス英語 (ip neighbour) のスペルバリアントの両方をサポートしています。

View neighbor tables
ip neighbor show

すべての「show」コマンドは、IPv4(ARP)または IPv6(NDP)ネイバーのみを表示するために -4 および -6 オプションをサポートしています。デフォルトでは、すべてのネイバーが表示されます。

View neighbors for a specific interface
ip neighbor show dev ${interface name}

例: ip neighbor show dev eth0

Flush table for an interface
ip neighbor flush dev ${interface name}

例: ip neighbor flush dev eth1

Add a neighbor table entry
ip neighbor add ${network address} lladdr ${link layer address} dev ${interface name}

例: ip neighbor add 192.0.2.1 lladdr 22:ce:e0:99:63:6f dev eth0

これのユースケースの 1 つは、データリンク層セキュリティの一形態です。インターフェイスで ARP を完全に無効にし、承認されたデバイスの MAC アドレスを手動で追加できます。

Delete a neighbor table entry
ip neighbor delete ${network address} lladdr ${link layer address} dev ${interface name}

例: ip neighbor delete 192.0.2.1 lladdr 22:ce:e0:99:63:6f dev eth0

これにより、静的エントリを削除したり、テーブルをフラッシュせずに自動的に学習されたエントリを削除したりできます。

Network links

「リンク」はネットワークインターフェイスの別の用語です。ip link ファミリのコマンドは、リンク情報の表示や MTU の変更など、すべてのインターフェイスタイプに共通する操作を実行します。

歴史的に、ip link コマンドはトンネル(IPIP、GRE など)、VXLAN リンク、または L2TPv3 擬似ワイヤを作成できませんでした。iproute2 3.16 以降では、L2TPv3 インターフェイスを除くすべてを作成でき、iproute2 5.7 現在でもこれは変わりません。多くの場合、特定のインターフェイスタイプの古いコマンドの方が依然として便利です。

Linux カーネルはネットワークインターフェイスに任意の名前(ASCII 文字以外も含む)を許可することに注意してください。ユーザー空間プログラム(iptables など)がそれほど寛容でない場合があるため、英数字に固執することをお勧めします。

Show information about all links
ip link show

ip link list

これらのコマンドは同等です。

Show information about a specific link
ip link show dev ${interface name}

例:

ip link show dev eth0
ip link show dev tun10

dev という単語は省略可能です。

Bring a link up or down
ip link set dev ${interface name} up

ip link set dev ${interface name} down

例:

ip link set dev eth0 down
ip link set dev br0 up

注: 仮想リンク(トンネル、VLAN など)は常に「down」状態で作成されます。使用を開始するには、アップにする必要があります。

Set human-readable link description
ip link set dev ${interface name} alias "${description}"

例: ip link set dev eth0 alias "LAN interface"。

リンクエイリアスは、ip link show の出力に次のように表示されます。

2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP mode DEFAULT qlen 1000
    link/ether 22:ce:e0:99:63:6f brd ff:ff:ff:ff:ff:ff
    alias LAN interface
Add link alternative names

カーネルはリンク名の長さを15文字に制限しています。この制限を超えるために、リンクに代替名を追加できます。

ip link property add dev ${interface name} altname ${alternative name}

例: ip link property add dev eth0 altname eno1 altname enp3s0

代替名は、iproute コマンドでリンクを参照するために使用できます。

$ ip link show eno1
2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc fq_codel state UP mode DEFAULT group default qlen 1000
    link/ether 52:54:00:11:af:63 brd ff:ff:ff:ff:ff:ff
    altname eno1
    altname enp3s0
Rename an interface
ip link set dev ${old interface name} name ${new interface name}

例: ip link set dev eth0 name lan

アクティブなインターフェイスの名前は変更できないことに注意してください。名前を変更する前に、ダウンさせる必要があります。

Change link-layer address (usually MAC address)
ip link set dev ${interface name} address ${address}

リンク層アドレスは非常に広範な概念です。最もよく知られている例は、イーサネットデバイスの MAC アドレスです。MAC アドレスを変更するには、ip link set dev eth0 address 22:ce:e0:99:63:6f のようなものが必要です。

Change link MTU
ip link set dev ${interface name} mtu ${MTU value}

例: ip link set dev tun0 mtu 1480

MTU は「Maximum Transmission Unit」の略で、インターフェイスが一度に送信できるフレームの最大サイズです。

トンネルでのフラグメンテーションを削減することに加えて、これは「ジャンボフレーム」(最大9000バイトのフレーム)と呼ばれるものをサポートするギガビットイーサネットリンクのパフォーマンスを向上させるためにも使用されます。すべての機器がギガビットイーサネットをサポートしている場合、ip link set dev eth0 mtu 9000 のようなことをしたいかもしれません。

L2 スイッチでも設定する必要がある場合があることに注意してください。一部のスイッチでは、ジャンボフレームはデフォルトで無効になっています。

Delete a link
ip link delete dev ${interface name}

明らかに、VLAN、ブリッジ、またはトンネルのような仮想リンクのみを削除できます。物理インターフェイスの場合、このコマンドは効果がありません。

Enable or disable multicast on an interface
ip link set ${interface name} multicast on

ip link set ${interface name} multicast off

本当に何をしているのか分からない限り、このオプションには触れない方が良いでしょう。

Enable or disable ARP on an interface
ip link set ${interface name} arp on

ip link set ${interface name} arp off

セキュリティポリシーを強制し、特定の MAC のみとインターフェイスとの通信を許可するために ARP を無効にしたい場合があります。この場合、ホワイトリストに登録された MAC のネイバーテーブルエントリを手動で作成する必要があります。そうしないと、何もそのインターフェイスと通信できなくなります。

ほとんどの場合、アクセスレイヤースイッチで MAC ポリシーを設定する方が良いでしょう。何をしているのか、そしてなぜそうしているのか確信がない限り、このフラグを変更しないでください。

Create a VLAN interface
ip link add name ${VLAN interface name} link ${parent interface name} type vlan id ${tag}

例: ip link add name eth0.110 link eth0 type vlan id 110

Linux がサポートする唯一の VLAN タイプは IEEE 802.1q VLAN です。ISL のようなレガシー実装はサポートされていません。

VLAN インターフェイスには任意の名前を使用できます。eth0.110 は従来の形式ですが、必須ではありません。

ブリッジ、ボンディング、L2 トンネル(GRETAP、L2TPv3...)など、イーサネットライクなデバイスはすべて VLAN インターフェイスの親として使用できます。

Create a QinQ interface (VLAN stacking)
ip link add name ${service interface} link ${physical interface} type vlan proto 802.1ad id ${service tag}

ip link add name ${client interface} link ${service interface} type vlan proto 802.1q id ${client tag}

例:

ip link add name eth0.100 link eth0 type vlan proto 802.1ad id 100 # Create a service tag interface

ip link add name eth0.100.200 link eth0.100 type vlan proto 802.1q id 200 # Create a client tag interface

VLAN スタッキング(別名 802.1ad QinQ)は、別の VLAN を介して VLAN タグ付きトラフィックを伝送する方法です。一般的なユースケースは次のとおりです。たとえば、あなたがサービスプロバイダーであり、顧客があなたのネットワークインフラストラクチャを使用してネットワークの一部を相互に接続したいとします。彼らは自分のネットワークで複数の VLAN を使用しているため、通常のレンタル VLAN はオプションではありません。QinQ を使用すると、トラフィックがネットワークに入るときに 2 番目のタグを追加し、終了するときにそのタグを削除できるため、競合がなく、VLAN 番号を無駄にする必要がありません。

サービスタグは、プロバイダーがクライアントトラフィックをネットワーク経由で運ぶために使用する VLAN タグです。クライアントタグは、顧客によって設定されるタグです。

リンク MTU がクライアント VLAN インターフェイスの MTU に自動的に調整されないことに注意してください。自分で注意して、クライアントインターフェイスの MTU を少なくとも 4 バイト減らすか、親の MTU をそれに応じて増やす必要があります。

標準に準拠した QinQ は Linux 3.10 以降で利用可能です。

Create a virtual MAC (MACVLAN) interface
ip link add name ${macvlan interface name} link ${parent interface} type macvlan

例: ip link add name peth0 link eth0 type macvlan

MACVLAN インターフェイスは、単一インターフェイス上の「セカンダリ MAC アドレス」のようなものです。ユーザーの視点からは通常のイーサネットインターフェイスのように見え、その MAC アドレスのすべてのトラフィックを処理します。

これは、セカンダリ IP アドレスをうまく処理できないサービスやアプリケーションに使用できます。

Create a dummy interface
ip link add name ${dummy interface name} type dummy

例: ip link add name dummy0 type dummy

Linux では、いくつかの奇妙な歴史的理由から、ループバックインターフェイスは 1 つしかありません。ダミーインターフェイスはループバックのようなものですが、多数存在できます。

これらは、単一ホスト内での通信に使用できます。ループバックまたはダミーインターフェイスは、複数の物理インターフェイスを持つルーターに管理アドレスを割り当てるのに適した場所でもあります。

Create a bonding interface
ip link add name ${name} type bond

例: ip link add name bond1 type bond

注: これだけでは、ボンディング(リンクアグリゲーション)を意味のある方法で設定するには不十分です。状況に応じてボンディングパラメータを設定する必要があります。これはチートシートの範囲をはるかに超えているため、ドキュメントを参照してください。

ボンディングインターフェイスのメンバーは、ブリッジポートと同様に、master および nomaster コマンドを使用して追加および削除されます。

Create an intermediate functional block interface
ip link add ${interface name} type ifb

例: ip link add ifb10 type ifb

中間機能ブロックデバイスは、tc と組み合わせてトラフィックのリダイレクトとミラーリングに使用されます。これもこのドキュメントの範囲をはるかに超えているため、tc のドキュメントを参照してください。

Create a pair of virtual ethernet devices

仮想イーサネット(veth)デバイスは常にペアで提供され、双方向パイプとして機能します。一方に入ってくるものはすべて他方から出てきます。これらは、ネットワーク名前空間やコンテナ(OpenVZ または LXC)などのシステムパーティショニング機能と組み合わせて、一方のパーティションを他方に接続するために使用されます。

ip link add name ${first device name} type veth peer name ${second device name}

例: ip link add name veth-host type veth peer name veth-guest

注: カーネルのバージョンによっては、これらのデバイスはダウン状態またはアップ状態で作成される場合があります。最近のバージョン(5.10 でテスト済み)ではダウン状態です。それらがダウン状態であると仮定し、常に ip link set ${intf} up を使用することをお勧めします。

Link groups

リンクグループは、マネージドスイッチに見られるポート範囲に似ています。ネットワークインターフェイスを番号付きグループに追加し、そのグループのすべてのインターフェイスに対して一度に操作を実行できます。

どのグループにも割り当てられていないリンクは、グループ 0(「デフォルト」)に属します。

Add an interface to a group
ip link set dev ${interface name} group ${group number}

例:

ip link set dev eth0 group 42
ip link set dev eth1 group 42
Remove an interface from a group

これは、デフォルトグループに割り当てることで実行できます。

ip link set dev ${interface name} group 0

ip link set dev ${interface} group default

例: ip link set dev tun10 group 0

Assign a symbolic name to a group

グループ名は /etc/iproute2/group ファイルで設定されます。グループ 0 のシンボリック名「default」は iproute2 の組み込みではありません。デフォルトのグループ設定ファイルから来ています。独自のものを追加できます。1行に1つずつ、${number} ${name} の形式に従います。最大 255 個の名前付きグループを持つことができます。

グループ名を構成した後、その番号と名前は ip コマンドで相互に交換可能に使用できます。

例:

echo "10    customer-vlans" >> /etc/iproute2/group

その後、次のように、その名前をすべての操作で使用できます。

ip link set dev eth0.100 group customer-vlans
Perform an operation on a group
ip link set group ${group number} ${operation and arguments}

例:

ip link set group 42 down

ip link set group uplinks mtu 1200
View information about links from a specific group

通常の情報表示コマンドに group ${group} 修飾子を使用します。

例:

ip link list group 42

ip address show group customers

Bridges

ブリッジインターフェイスは仮想イーサネットスイッチです。

これらを使用して、Linux ボックスを低速な L2 スイッチにしたり、ハイパーバイザーホスト上の仮想マシン間の通信を可能にしたりできます。

Linux ボックスを物理スイッチにすることは完全に不条理なアイデアではありません。なぜなら、単純なハードウェアスイッチとは異なり、透過的なファイアウォールとして機能できるからです。

ブリッジに IP アドレスを割り当てることができ、それはすべてのブリッジポートからアクセス可能になります。

ブリッジの作成に失敗した場合は、bridge モジュールがロードされているか確認してください。

Bridge management utilities

Linux のブリッジは 2 つの異なるユーティリティで管理されます。ブリッジの作成やポートの追加・削除には、ip link ファミリのコマンドが必要です。ポート VLAN の割り当てやブリッジ転送テーブルの表示など、他の多くのタスクには bridge という名前のコマンドが必要です。このコマンドは、古い brctl ユーティリティと混同しないでください。

Create a bridge
ip link add name ${bridge name} type bridge

例: ip link add name br0 type bridge

Add a bridge port
ip link set dev ${interface name} master ${bridge name}

例: ip link set dev eth0 master br0

ブリッジに追加されたインターフェイスは仮想スイッチポートになります。データリンク層のみで動作し、ネットワーク層の操作はすべて停止します。

Delete a bridge port
ip link set dev ${interface name} nomaster

例: ip link set dev eth0 nomaster

Isolate a bridge port

多くの設定では、クライアントホストは他のクライアントではなくルーターと通信できれば十分です。Linux ブリッジでは、ポートを「孤立」としてマークできます。孤立したポートは、非孤立ポートと通信できません。

以下のコマンドを使用してポートを孤立としてマークできます。

bridge link set dev <intf> isolated <on|off>

例:

bridge set dev eth0 isolated on
bridge set dev eth1 isolated on

この例では、eth0 は eth1 と直接通信できなくなりますが、Linux ブリッジホスト自体や、孤立としてマークされていないポートとは引き続き通信できます。

Create a VLAN-aware bridge

デフォルトでは、Linux ブリッジは管理されていないスイッチのように動作します。しかし、VLAN 対応にすることが可能で、その後ポートをトランクポートまたはアクセスポートとして設定できます。

VLAN を有効にするには、コマンドオプションに vlan_filtering 1 を追加します。VLAN プロトコル(802.1q またはネストされた QinQ VLAN 用の 802.1ad)を設定し、vlan_default_pvid でデフォルトの VLAN 値を設定することもできます。

ip link add name ${bridge name} type bridge vlan_filtering 1 [vlan_protocol <802.1q|802.1ad>] [vlan_default_pvid <num>] 

例: ip link add name br0 type bridge vlan_filtering 1

Create a VLAN access port
bridge vlan add vid <tag> dev <intf> pvid untagged

例: bridge vlan add vid 100 dev eth0 pvid untagged

Create a VLAN trunk port

pvid および/または untagged オプションを指定しない場合、ブリッジはクライアントデバイスが VLAN タグを自分で割り当てると想定します。

bridge vlan add vid <tag> dev <intf>

注: 単一のタグではなく、VLAN の範囲を指定することも可能です。例: vid 100-200。

例: bridge vlan add vid 100-200 dev eth0。

View bridge VLAN information
bridge [-com|-compressvlans|-detail] vlan show

例: bridge -detail vlan show

注: bridge vlan show コマンドは、デフォルトですべての範囲からすべての個々の VLAN を表示します。bridge vlan add vid 500-550 dev eth0 のようなことを行うと、50 個の個別の VLAN の行が表示されます。連続した範囲(例: 500-550)を表示するには、-com/-compressvlans を追加します。-detail を使用すると、VLAN 範囲の圧縮が自動的に有効になります。

View bridge forwarding table
bridge fdb show [dev <intf>]

ip neighbor show dev br0 を実行しても、ブリッジホストと通信したことのあるデバイスの MAC アドレスしか表示されません。他のブリッジポートとのみ通信するデバイスの MAC アドレスは、代わりに bridge fdb show コマンドを使用して表示できます。

例: bridge fdb show dev br0 — ブリッジ br0 の MAC アドレステーブルを表示します。

TUN and TAP devices


TUN および TAP デバイスは、ユーザー空間プログラムがネットワークデバイスをエミュレートできるようにします。両者の違いは、TAP デバイスがイーサネットフレーム(L2 デバイス)で動作するのに対し、TUN は IP パケット(L3 デバイス)で動作することです。

TUN/TAP デバイスには、永続的(persistent)と一時的(transient)の 2 種類があります。一時的な TUN/TAP デバイスは、ユーザー空間プログラムが特殊なデバイスを開いたときに作成され、関連するファイルディスクリプタが閉じられると自動的に破棄されます。永続的なデバイスは、以下のドキュメント化された ip コマンドで作成されます。

View TUN/TAP devices
ip tuntap show

注: このコマンドは ip tuntap に省略できます。

このコマンドは、デバイスが TUN または TAP モードにあるかどうかを確認する唯一の方法です。

Add a TUN/TAP device useable by the root user
ip tuntap add dev ${interface name} mode ${mode}

例:

ip tuntap add dev tun0 mode tun

ip tuntap add dev tap9 mode tap
Add a TUN/TAP device usable by an ordinary user
ip tuntap add dev ${interface name} mode ${mode} user ${user} group ${group}

例:

ip tuntap add dev tun1 mode tun user me group mygroup

ip tuntap add dev tun2 mode tun user 1000 group 1001
Add a TUN/TAP device using an alternate packet format

ファイルディスクリプタ経由で送信される各パケットにメタ情報を追加します。この情報が期待されるプログラムはごくわずかであり、このモードのデバイスで期待しないプログラムは正しく機能しません。

ip tuntap add dev ${interface name} mode ${mode} pi

例: ip tuntap add dev tun1 mode tun pi

Add a TUN/TAP device ignoring flow control

通常、TUN/TAP デバイスに送信されるパケットは、他のデバイスに送信されるパケットと同じように扱われます。つまり、トラフィック制御エンジン(tc コマンドで設定される)によって処理されるキューに入れられます。これはバイパスできるため、この TUN/TAP デバイスのトラフィック制御エンジンが無効になります。

ip tuntap add dev ${interface name} mode ${mode} one_queue

例: ip tuntap add dev tun1 mode tun one_queue

Delete a TUN/TAP device
ip tuntap delete dev ${interface name} mode ${mode}

例:

ip tuntap delete dev tun0 mode tun

ip tuntap delete dev tap1 mode tap

注: モードを指定する必要があります。モードは ip link show では表示されないため、TUN デバイスか TAP デバイスか不明な場合は、ip tuntap show の出力を参照してください。

Tunnel interfaces

トンネルは、パケット全体を別のプロトコルにカプセル化することで、ルーティングされたネットワーク上で直接接続をエミュレートする「ネットワークワームホール」です。

Linux は現在、IPIP(IPv4 over IPv4)、SIT(IPv6 over IPv4)、IP6IP6(IPv6 over IPv6)、IPIP6(IPv4 over IPv6)、GRE(virtually anything over anything)、および VTI(IPv4 over IPsec)をサポートしています。

トンネルは DOWN 状態で作成されることに注意してください。アップにする必要があります。

このセクションでは、${local endpoint address} と ${remote endpoint address} は物理インターフェイスに割り当てられたアドレスを指し、${address} はトンネルインターフェイスに割り当てられたアドレスを指します。

Create an IPIP tunnel
ip tunnel add ${interface name} mode ipip local ${local endpoint address} remote ${remote endpoint address}

例:

ip tunnel add tun0 mode ipip local 192.0.2.1 remote 198.51.100.3

ip link set dev tun0 up

ip address add 10.0.0.1/30 dev tun0
Create an SIT (6in4) tunnel
ip tunnel add ${interface name} mode sit local ${local endpoint address} remote ${remote endpoint address}

例:

ip tunnel add tun9 mode sit local 192.0.2.1 remote 198.51.100.3

ip link set dev tun9 up

ip address add 2001:db8:1::1/64 dev tun9

このタイプのトンネルは、IPv4 接続ネットワークに IPv6 接続を提供するためによく使用されます。興味のあるすべての人にそれを提供する「トンネルブローカー」があります。例えば、Hurricane Electric の tunnelbroker.net です。

Create an IPIP6 tunnel
ip -6 tunnel add ${interface name} mode ipip6 local ${local endpoint address} remote ${remote endpoint address}

例: ip -6 tunnel add tun8 mode ipip6 local 2001:db8:1::1 remote 2001:db8:1::2

このタイプのトンネルは、トランジットオペレーターが IPv4 を段階的に廃止する(つまり、すぐにではない)場合に広く使用されるでしょう。

Create an IP6IP6 tunnel
ip -6 tunnel add ${interface name} mode ip6ip6 local ${local endpoint address} remote ${remote endpoint address}

例:

ip -6 tunnel add tun3 mode ip6ip6 local 2001:db8:1::1 remote 2001:db8:1::2

ip link set dev tun3 up

ip address add 2001:db8:2:2::1/64 dev tun3

IPIP6 と同様に、これらもすぐに広く使用されることはないでしょう。

Create an L2 GRE tunnel device

静的 GRE トンネルは、従来 IPv4 または IPv6 パケットのカプセル化に使用されてきましたが、RFC は GRE ペイロードを L3 プロトコルパケットに限定していません。イーサネットフレームを含むあらゆるものをカプセル化することが可能です。

しかし、Linux では、gre カプセル化は具体的に L3 デバイスを指し、イーサネットフレームを送信できる L2 デバイスの場合は、gretap カプセル化を使用する必要があります。

# L2 GRE over IPv4
ip link add ${interface name} type gretap local ${local endpoint address} remote ${remote endpoint address}

# L2 GRE over IPv6
ip link add ${interface name} type ip6gretap local ${local endpoint address} remote ${remote endpoint address}

これらのトンネルは、他の物理および仮想インターフェイスとブリッジできます。

例:

ip link add gretap0 type gretap local 192.0.2.1 remote 203.0.113.3

ip link add gretap1 type ip6gretap local 2001:db8:dead::1 remote 2001:db8:beef::2
Create a GRE tunnel
ip tunnel add ${interface name} mode gre local ${local endpoint address} remote ${remote endpoint address}

例:

ip tunnel add tun6 mode gre local 192.0.2.1 remote 203.0.113.3

ip link set dev tun6 up

ip address add 192.168.0.1/30 dev tun6

ip address add 2001:db8:1::1/64 dev tun6

GRE は IPv4 と IPv6 を同時にカプセル化できます。ただし、デフォルトでは IPv4 をトランスポートに使用します。GRE over IPv6 の場合、別のトンネルモード ip6gre があります。

Create multiple GRE tunnels to the same endpoint

RFC2890 は「キー付き」GRE トンネルを定義しています。この場合の「キー」は暗号化とは関係ありません。単にルーターが 1 つのトンネルを別のトンネルから区別できるようにする識別子であり、同じエンドポイント間に複数のトンネルを作成できます。

ip tunnel add ${interface name} mode gre local ${local endpoint address} remote ${remote endpoint address} key ${key value}

例:

ip tunnel add tun4 mode gre local 192.0.2.1 remote 203.0.113.6 key 123

ip tunnel add tun5 mode gre local 192.0.2.1 remote 203.0.113.6 key 124

ドット区切り10進数の IPv4 ライクな形式でキーを指定することもできます。

Create a point-to-multipoint GRE tunnel
ip tunnel add ${interface name} mode gre local ${local endpoint address} key ${key value}

例:

ip tunnel add tun8 mode gre local 192.0.2.1 key 1234

ip link set dev tun8 up

ip address add 10.0.0.1/27 dev tun8

${remote endpoint address} がないことに注意してください。これは Cisco IOS の「mode gre multipoint」と同じです。

リモートエンドポイントアドレスがない場合、キーがトンネルトラフィックを識別する唯一の方法となるため、${key value} が必要です。

このタイプのトンネルを使用すると、同じトンネルインターフェイスを使用して複数のエンドポイントと通信できます。これは、複数のエンドポイントが互いに通信する複雑な VPN セットアップで一般的に使用されます(Cisco 用語では「dynamic multipoint VPN」)。

明示的なリモートエンドポイントアドレスがないため、トンネルを作成するだけでは明らかに不十分です。システムは他のエンドポイントがどこにあるかを知る必要があります。実際の生活では、NHRP(Next Hop Resolution Protocol)が使用されます。

テストのために、ピアを手動で追加できます(リモートエンドポイントが物理インターフェイスに 203.0.113.6 アドレス、トンネルに 10.0.0.2 アドレスを使用すると仮定)。

ip neighbor add 10.0.0.2 lladdr 203.0.113.6 dev tun8

リモートエンドポイントでも同様に行う必要があります。

ip neighbor add 10.0.0.1 lladdr 192.0.2.1 dev tun8
Create a GRE tunnel over IPv6

最近のカーネルおよび iproute2 バージョンは、IPv6 上の GRE をサポートしています。キーなしのポイントツーポイント:

ip -6 tunnel add name ${interface name} mode ip6gre local ${local endpoint} remote ${remote endpoint}

上記で説明した IPv4 GRE と同じオプションと機能をすべてサポートするはずです。

Delete a tunnel
ip tunnel del ${interface name}

例: ip tunnel del gre1

古い iproute2 バージョンでは、このコマンドは完全な delete 構文をサポートしておらず、del のみでした。最近のバージョンでは、完全形式と省略形の形式の両方が許可されています(iproute2-ss131122 でテスト済み)。

Modify a tunnel
ip tunnel change ${interface name} ${options}

例:

ip tunnel change tun0 remote 203.0.113.89

ip tunnel change tun10 key 23456

注: キーが指定されていなかったトンネルにキーを追加することはできないようです。バグか機能かは不明です。また、明らかな理由により、トンネルモードをオンザフライで変更することはできません。

View tunnel information
ip tunnel show

ip tunnel show ${interface name}

例:

$ ip tun show tun99

tun99: gre/ip  remote 10.46.1.20  local 10.91.19.110  ttl inherit 

L2TPv3 pseudowires


L2TPv3 は、L2 擬似ワイヤによく使用されるトンネリングプロトコルです。

多くのディストリビューションでは、L2TPv3 はモジュールとしてコンパイルされており、デフォルトではロードされない場合があります。ip l2tp コマンドを実行しても RTNETLINK answers: No such file or directory や Error talking to the kernel のようなエラーが発生する場合は、l2tp_netlink および l2tp_eth カーネルモジュールをロードする必要があります。IP ではなく UDP 上で L2TPv3 を使用したい場合は、l2tp_ip もロードしてください。

Linux の他のトンネリングプロトコル実装と比較して、L2TPv3 の用語はやや逆になっています。トンネル を作成し、それにセッションをバインドします。異なる識別子を持つ複数のセッションを同じトンネルにバインドできます。仮想ネットワークインターフェイス(デフォルトでは l2tpethX という名前)は、トンネル ではなく セッション に関連付けられます。

Note

iproute2 で作成できるのは 静的(管理されていない)L2TPv3 トンネルのみです。リモートアクセス VPN に L2TP を使用する場合、または動的に作成された擬似ワイヤが必要な場合は、ユーザー空間デーモンで処理する必要があります。これはこのドキュメントの範囲外です。

Create an L2TPv3 tunnel over UDP
ip l2tp add tunnel \
tunnel_id ${local tunnel numeric identifier} \
peer_tunnel_id ${remote tunnel numeric identifier} \
udp_sport ${source port} \
udp_dport ${destination port} \
encap udp \
local ${local endpoint address} \
remote ${remote endpoint address}

例:

ip l2tp add tunnel \
tunnel_id 1 \
peer_tunnel_id 1 \
udp_sport 5000 \
udp_dport 5000 \
encap udp \
local 192.0.2.1 \
remote 203.0.113.2

注: 両方のエンドポイントのトンネル識別子およびその他の設定は一致する必要があります。

Create an L2TPv3 tunnel over IP
ip l2tp add tunnel \
tunnel_id ${local tunnel numeric identifier} \
peer_tunnel_id {remote tunnel numeric identifier } \
encap ip \
local 192.0.2.1 \
remote 203.0.113.2

UDP ではなく IP に L2TPv3 フレームをカプセル化すると、オーバーヘッドは少なくなりますが、NAT の背後にあるエンドポイントに問題を引き起こす可能性があります。

Create an L2TPv3 session
ip l2tp add session tunnel_id ${local tunnel identifier} \
session_id ${local session numeric identifier} \
peer_session_id ${remote session numeric identifier}

例:

ip l2tp add session tunnel_id 1 \
session_id 10 \
peer_session_id 10

注: tunnel_id の値は既存のトンネルの値と一致する必要があります(iproute2 はトンネルが存在しない場合、トンネルを作成しません)。両方のエンドポイントのセッション識別子は一致する必要があります。

トンネルとセッションを作成すると、l2tpethX インターフェイスが DOWN 状態で表示されます。状態を UP に変更し、別のインターフェイスとブリッジするか、アドレスを割り当てます。

Delete an L2TPv3 session
ip l2tp del session tunnel_id ${tunnel identifier} \
session_id ${session identifier}

例: ip l2tp del session tunnel_id 1 session_id 1

Delete an L2TPv3 tunnel
ip l2tp del tunnel tunnel_id ${tunnel identifier}

例: ip l2tp del tunnel tunnel_id 1

注: トンネル自体を削除する前に、そのトンネルに関連付けられているすべてのセッションを削除する必要があります。

View L2TPv3 tunnel information
ip l2tp show tunnel

ip l2tp show tunnel tunnel_id ${tunnel identifier}

例: ip l2tp show tunnel tunnel_id 12

View L2TPv3 session information
ip l2tp show session

ip l2tp show session session_id ${session identifier} \
tunnel_id ${tunnel identifier}

例: ip l2tp show session session_id 1 tunnel_id 12

VXLAN


VXLAN は、分散スイッチネットワーク用に設計されたトンネリングプロトコルです。仮想ネットワークトポロジを基盤となる物理ネットワークから分離するために、仮想化セットアップでよく使用されます。

VXLAN は、マルチキャストまたはユニキャストモードで動作でき、イーサネットネットワークの VLAN と同様に VNI(仮想ネットワーク識別子)を使用して仮想ネットワークを分離できます。

マルチキャストモードの欠点は、機能させるために、通常 PIM-SM などのマルチキャストルーティングプロトコルを使用する必要があることですが、セットアップが完了すれば、すべての VXLAN 接続を手動で作成する必要はありません。

VXLAN の基盤となるカプセル化プロトコルは UDP です。

Create a unicast VXLAN link
ip link add name ${interface name} type vxlan \
   id <0-16777215> \
   dev ${source interface}\
   remote ${remote endpoint address} \
   local ${local endpoint address} \
   dstport ${VXLAN destination port}

例:

ip link add name vxlan0 type vxlan \
   id 42 dev eth0 remote 203.0.113.6 local 192.0.2.1 dstport 4789

注: id オプションは VXLAN Network Identifier (VNI) です。

Create a multicast VXLAN link
ip link add name ${interface name} type vxlan \
   id <0-16777215> \
   dev ${source interface} \
   group ${multicast address} \
   dstport ${VXLAN destination port}

例:

ip link add name vxlan0 type vxlan \
   id 42 dev eth0 group 239.0.0.1 dstport 4789

その後、リンクをアップにし、別のインターフェイスとブリッジするか、アドレスを割り当てる必要があります。

GENEVE


GENEVE(Generic Virtual Network Encapsulation)は、通常 L2 フレームを伝送するトンネリングプロトコルです。その基盤となるカプセル化は UDP です(デフォルトポートは 6081)。

その目標は VXLAN、NVGRE、STT と似ていますが、これらのプロトコルとは異なり、拡張可能であり、将来のネットワークニーズに適応できるように、ヘッダーに任意のオプションを追加できます。

VXLAN と同様に、GENEVE は 24 ビット VNI(仮想ネットワーク識別子)を使用します。プロトコル仕様ではユニキャストまたはマルチキャストが可能ですが、Linux カーネルは Linux 6.10 時点で「内部的に」管理される GENEVE トンネルに対してはユニキャストモードのみをサポートしています。

Create a unicast GENEVE link
ip link add name ${interface name} type geneve \
   id <0-16777215> \
   remote ${IPv4 or IPv6 address}

例:

ip link add name gnv0 type geneve id 20 remote 192.0.2.20
ip link	add name gnv1 type geneve id 30	remote 2001:db8:ab:cd::19
Create a unicast GENEVE link with a custom UDP port

デフォルト値の 6081 の代わりにカスタム UDP ポートを指定することが可能です。

例:

ip link add name gnv2 type geneve id 1234 remote 192.0.2.20 dstport 7081
Create an externally managed GENEVE device

アドレスなどが何も指定されていない GENEVE デバイスを作成し、その後 tc フィルタを使用してパケットを GENEVE にカプセル化し、任意のヘッダーを追加することが可能です。

ip link add name ${interface name} external [dstport ${UDP port}]

注: UDP ポートごとに外部管理 GENEVE デバイスは 1 つしか存在できません。そのため、複数のデバイスが必要な場合は、それぞれに異なる dstport オプションを使用してください。

例:

ip link	add name gnv0 external
ip link add name gnv1 external dstport 7081

Routing tables


IPv4 ルートの場合、プレフィックス長またはドット区切り 10 進数サブネットマスクのいずれかを使用できます。つまり、192.0.2.0/24 と 192.0.2.0/255.255.255.0 の両方が同等に受け入れられます。

Note

Linux カーネルは到達不能なネクストホップを持つルートを保持しません。リンクがダウンすると、そのリンクを使用するすべてのルートはルーティングテーブルから永続的に削除されます。この動作に気づかないかもしれませんが、多くの場合、追加のソフトウェア(例: NetworkManager や rp-pppoe)がリンクのアップダウン時にルートを復元する処理を行います。

Linux マシンをルーターとして使用する場合は、FreeRangeRouting や BIRD のようなルーティングプロトコルスイートのインストールを検討してください。これらはリンクの状態を追跡し、リンクがダウンしてからアップしたときにルートを復元します。もちろん、OSPF や BGP のような動的ルーティングプロトコルを使用することもできます。

Connected routes

一部のルートは、明示的な設定なしでシステムに表示されます(「あなたの意に反して」)。

インターフェイスにアドレスを割り当てると、システムはそのネットワークアドレスを計算し、そのネットワークへのルートを作成します(これがサブネットマスクが必要な理由です)。このようなルートを接続ルートと呼びます。

例えば、eth0 に 203.0.113.25/24 を割り当てると、203.0.113.0/24 ネットワークへの接続ルートが作成され、システムはそのネットワークのホストに直接到達できることを認識します。

インターフェイスがダウンすると、それに関連付けられた接続ルートは削除され、ゲートウェイが現在到達不能なネットワークに属するすべてのルートも、ゲートウェイ到達可能性チェックに失敗するため削除されます。同じメカニズムにより、到達不能なゲートウェイを経由するルートの作成が防止されます。

View all routes
ip route

ip route show

-4 および -6 オプションを使用して、IPv4 または IPv6 ルートのみを表示できます。デフォルトでは、IPv4 ルートのみが表示されます。IPv6 ルートを表示するには、ip -6 route を使用します。

View routes to a network and all its subnets
ip route show to root ${address}/${mask}

例えば、ネットワークで 192.168.0.0/24 サブネットを使用しており、それが 192.168.0.0/25 と 192.168.0.128/25 に分割されている場合、これらのすべてのルートを ip route show to root 192.168.0.0/24 で表示できます。

注: to という単語は、すべての「show」コマンドでオプションです。

View routes to a network and all supernets
ip route show to match ${address}/${mask}

192.168.0.0/24 およびそれより大きいすべてのサブネットへのルートを表示したい場合は、ip route show to match 192.168.0.0/24 を使用します。

ルーターは、より一般的でないルートよりもより具体的なルートを優先するため、これは、ルートが存在しない特定のサブネットへのトラフィックが間違った方法で送信される状況でのデバッグに役立つことがよくあります。

View routes to an exact subnet
ip route show to exact ${address}/${mask}

192.168.0.0/25 や 192.168.0.0/16 ではなく、192.168.0.0/24 へのルートを表示したい場合は、ip route show to exact 192.168.0.0/24 を使用できます。

View only the route actually used by the kernel
ip route get ${address}/${mask}

例: ip route get 192.168.0.0/24。

このコマンドは常に 1 つのルートを返すことに注意してください。ほとんどの場合、これは問題ありませんが、マルチパスルーティング設定では結果が全体像を反映しない可能性があるため、対応する「show」コマンドの出力も確認することを忘れないでください。

View route cache (pre 3.6 kernels only)
ip route show cached

バージョン 3.6 まで、Linux はルートキャッシュを使用していました。古いカーネルでは、このコマンドはルートキャッシュの内容を表示します。上記の修飾子とともに使用できます。新しいカーネルでは、何も行いません。

Add a route via a gateway
ip route add ${address}/${mask} via ${next hop}

例:

ip route add 192.0.2.128/25 via 192.0.2.1

ip route add 2001:db8:1::/48 via 2001:db8:1::1
Add a route via an interface
ip route add ${address}/${mask} dev ${interface name}

例: ip route add 192.0.2.0/25 dev ppp0

インターフェイスルートは、PPP トンネルのようなポイントツーポイントインターフェイスで一般的に使用されます。ポイントツーポイントインターフェイスに接続されているホストは 1 台だけである可能性がないため、これらのケースでゲートウェイアドレスを明示的に指定する必要もありません。

Add a route without consistency check for gateway reachability
ip route add ${address}/${mask} dev ${interface name} onlink

例: ip route add 192.0.2.128/25 via 203.0.113.1 dev eth0 onlink

onlink キーワードは、カーネルのゲートウェイ整合性チェックを無効にし、到達不能に見えるゲートウェイ経由のルートの追加を許可します。トンネル設定や、同じリンク上の複数のネットワークが単一のゲートウェイを使用するコンテナ/仮想化ネットワークで役立ちます。

Change or replace a route

ルートを変更するには、ip route change および ip route replace コマンドがあります。両者の違いは、change コマンドは存在しないルートを変更しようとするとエラーを生成することです。replace コマンドは、ルートが存在しない場合は作成します。

例:

ip route change 192.168.2.0/24 via 10.0.0.1

ip route replace 192.0.2.1/27 dev tun0
Delete a route
ip route delete ${route specifier}

例:

ip route delete 10.0.1.0/25 via 10.0.0.1

ip route delete default dev ppp0
Default route

デフォルトルートを作成するためのショートカットがあります。

ip route add default via ${address}/${mask}

ip route add default dev ${interface name}

これらは以下と同等です。

ip route add 0.0.0.0/0 via ${address}/${mask}

ip route add 0.0.0.0/0 dev ${interface name}

IPv6 ルートの場合、default は ::/0 と同等です。

ip -6 route add default via 2001:db8::1
Blackhole routes
ip route add blackhole ${address}/${mask}

例: ip route add blackhole 192.0.2.1/32。

ブラックホールルートに一致する宛先へのトラフィックは、サイレントに破棄されます。

ブラックホールルートには 2 つのユースケースがあります。第一に、非常に高速なアウトバウンドトラフィックフィルターとして機能し、例えば既知のボットネットコントローラーにアクセス不能にしたり、DDoS 攻撃からネットワーク内のサーバーを保護したりできます。第二に、その一部への実際のルートしか持たず、集約して広告したい場合に、ルーティングプロトコルデーモンにネットワークへのルートがあると誤解させるために使用できます。

Other special routes

その他の特殊な目的のルートがいくつかあります。

ip route add unreachable ${address}/${mask}

ip route add prohibit ${address}/${mask}

ip route add throw ${address}/${mask}

これらのルートは、パケットを破棄し、送信者に ICMP エラーメッセージで応答させます。

  • unreachable: ICMP「host unreachable」を送信します。
  • prohibit: ICMP「administratively prohibited」を送信します。
  • throw: 「net unreachable」を送信します。

ブラックホールルートとは異なり、これらのルートは、パケットごとに応答パケットを生成し、さらに多くのトラフィックフローを作成するため、不要なトラフィック(例: DDoS)の停止には推奨できません。内部アクセスポリシーの実装には役立ちますが、通常はファイアウォールの方が適しています。

「throw」ルートは、ポリシーベースルーティングの実装に使用される場合があります。デフォルト以外のテーブルでは、ルーティング検索プロセスを停止しますが、ICMP エラーメッセージは送信しません。

Routes with different metrics
ip route add ${address}/${mask} via ${gateway} metric ${number}

例:

ip route add 192.168.2.0/24 via 10.0.1.1 metric 5

ip route add 192.168.2.0 dev ppp0 metric 10

同じネットワークに対して異なるメトリック値を持つ複数のルートがある場合、カーネルは 最も低い メトリックを持つルートを優先します。

この概念の重要な部分は、インターフェイスがダウンすると、そのイベントによって無効になるルートがルーティングテーブルから削除されること(接続ルート セクションを参照)であり、システムはより高いメトリック値を持つルートにフォールバックすることです。

この機能は、重要な宛先へのバックアップ接続を実装するためによく使用されます。

Multipath routing
ip route add ${addresss}/${mask} nexthop via ${gateway 1} weight ${number} nexthop via ${gateway 2} weight ${number}

マルチパスルートは、システムが重み(重みが大きいほど優先されるため、重み 1 のゲートウェイ/インターフェイスは重み 1 の別のゲートウェイ/インターフェイスよりも約 2 倍のトラフィックを受け取ります)に従って複数のリンク間でパケットを分散させます。必要なだけ多くのゲートウェイを持つことができ、ゲートウェイとインターフェイスルートを混在させることができます。

ip route add default nexthop via 192.168.1.1 weight 1 nexthop dev ppp0 weight 10

警告: このタイプのロードバランシングの欠点は、パケットが受信したリンクと同じリンクを介して送信バックされることが保証されないことです。これは「非対称ルーティング」と呼ばれます。単にパケットを転送し、ローカルトラフィック処理を行わないルーターにとっては、これは通常問題ありません。場合によっては避けられないこともあります。

システムがローカル処理(例: NAT)を行う場合、これは着信接続で問題を引き起こす可能性があります。その場合、ステートフルな L4 ロードバランシング設定を使用する必要があります。

Policy-based routing


Linux におけるポリシーベースルーティング(PBR)は次のように設計されています。まずカスタムルーティングテーブルを作成し、次にどのテーブルをどのパケットに使用するかをカーネルに指示するルールを作成します。

いくつかのテーブルは事前定義されています。

  • local (テーブル 255): ローカルおよびブロードキャストアドレスへの制御ルートが含まれます。
  • main (テーブル 254): すべての非 PBR ルートが含まれます。ルートを追加する際にテーブルを指定しない場合、このテーブルに入ります。
  • default (テーブル 253): 後処理用に予約されており、通常は使用されません。

ユーザー定義テーブルは、それらに最初のルートを追加すると自動的に作成されます。

Create a policy route
ip route add ${route options} table ${table id or name}

例:

ip route add 192.0.2.0/27 via 203.0.113.1 table 10

ip route add 0.0.0.0/0 via 192.168.0.1 table ISP2

ip route add 2001:db8::/48 dev eth1 table 100

注: ポリシールートにも、ルーティングテーブル セクションで説明されている任意のルートオプションを使用できます。唯一の違いは、末尾の table ${table id/name} 部分です。

数値のテーブル識別子と名前は相互に交換可能に使用できます。独自のシンボリック名を作成するには、/etc/iproute2/rt_tables 設定ファイルを編集します。

delete、change、replace、およびその他のすべてのルートアクションは、どのテーブルでも機能します。

ip route ... table main または ip route ... table 254 は、テーブル部分のないコマンドとまったく同じ効果があります。

View policy routes
ip route show table ${table id or name}

例:

ip route show table 100

ip route show table test

注: この場合、show という単語が必要です。ip route table 120 のようなショートカットは機能しません。コマンドが曖昧になるためです。

General rule syntax
ip rule add ${options} <lookup ${table id or name}|blackhole|prohibit|unreachable>

${options}(以下で説明)に一致するトラフィックは、lookup アクションが使用される場合、指定された名前/ID のテーブルに従ってルーティングされます。デフォルトの main/254 テーブルの代わりに。

blackhole、prohibit、および unreachable アクションは、デフォルトテーブルの場合と同様に機能します。

IPv6 ルールの場合、ip -6 を使用します。残りの構文は同じです。

table ${table id or name} は lookup ${table id or name} のショートカットとして使用できます。

Create a rule to match a source network
ip rule add from ${source network} ${action}

例:

ip rule add from 192.0.2.0/24 lookup 10

ip -6 rule add from 2001:db8::/32 prohibit

注: all キーワードは 0.0.0.0/0 または ::/0 のショートカットとして使用できます。

Create a rule to match a destination network
ip rule add to ${destination network} ${action}

例:

ip rule add to 192.0.2.0/24 blackhole

ip -6 rule add to 2001:db8::/32 lookup 100
Create a rule to match a ToS field value
ip rule add tos ${ToS value} ${action}

例: ip rule add tos 0x10 lookup 110。

Create a rule to match a firewall mark value
ip rule add fwmark ${mark} ${action}

例: ip rule add fwmark 0x11 lookup 100。

マークは、ルーティング決定の前に処理されるファイアウォールチェーンで設定されていることを確認してください。そうしないと、そのマークを使用する PBR ルールは効果がありません。優れた netfilter フローチャートは Phil Hagen のブログ で見つけることができます。転送されるトラフィックの場合、mangle FORWARD が良い場所でしょう。例: iptables -t mangle -I FORWARD -s 192.0.2.1 -j MARK --set-mark 0x11。

Create a rule to match an inbound interface
ip rule add iif ${interface name} ${action}

例:

ip rule add iif eth0 lookup 10

ip rule add iif lo lookup 20

iif lo(ループバック)を持つルールは、ローカルに生成されたトラフィックに一致します。

Create a rule to match an outbound interface
ip rule add oif ${interface name} ${action}

例: ip rule add oif eth0 lookup 10。

注: これはローカルに生成されたトラフィックにのみ機能します。

Create a rule to match a user id range
ip rule add uidrange <${start}-${end}>

例:

ip rule add uidrange 1000-1100 lookup 10
ip rule add uidrange 3000-3000 lookup 20

単一のユーザーにルールを適用するには、範囲の開始と終了に同じ UID を使用します。

Set rule priority
ip rule add ${options} ${action} priority ${value}

例:

ip rule add from 192.0.2.0/25 lookup 10 priority 10

ip rule add from 192.0.2.0/24 lookup 20 priority 20

注: ルールは最低優先度から最高優先度まで順に処理され、最初に一致した時点で処理が停止するため、より具体的なルールをより一般的でないルールの前に配置する必要があります。上記の例は、192.0.2.0/24 およびそのサブネット 192.0.2.0/25 のルールを示しています。優先度が逆転し、/25 のルールが /24 のルールの後に配置された場合、それは決して到達されません。

Show all rules
ip rule show

ip -6 rule show
Delete a rule
ip rule del ${options} ${action}

例: ip rule del 192.0.2.0/24 lookup 10

注: ip rule show または ip -6 rule show の出力からコピー/ペーストできます。

Delete all rules
ip rule flush

ip -6 rule flush

注: この操作は非常に破壊的です。ルールを設定していなくても、from all lookup main のような基本的なルールがデフォルトで作成されます。未設定のマシンでは、次のように表示されます。

$ ip rule show
0:	from all lookup local 
32766:	from all lookup main 
32767:	from all lookup default 

$ ip -6 rule show
0:	from all lookup local 
32766:	from all lookup main 

from all lookup local ルールは特別で削除できません。from all lookup main はそうではありません。例えば、明示的なルールを作成したトラフィックのみをルーティングしたい場合など、それがないことには正当な理由がある場合があります。副作用として、ip rule flush を実行すると、そのルールが削除され、ルールを復元するまでシステムはトラフィックのルーティングを停止します。

VRF


VRF(Virtual Routing and Forwarding)は、ネットワークのルートを個別のルーティングテーブルに分離するメカニズムです。これにより、アドレス範囲が競合する複数のネットワークが同じルーター内で共存できます。最も一般的なユースケースは、マルチテナントセットアップや、顧客が独自のネットワークアドレスを使用できるプロバイダーサポート VPN です。

ポリシーベースルーティングとの主な違いは、PBR で使用される「通常の」非デフォルトテーブルは静的ルートのみを分離し、接続ルートは分離しないため、アドレスの競合を解決できないことです。ネットワークインターフェイスが VRF にバインドされると、そこからのすべての接続ルートが別のルーティングテーブルに移動されます。

ネットワーク名前空間とは異なり、VRF はネットワーク層のみで動作します。ネットワークスタックの個別のコピーを作成せず、LLDP のような L2 プロトコルに干渉せず、1 つのプロセスが複数の VRF にソケットをバインドできます(動的ルーティングプロトコルまたは IPsec デーモンに便利です)。

Create a VRF
ip link add ${name} type vrf table ${table}

例: sudo ip link add foo type vrf table 100

ルーティングテーブル 100 が存在しない場合、自動的に作成されます。

View configured VRFs
ip vrf show

ip link show vrf ${vrf}

ip vrf show の出力は VRF とルーティングテーブルの関連付けのみを示しますが、VRF とネットワークインターフェイスの関連付けは示しません。VRF のすべてのインターフェイスを表示するには、ip link show vrf ${vrf} を使用します。

Bind an interface to a VRF
ip link set ${interface} master ${vrf}

例: ip link set eth0 master foo。

インターフェイスに関連付けられたすべての接続ルートは、VRF テーブルに移動されます。例えば、eth0 がアドレス 192.0.2.1/24 を持ち、VRF インスタンス foo がテーブル 100 を使用する場合、192.0.2.0/24 へのルートはメインテーブルから削除され、テーブル 100 に再表示されます。

Remove an interface from a VRF
ip link set ${interface} nomaster

そのインターフェイスに関連付けられた接続ルートは、メインテーブルに戻されます。

Run a command inside a VRF
ip vrf exec ${vrf} ${command}

例: ip vrf exec ping 192.0.2.100。

プロセスのトラフィックは VRF テーブルのルートに従ってルーティングされるため、トラブルシューティングに役立ちます。

Check if a process is running in a VRF
ip vrf identify ${pid}

PID ${pid} を持つプロセスが VRF で実行されている場合、コマンドはその名前を表示します。VRF で実行されていない場合、コマンドの出力は空です。

List processes running in a VRF
ip vrf pids ${vrf}

${vrf} が存在しない場合、コマンドはエラーメッセージを表示します。存在しても、そこに実行中のプロセスがない場合、出力は空です。

Network namespaces


ネットワーク名前空間は、単一のマシン内の独立したネットワークスタックインスタンスです。セキュリティドメインの分離、仮想マシン間のトラフィックフローの管理などに使用できます。

各名前空間は、独自のインターフェイス、アドレス、ルートなどを持つネットワークスタックの完全なコピーです。名前空間内でプロセスを実行し、名前空間を物理インターフェイスにブリッジできます。

Create a namespace
ip netns add ${namespace name}

例: ip netns add foo

List existing namespaces
ip netns list
Delete a namespace
ip netns delete ${namespace name}

例: ip netns delete foo。

Run a process inside a namespace
ip netns exec ${namespace name} ${command}

例: ip netns exec foo /bin/sh。

注: 非デフォルト名前空間にプロセスを割り当てるには、root 権限が必要です。

対話型シェルを含む任意のプロセスを名前空間内で実行できます。別の名前空間で ip 自体を実行したい場合は、ip netns exec ${namespace name} ip ${ip subcommand}(他のコマンドと同様)または -n/-netns ショートカット ip -n ${namespace name} ${ip subcommand} のいずれかを使用できます。

List all processes assigned to a namespace
ip netns pids ${namespace name}

出力は PID のリストになります。

Identify process' primary namespace
ip netns identify ${pid}

例: ip netns identify 9000。

Assign a network interface to a namespace
ip link set dev ${interface name} netns ${namespace name}

ip link set dev ${interface name} netns ${pid}

例: ip link set dev eth0.100 netns foo。

注: インターフェイスを名前空間に割り当てると、デフォルト名前空間から消え、ip netns exec ${namespace name} または ip -n ${namespace name} ${ip subcommand} を介して、ip -n ${namespace name} link set dev dummy0 down のように、すべての操作を実行する必要があります。

さらに、インターフェイスを別の名前空間に移動すると、それに設定されている IP アドレスなどの既存の設定はすべて失われ、DOWN 状態になります。再度アップにして再設定する必要があります。

名前空間名の代わりに PID を指定した場合、インターフェイスはその PID を持つプロセスのプライマリ名前空間に割り当てられます。これにより、例えば ip -n ${namespace name} link set dev ${intf} netns 1(init または PID 1 を持つ他のプロセスは、デフォルト名前空間にほぼ確実に存在するため)を使用して、インターフェイスをデフォルト名前空間に戻すことができます。

Connect one namespace to another

これは、veth リンクのペアを作成し、それらを異なる名前空間に割り当てることで実行できます。

「foo」という名前の名前空間をデフォルト名前空間に接続したいとします。まず、veth デバイスのペアを作成します: ip link add name veth1 type veth peer name veth2。

veth2 を名前空間 foo に移動します: ip link set dev veth2 netns foo。

「foo」名前空間で veth2 をアップにし、アドレスを追加します。

ip -n foo link set dev veth2 up

ip -n foo address add 10.1.1.1/24 dev veth2

デフォルト名前空間に残っている veth1 にアドレスを追加します: ip address add 10.1.1.2/24 dev veth1。

これで、foo 名前空間にある 10.1.1.1 に ping を実行し、その名前空間の他のインターフェイスに設定されているサブネットへのルートを設定できます。

ルーティングではなくスイッチングを行いたい場合は、これらの veth インターフェイスを対応する名前空間の他のインターフェイスとブリッジできます。同じ技術を、名前空間を物理ネットワークに接続するために使用できます。

Monitor network namespace subsystem events
ip netns monitor

名前空間の作成と削除などのイベントが発生したときに表示します。

Multicast groups and routes


マルチキャストは主にアプリケーションとルーティングデーモンによって処理されるため、手動で行うことはあまりありません。マルチキャスト関連の ip コマンドは、主にデバッグに役立ちます。

View multicast groups
ip maddress show

ip maddress show ${interface name}

例:

$ ip maddress show dev lo
1:	lo
	inet  224.0.0.1
	inet6 ff02::1
	inet6 ff01::1
Add a link-layer multicast address

IP マルチキャストグループに手動で参加することはできませんが、マルチキャスト MAC アドレスを追加することはできます(めったに必要ありませんが)。

ip maddress add ${MAC address} dev ${interface name}

例: ip maddress add 01:00:5e:00:00:ab dev eth0。

View multicast routes

マルチキャストルートは手動で追加できないため、このコマンドはルーティングデーモンによってインストールされたマルチキャストルートのみを表示できます。ユニキャストルート表示コマンド(iif、table、from など)と同じ修飾子をサポートしています。

ip mroute show

Network event monitoring


ネットワーク構成、ルーティングテーブル、ARP/NDP テーブルの変更など、特定のネットワークイベントを iproute2 で監視できます。

Monitor all events

パラメータなしでコマンドを呼び出すか、明示的に all を指定できます。

ip monitor

ip monitor all
Monitor specific events
ip monitor ${event type}

イベントタイプは次のとおりです。

  • link: リンクの状態。インターフェイスのアップダウン、仮想インターフェイスの作成または削除など。
  • address: リンクアドレスの変更。
  • route: ルーティングテーブルの変更。
  • mroute: マルチキャストルーティングの変更。
  • neigh: ネイバー(ARP および NDP)テーブルの変更。

IPv4 と IPv6 のサブシステムが別々にある場合、通常の -4 および -6 オプションを使用すると、指定されたプロトコルのイベントのみを表示できます。

ip -4 monitor route

ip -6 monitor neigh

ip -4 monitor address
Read a log file produced by rtmon

iproute2 には rtmon というプログラムが含まれています。これは実質的に同じ目的を果たしますが、イベントを画面に表示する代わりにバイナリログファイルに書き込みます。これらのログファイルは ip monitor コマンドで読み取ることができます。

ip monitor ${event type} file ${path to the log file}

rtmon の構文は ip monitor に似ていますが、イベントタイプは link、address、route、all に制限されており、アドレスファミリは -family オプションを使用して指定されます。

rtmon [-family <inet|inet6>] [<route|link|address|all>] file ${log file path}

netconf (sysctl configuration viewing)


View sysctl configuration for all interfaces
ip netconf show
View sysctl configuration for specific interface
ip netconf show dev ${interface}

例: ip netconf show dev eth0

Contributors

Content: Nicolas Dichtel, Russel Stuart, Phil Huang, Haishan, Emil Pederson, Nick B.

Grammar, style, typo fixes: Trick van Staveren, powyginanachla, Nathan Handler, Bhaskar Sarma Upadhyayula, Geert Stappers, Alex White-Robinson, Achilleas Pipinellis, fauxm, fgtham, eri, Zhuoyun Wei, Jonathan ZHAO, Julien Barbot, thoastbrot.

Design: elico, alex-eri.