Zum Inhalt

netplan

Konfiguriert unter Ubuntu das Netzwerk aus YAML-Dateien in /etc/netplan/. Netplan erzeugt daraus die Konfiguration für systemd-networkd oder den NetworkManager.

netplan output

Syntax

netplan BEFEHL [OPTION]...

Optionen

Befehl Beschreibung
try Die Konfiguration anwenden und nach 120 Sekunden zurückrollen, wenn du nicht bestätigst
apply Die Konfiguration sofort anwenden
generate Nur prüfen und erzeugen, nicht anwenden
get [SCHLÜSSEL] Die zusammengeführte Konfiguration zeigen oder einen Schlüssel wie ethernets.ens18.addresses
status Aktueller Zustand aller Schnittstellen: Adressen, Routen, DNS

Beispiele

Den aktuellen Zustand des Netzwerks anzeigen:

netplan status
     Online state: online
    DNS Addresses: 127.0.0.53 (stub)
       DNS Search: example.com

●  2: ens18 ethernet UP (networkd: ens18)
      MAC Address: bc:24:11:5e:3a:7c (Proxmox Server Solutions GmbH)
        Addresses: 192.0.2.10/24
                   2001:db8::10/64
                   fe80::be24:11ff:fe5e:3a7c/64 (link)
    DNS Addresses: 192.0.2.53
                   198.51.100.53
       DNS Search: example.com
           Routes: default via 192.0.2.1 (static)
                   192.0.2.0/24 from 192.0.2.10 (link)
                   2001:db8::/64 metric 256
                   fe80::/64 metric 256

1 inactive interfaces hidden. Use "--all" to show all.

Eine feste Konfiguration:

sudo cat /etc/netplan/50-cloud-init.yaml
network:
  version: 2
  ethernets:
    ens18:
      addresses:
        - 192.0.2.10/24
        - "2001:db8::10/64"
      routes:
        - to: default
          via: 192.0.2.1
      nameservers:
        addresses: [192.0.2.53, 198.51.100.53]
        search: [example.com]

In YAML zählt die Einrückung: immer Leerzeichen, nie Tabs. Mach die Datei nur für root lesbar: sudo chmod 600 /etc/netplan/50-cloud-init.yaml.

Eine Änderung sicher testen:

sudo netplan try
Do you want to keep these settings?


Press ENTER before the timeout to accept the new configuration


Changes will revert in 120 seconds
Configuration accepted.

Verlierst du die Verbindung, kannst du Enter nicht drücken, und netplan stellt nach 120 Sekunden die alte Konfiguration wieder her.

Ein Tippfehler in der YAML-Datei:

sudo netplan generate
/etc/netplan/50-cloud-init.yaml:12:9: Invalid YAML: did not find expected key:
        nameservers:
        ^

Zeile 12, Spalte 9: nameservers ist um ein Leerzeichen zu weit eingerückt.

Einen einzelnen Wert lesen:

sudo netplan get ethernets.ens18.addresses
- "192.0.2.10/24"
- "2001:db8::10/64"

Wann brauche ich das?

  • Auf Ubuntu-Servern, um eine feste IP-Adresse, das Gateway oder DNS-Server zu setzen
  • Um eine zweite Adresse, ein VLAN oder eine Bridge hinzuzufügen
  • Nach dem Klonen einer VM, wenn sich Schnittstellenname oder Adresse ändern müssen

Über SSH immer try statt apply

netplan try rollt automatisch zurück, wenn dich die neue Konfiguration aussperrt. Mit apply bräuchtest du die Konsole des Hosters.

Cloud-Images überschreiben die Datei

Auf Cloud-Servern legt cloud-init oft 50-cloud-init.yaml an und kann sie beim nächsten Booten überschreiben. Trag eigene Einstellungen in eine eigene Datei wie 60-static.yaml ein oder schalte die Netzwerkkonfiguration von cloud-init ab.

Unterschiede zwischen Distributionen

Debian Ubuntu RHEL Arch
Netzwerkkonfiguration ifupdown, netplan nur in Cloud-Images netplan NetworkManager systemd-networkd oder NetworkManager

Verwandte Befehle

ip · resolvectl · nmcli · ifup