Community-Lösung

ZimaOS-IP-Adresse geändert: Stabilisieren

After moving from TrueNAS SCALE to an early ZimaOS beta, a reboot changed the server's DHCP address and some applications stopped working.

Fazit: DHCP-Reservierung oder manuelle statische IP verwenden – NAS-Adresse nicht ändern lassen

Das Problem im Jahr 2023 war einfach: ZimaOS bezog seine Adresse per DHCP, die Lease änderte sich nach einem Neustart, und Apps, die auf die alte IP verwiesen, funktionierten nicht mehr. Das aktuelle ZimaOS bietet nun richtige Einstellungen für statische IP-Adressen pro Schnittstelle, sodass Sie nicht mehr ausschließlich auf eine Router-Umgehungslösung angewiesen sind. Ziel ist eine stabile Adresse, kein cleverer Hostnamen-Hack.

Option 1: Adresse im Router reservieren

Eine DHCP-Reservierung belässt ZimaOS bei der automatischen Adressvergabe, weist den Router jedoch an, derselben MAC-Adresse immer dieselbe IP zuzuweisen. Das ist in Heimnetzwerken meist die sauberste Lösung, da Gateway, Subnetz und DNS zentral verwaltet bleiben. Notieren Sie die Ethernet-MAC-Adresse von ZimaOS, erstellen Sie die Reservierung und erneuern Sie anschließend die Lease oder starten Sie den Server neu.

Option 2: Manuelle IP-Adresse in ZimaOS festlegen

Mit dem aktuellen ZimaOS können Sie für jede Ethernet-Schnittstelle von DHCP auf „Manuell“ umschalten. Geben Sie IP-Adresse, Subnetzmaske, Gateway und DNS-Server ein und speichern Sie die Einstellungen. Die Netzwerkeinstellungen von ZimaOS dokumentieren den aktuellen Ablauf.

Wählen Sie eine Adresse außerhalb des regulären DHCP-Pools des Routers oder reservieren Sie diese Adresse ausdrücklich, damit sie später nicht einem anderen Gerät zugewiesen wird.

Gateway nicht erraten

Eine statische Adresse kann korrekt aussehen, während der externe Zugriff aufgrund eines falschen Gateways fehlschlägt. Prüfen Sie bei einem funktionierenden Client oder im Router das tatsächliche Gateway. Unter ZimaOS:

ip addr
ip route
cat /etc/resolv.conf

Normalerweise sollte eine gültige Standardroute über den LAN-Router angezeigt werden. Die IP-Routing-Tabelle von Linux erklärt, wie die Routenauswahl funktioniert.

Apps sollten keine temporäre DHCP-Adresse fest einprogrammieren

Reverse-Proxys, Webhook-Rückrufe, eingebundene Freigaben und App-URLs werden unzuverlässig, wenn sie auf eine Adresse verweisen, die sich ändern kann. Bevorzugen Sie, sofern unterstützt, stabile lokale DNS-Namen oder eine reservierte/statische IP-Adresse. Wenn ein Container die alte Hostadresse in einer Umgebungsvariablen speichert, aktualisieren Sie diese Konfiguration nach der Netzwerkänderung.

Die App-Netzwerkfunktionen von ZimaOS helfen dabei, vorhersehbare App-Endpunkte beizubehalten.

Konsole verwenden, wenn Sie die WebUI verlieren

Wenn ein Fehler bei der statischen IP-Adresse die Verbindung zum Dashboard unterbricht, zeigt der angeschlossene Monitor die aktuelle ZimaOS-IP-Adresse an. Das aktuelle ZimaOS bietet außerdem eine netzwerkbasierte Zurücksetzung per USB über eine leere Datei namens _ResetNetwork auf einem exFAT-USB-Laufwerk. Die Netzwerkzurücksetzung von ZimaOS ist die unterstützte Ausweichlösung.

Pro physischer Schnittstelle eine Adresse reservieren

Systeme mit zwei Netzwerkschnittstellen können unterschiedliche MAC-Adressen und unterschiedliche Subnetze haben. Reservieren Sie nicht dieselbe IP-Adresse für beide Schnittstellen. Legen Sie fest, welcher Port als Verwaltungs-/LAN-Schnittstelle dient, und belassen Sie das Standardgateway dort, sofern Sie nicht ausdrücklich Policy Routing verwenden.

Die Netzwerkfunktionen des ZimaBoard 2 bieten ein aktuelles Hardwarebeispiel mit zwei Ports.

Fehlerbehebung von einem anderen Gerät aus überprüfen

ping ZIMAOS_IP
arp -a

Starten Sie ZimaOS anschließend einmal neu und bestätigen Sie, dass wieder dieselbe Adresse verwendet wird. Öffnen Sie die Apps, die zuvor nicht funktioniert haben, und prüfen Sie, ob deren gespeicherte Hostnamen/IP-Adressen weiterhin auf die stabile Adresse verweisen.

Warum Router-Reservierungen oft sicherer sind als beliebige statische Adressen

DHCP ist darauf ausgelegt, Adressen zentral zu vergeben. Eine manuell ausgewählte IP-Adresse innerhalb des aktiven Pools kann daher später mit einem anderen Client kollidieren. Das DHCP-Lease-Modell erklärt, warum eine Reservierung im Router die zentrale Adressverwaltung beibehält und das NAS dennoch vorhersehbar macht. Unabhängig von der gewählten Methode sollten Sie Adresse, Gateway, DNS-Server und MAC-Adresse der Schnittstelle dokumentieren.

FAQ

Warum hat sich meine ZimaOS-IP-Adresse nach dem Neustart geändert?

DHCP kann eine andere Lease vergeben, sofern der Router die Adresse nicht reserviert oder ZimaOS keine manuelle statische IP-Adresse verwendet.

Sollte ich eine DHCP-Reservierung oder eine statische IP-Adresse verwenden?

Eine Router-Reservierung ist für die meisten Heimnetzwerke einfacher. Eine manuelle ZimaOS-Adresse ist sinnvoll, wenn Sie die Netzwerkeinstellungen bewusst auf dem Server verwalten möchten.

Warum haben meine Apps nach der IP-Änderung nicht mehr funktioniert?

Einige App-URLs, Rückrufe oder Einbindungen haben möglicherweise die alte Adresse gespeichert.

Was kann ich tun, wenn ich die falsche statische IP-Adresse festgelegt habe?

Verwenden Sie, falls verfügbar, einen anderen Ethernet-Port oder die aktuelle USB-Wiederherstellungsmethode mit _ResetNetwork.

Kann ich mich stattdessen auf zimaos.local verlassen?

mDNS-Hostnamen sind praktisch, aber eine stabile IP-Adresse bleibt für Infrastrukturdienste, Routing und Fehlerbehebung nützlich.