Statische IPv4-Adresse mit nmcli setzen, ohne sich auszusperren

Ziel

Einer Netzwerkschnittstelle über NetworkManager eine statische IPv4-Adresse, ein Gateway und DNS-Server zuweisen, und zwar so, dass eine SSH-Sitzung über die zu ändernde Schnittstelle nicht abgeschnitten wird.

Voraussetzungen

• NetworkManager ist aktiv (nmcli general status); ein Verbindungsprofil ist bereits an das Zielgerät gebunden.
• Root-Rechte oder eine polkit-Regel, die Verbindungsänderungen erlaubt.
• Ein zweiter Zugriffsweg (Konsole, Out-of-Band-Management oder eine zweite Netzwerkkarte) ist die einzige vollständig sichere Rückfallebene. Ohne einen solchen Zugang ist ein geklontes Profil in Kombination mit einem geplanten automatischen Rollback (Schritt 4) die zweitbeste Lösung; das Klonen allein hilft nicht mehr, sobald die Sitzung weg ist.

Schritte

1. Aktuellen Zustand prüfen: nmcli -t -f NAME,DEVICE,TYPE connection show und nmcli device show eth0.
2. Das laufende Profil klonen, statt es direkt zu bearbeiten: nmcli connection clone "eth0-dhcp" "eth0-static". So bleibt das funktionierende Profil unverändert.
3. Den Klon konfigurieren (die aktive Verbindung ist davon noch nicht betroffen):

   nmcli connection modify eth0-static ipv4.addresses 203.0.113.10/24
   nmcli connection modify eth0-static ipv4.gateway 203.0.113.1
   nmcli connection modify eth0-static ipv4.dns "203.0.113.53 203.0.113.54"
   nmcli connection modify eth0-static ipv4.method manual
   nmcli connection modify eth0-static connection.autoconnect yes
   

4. Zuerst einen Rollback einplanen, dann aktivieren: systemd-run --on-active=5min nmcli connection up eth0-dhcp (als root), anschliessend nmcli -w 30 connection up eth0-static. Ist die neue Adresse falsch und bricht die Sitzung ab, stellt der Timer nach fünf Minuten das alte Profil wieder her; die Aktivierung läuft innerhalb von NetworkManager, eine abgebrochene SSH-Sitzung beendet sie also nicht. Nicht darauf verlassen, dass ein Neustart das alte Profil wiederherstellt: Bei zwei Autoconnect-Profilen für dasselbe Gerät bevorzugt NetworkManager dasjenige mit dem höheren connection.autoconnect-priority und danach das zuletzt verwendete – also das neue Profil.
5. Sobald die Erreichbarkeit der neuen Adresse aus einer neuen Sitzung bestätigt ist, den Rollback abbrechen (systemctl list-timers 'run-*', danach systemctl stop <unit>.timer) und das alte Profil deaktivieren oder löschen: nmcli connection modify eth0-dhcp connection.autoconnect no (Profil für einen Rollback behalten) oder nmcli connection delete eth0-dhcp.

Erwartetes Ergebnis

nmcli -t -f IP4.ADDRESS,IP4.GATEWAY,IP4.DNS device show eth0 zeigt die neuen Werte an. Neue Profile werden unter Debian, Fedora 33+ und RHEL 9+ als Keyfiles in /etc/NetworkManager/system-connections/ gespeichert; RHEL 8 schreibt ifcfg-Dateien nach /etc/sysconfig/network-scripts/, und Ubuntu 23.10+ legt NetworkManager-Profile als Netplan-YAML ab (/etc/netplan/90-NM-*.yaml).

Grenzen und Prüfbasis

Die Befehle wurden anhand der Manpage nmcli(1) (Paket network-manager) geprüft. nmcli connection up blockiert, bis die Verbindung den Zustand «aktiviert» erreicht oder eine Zeitüberschreitung eintritt (-w seconds steuert das Timeout, Standardwert 90 Sekunden); ein nicht interaktives Skript sollte -w immer ausdrücklich angeben, statt sich auf den Standardwert zu verlassen.