nmcliでLinuxブリッジを設定する方法｜KVMや仮想化環境のブリッジネットワーク設計と動作確認

この記事のポイント

・nmcli connection add type bridge でブリッジデバイスを作成できる
・物理NICはbridge-slaveとしてブリッジに追加し、元のプロファイルは削除する
・bridge link showでスレーブのforwarding状態を確認し疎通を検証する
・STP遅延（約30秒）が発生する場合はbridge.stp noで即時収束させられる

# 接続プロファイルとデバイスの対応を確認する
nmcli connection show

# デバイス一覧と状態を確認する
nmcli device status

$ nmcli connection show
NAME          UUID                                  TYPE      DEVICE
enp1s0        a1b2c3d4-e5f6-7890-abcd-ef1234567890  ethernet  enp1s0
lo            00000000-0000-0000-0000-000000000000  loopback  lo

$ nmcli device status
DEVICE   TYPE      STATE      CONNECTION
enp1s0   ethernet  connected  enp1s0
lo       loopback  unmanaged  --

# ブリッジ接続プロファイルを作成する
nmcli connection add type bridge con-name br0 ifname br0

# DHCPでIPを取得する場合（デフォルト。変更不要）
nmcli connection modify br0 ipv4.method auto

# 固定IPを設定する場合
nmcli connection modify br0 ipv4.addresses "192.168.1.100/24"
nmcli connection modify br0 ipv4.gateway "192.168.1.1"
nmcli connection modify br0 ipv4.dns "192.168.1.1"
nmcli connection modify br0 ipv4.method manual

# enp1s0をブリッジ br0 のスレーブとして追加する
nmcli connection add type bridge-slave con-name br0-slave ifname enp1s0 master br0

# 元のEthernetプロファイルを削除する（SSHの場合はここで切断される）
nmcli connection delete enp1s0

# スレーブ側を先に有効化する
nmcli connection up br0-slave

# ブリッジを有効化する（DHCPの場合、IPアドレス取得まで数秒かかる）
nmcli connection up br0

$ ip addr show br0
4: br0:  mtu 1500 qdisc noqueue state UP group default qlen 1000
    link/ether 52:54:00:1a:2b:3c brd ff:ff:ff:ff:ff:ff
    inet 192.168.1.100/24 brd 192.168.1.255 scope global dynamic noprefixroute br0
       valid_lft 86382sec preferred_lft 86382sec

# VMの現在のネットワーク設定を確認する
virsh domiflist testvm

# XMLを開いてネットワーク設定を編集する
virsh edit testvm

<!-- 変更前（NAT構成 default network）-->
<interface type='network'>
  <source network='default'/>
  <model type='virtio'/>
</interface>

<!-- 変更後（ブリッジ構成）-->
<interface type='bridge'>
  <source bridge='br0'/>
  <model type='virtio'/>
</interface>

virt-install   --name testvm   --vcpus 2   --memory 2048   --disk size=20   --cdrom /path/to/rocky9.iso   --network bridge=br0,model=virtio   --os-variant rhel9.4

$ bridge link show
2: enp1s0:  mtu 1500 master br0 state forwarding priority 32 cost 100

$ ip link show type bridge
4: br0:  mtu 1500 qdisc noqueue state UP mode DEFAULT group default qlen 1000
    link/ether 52:54:00:1a:2b:3c brd ff:ff:ff:ff:ff:ff

$ ping -c 3 192.168.1.1
PING 192.168.1.1 (192.168.1.1) 56(84) bytes of data.
64 bytes from 192.168.1.1: icmp_seq=1 ttl=64 time=0.812 ms
64 bytes from 192.168.1.1: icmp_seq=2 ttl=64 time=0.743 ms
64 bytes from 192.168.1.1: icmp_seq=3 ttl=64 time=0.788 ms

--- 192.168.1.1 ping statistics ---
3 packets transmitted, 3 received, 0% packet loss, time 2048ms
rtt min/avg/max/mdev = 0.743/0.781/0.812/0.029 ms

# STPを無効化して即時収束させる
nmcli connection modify br0 bridge.stp no
nmcli connection up br0

# STPの設定状態を確認する
nmcli connection show br0 | grep bridge.stp

# ルーティングテーブルを確認する（br0経由のデフォルトゲートウェイが期待値）
ip route show

# 期待される出力例
default via 192.168.1.1 dev br0 proto dhcp metric 425
192.168.1.0/24 dev br0 proto kernel scope link src 192.168.1.100

# ブリッジに参加しているインターフェースを確認する
bridge fdb show | grep -v permanent | head -20

# NetworkManagerを再起動してプロファイルを再読み込みする
systemctl restart NetworkManager

# 接続状態を確認する
nmcli connection show --active

# Ubuntu でのnetplanバックエンド確認
networkctl status

# nmcli が管理しているデバイスを確認する
nmcli device status