Netzwerkschnittstellen unter Ubuntu mit netplan konfigurieren und Änderungen testen, ohne die Verbindung zu verlieren

Ziel

Statische IP-Adresse, Route oder Bonding-Konfiguration unter Ubuntu 22.04/24.04 über netplan ändern, ohne zu riskieren, sich auf einem entfernten Rechner auszusperren.

Voraussetzungen

Root-Zugriff; der aktive Renderer ist bekannt (networkd ist der Standard bei Server, NetworkManager bei Desktop); eine Sitzungsart, die einen kurzen Netzwerkausfall übersteht (für das abschliessende apply ist Konsolenzugriff sicherer als SSH).

Schritte

1. Die vorhandene Konfiguration ausfindig machen, normalerweise eine Datei unter /etc/netplan/*.yaml. Laut der YAML-Referenz von netplan bezeichnet der Schlüssel renderer "the tool that will be used to set up your configuration. Valid values are networkd and NetworkManager" (das Werkzeug, mit dem die Konfiguration eingerichtet wird; gültige Werte sind networkd und NetworkManager). Ist er nicht gesetzt, gilt networkd als Standard.
2. Eine Datei mit den gewünschten Einstellungen bearbeiten oder neu anlegen, zum Beispiel für eine statische Adresse:

   network:
     version: 2
     ethernets:
       eth0:
         addresses: [192.0.2.10/24]
         routes:
           - to: default
             via: 192.0.2.1
         nameservers:
           addresses: [192.0.2.1]
   

3. Die YAML-Dateien nur für root lesbar halten (chmod 600 /etc/netplan/*.yaml); aktuelles netplan warnt vor Dateien, die für alle lesbar sind, weil sie WLAN-Schlüssel und andere Geheimnisse enthalten können. Die Syntax ohne Anwendung prüfen: netplan generate schreibt die Backend-Konfiguration in ein temporäres Verzeichnis und bricht bei einem YAML- oder Schemafehler mit einer deutlichen Fehlermeldung ab.
4. In jeder Sitzung, in der ein Fehler die Verbindung kappen könnte, netplan try statt direkt netplan apply verwenden. netplan try "takes a netplan configuration, applies it, and automatically rolls it back if the user does not confirm the configuration within a time limit" (nimmt eine netplan-Konfiguration, wendet sie an und macht sie automatisch rückgängig, wenn der Benutzer sie nicht innerhalb einer Frist bestätigt). Die Frist beträgt standardmässig 120 Sekunden und lässt sich mit --timeout ändern.
5. Innerhalb der Frist mit der Eingabetaste bestätigen; ist die Sitzung bereits abgebrochen, nichts tun – das automatische Zurücksetzen stellt die vorherige Konfiguration wieder her.
6. Nach der Bestätigung netplan apply ausführen, falls weitere Änderungen vorgenommen wurden; anschliessend mit ip addr show eth0 und ip route prüfen.

Erwartetes Ergebnis

ip addr zeigt unmittelbar nach einem bestätigten netplan try/apply die neue Adresse an; eine fehlerhafte Konfiguration wird innerhalb der Frist von selbst zurückgesetzt, und die Verbindung steht ohne manuelle Wiederherstellung wieder zur Verfügung.

Grenzen und Prüfbasis

Manche Konfigurationen (etwa Bridges mit aktiviertem STP) können über eine Minute brauchen, bis sie sich stabilisieren; die Hinweise des Werkzeugs zu bekannten Problemen nennen dies als Fall, in dem die Standardfrist zu kurz sein kann. Ein Neustart ist nicht nötig; eine erneute Anmeldung kann nur erforderlich sein, wenn die Änderung die für die aktuelle Sitzung genutzte Schnittstelle betrifft. Das klassische Debian-Pendant ifupdown hält die Schnittstellendefinitionen statt in YAML in /etc/network/interfaces und wendet sie mit ifup/ifdown statt über einen Renderer an. Es kennt keinen vergleichbaren Befehl mit Testlauf und automatischem Zurücksetzen, daher sollten Änderungen dort direkt über Konsolenzugriff getestet werden.