Debian 12 QEMU-Netzwerkbrücken: Einrichtung

Netzwerkbrücken in Debian 12 für QEMU konfigurieren: Temporär und permanent

Netzwerkbrücken in Linux ermöglichen es virtuellen Maschinen, sich als vollwertige Knoten in das lokale Netzwerk einzubinden. Im Gegensatz zum User-Modus von QEMU bietet der Bridge-Modus eine direkte Interaktion mit dem physischen LAN. Grundkenntnisse der OSI-Schichten 1–3 sowie der Unterschiede zwischen Switches und Routern sind erforderlich. Alle Befehle werden als root oder mit sudo ausgeführt.

Eine Brücke fungiert als virtueller Switch mit einer unbegrenzten Anzahl von Ports. Ohne hinzugefügte Interfaces gibt es nur eine virtuelle Schnittstelle mit demselben Namen. Das Hinzufügen von Ports (physisch oder tap) macht sie zu einem Teil des Switches: IP- und MAC-Adressen der einzelnen Schnittstellen werden ignoriert.

Beispiel: drei physische NICs + Brücke = vier Switch-Ports, mit einer verwalteten IP auf der Brücke.

Temporäre Erstellung einer Brücke

Erstellen Sie eine Brücke namens bridge0:

ip link add bridge0 type bridge
ip link set dev bridge0 up

Status mit ip a prüfen. Die Schnittstelle wird UP geschaltet, wenn ein aktiver Port hinzugefügt wird (physische NIC mit Link oder tap von VM).

Eine Schnittstelle hinzufügen, z. B. enp2s0:

ip link set enp2s0 master bridge0

Zum Entfernen: ip link set enp2s0 nomaster. Funktioniert mit Wi-Fi und einzelnen NICs – der Host nutzt die Brücke mit einer neuen MAC.

Das Netzwerk fällt nach dem Hinzufügen aus. IP beziehen:

• DHCP: dhclient -v bridge0
• Static: ip a add 172.16.5.2/24 dev bridge0 && ip route add default via 172.16.5.1 dev bridge0

VM im Bridge-Modus erhält eine IP aus dem Netzwerk des Hosts.

Zum Löschen: ip link delete bridge0. Schnittstellen kehren in den Originalzustand zurück. Brücke verschwindet beim Neustart.

Permanente Konfiguration über /etc/network/interfaces

Für Persistenz /etc/network/interfaces oder eine Datei in /etc/network/interfaces.d/ bearbeiten.

Grundbeispiel für virtbr0 (statische IP, standardmäßig keine Ports):

auto virtbr0
iface virtbr0 inet static
    address 10.15.15.1
    netmask 255.255.255.0
    bridge_fd 0
    bridge_maxwait 0
    bridge_ports none
    bridge_hello 2
    bridge_maxage 20
    bridge_stp off

Wichtige Parameter:

• auto / iface: automatischer Start.
• inet static / dhcp / manual: IP-Typ (manual — keine IP, manuell hinzufügen).
• bridge_ports none: leere Brücke; QEMU fügt tap dynamisch hinzu. Oder enp2s0 usw. angeben.
• bridge_fd 0, bridge_maxwait 0: Aktivierungsverzögerungen (0 für einfache Fälle).
• bridge_hello 2, bridge_maxage 20: BPDU für STP.
• bridge_stp off: Spanning Tree deaktivieren (für Test-VMs).
• bridge_hw MAC: Brücken-MAC festlegen oder von Schnittstelle übernehmen.

Für eine physische NIC in der Brücke auf manual ändern (dhcp entfernen).

Aktivieren: systemctl restart networking.service. Bestehende Brücke wird nicht automatisch gelöscht – ip link delete oder Neustart verwenden. Mit ip a überwachen.

Integration mit QEMU

VM mit Brücke starten:

-net nic,model=e1000e,macaddr=52:54:00:a9:2b:c7 -net bridge,br=bridge0

Aufschlüsselung:

• -net nic,...: emuliert NIC im Guest-OS (e1000e — Gigabit Intel; unique MAC für Multi-VM).
• -net bridge,br=bridge0: erstellt tap auf Host, fügt zur Brücke hinzu, verbindet mit Patchkabel.

Tap-MAC wird in Brücke ignoriert. Ohne br=bridge0 startet die VM nicht.

Wichtige Punkte

• Brücken aus bridge-utils (apt install) — dynamisch; networking — persistent.
• UP-Zustand nur mit aktiven Ports; ip a für Diagnose.
• Wi-Fi/einzelne NIC: unterstützt, Host funktioniert über Brücke.
• STP aus für Einfachheit; hello/maxage — Standardwerte.
• QEMU tap automatisch hinzugefügt; unique MACs in VMs.

— Editorial Team