Gemenskapslösning

ZimaOS IP-adress har ändrats: gör den stabil

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

Slutsats: Använd DHCP-reservation eller en manuell statisk IP-adress – låt inte NAS-adressen ändras

Problemet 2023 var enkelt: ZimaOS fick sin adress från DHCP, lånet ändrades efter omstart och appar som hänvisade till den gamla IP-adressen slutade fungera. Aktuella ZimaOS erbjuder nu korrekta kontroller för statiska IP-adresser per gränssnitt, så du behöver inte längre förlita dig enbart på en lösning i routern. Målet är en stabil adress, inte ett smart värdnamnsknep.

Alternativ 1: Reservera adressen i routern

En DHCP-reservation gör att ZimaOS fortsätter använda automatisk adresstilldelning, men instruerar routern att ge samma IP-adress till samma MAC-adress. Detta är vanligtvis det smidigaste alternativet i hemnätverk, eftersom gateway, subnät och DNS hanteras centralt. Anteckna MAC-adressen för ZimaOS Ethernet-gränssnitt, skapa reservationen och förnya sedan lånet eller starta om servern.

Alternativ 2: Ange en manuell IP-adress i ZimaOS

Med aktuella ZimaOS kan varje Ethernet-gränssnitt växla från DHCP till Manuell. Ange IP-adress, subnätmask, gateway och DNS-server och spara sedan. Nätverksinställningarna i ZimaOS beskriver det aktuella förloppet.

Välj en adress utanför routerns normala DHCP-pool eller reservera uttryckligen samma adress, så att en annan enhet inte får den senare.

Gissa inte gateway-adressen

En statisk adress kan se korrekt ut medan extern åtkomst misslyckas om gateway-adressen är fel. Kontrollera den verkliga gateway-adressen på en fungerande klient eller i routern. I ZimaOS:

ip addr
ip route
cat /etc/resolv.conf

Normalt ska du se en giltig standardrutt via LAN-routern. IP-routningstabellen i Linux förklarar hur ruttval fungerar.

Appar bör inte hårdkoda en tillfällig DHCP-adress

Omvända proxyservrar, webhook-callbacks, monterade delade mappar och app-URL:er blir sköra när de pekar på en adress som kan ändras. Använd stabila lokala DNS-namn där det stöds, eller en reserverad/statisk IP-adress. Om en container lagrar den gamla värdadressen i en miljövariabel ska du uppdatera den konfigurationen efter nätverksändringen.

Appnätverk i ZimaOS hjälper dig att hålla appslutpunkterna förutsägbara.

Använd konsolen om du förlorar webbgränssnittet

När ett misstag med en statisk IP-adress kopplar bort instrumentpanelen visar den anslutna skärmen den aktuella ZimaOS-IP-adressen. Aktuella ZimaOS erbjuder även en USB-baserad nätverksåterställning med en tom fil med namnet _ResetNetwork på en exFAT-formaterad USB-enhet. Nätverksåterställningen i ZimaOS är den stödda reservmetoden.

Reservera en adress per fysisk gränssnitt

System med dubbla nätverkskort kan ha olika MAC-adresser och olika subnät. Reservera inte samma IP-adress för båda gränssnitten. Bestäm vilken port som ska vara hanterings-/LAN-gränssnitt och behåll standardgatewayen där, såvida du inte avsiktligt använder policybaserad routning.

Nätverk i ZimaBoard 2 visar ett aktuellt hårdvaruexempel med två portar.

Verifiera åtgärden från en annan enhet

ping ZIMAOS_IP
arp -a

Starta sedan om ZimaOS en gång och bekräfta att samma adress återkommer. Öppna apparna som tidigare inte fungerade och kontrollera att deras sparade värdnamn/IP-adresser fortfarande pekar på den stabila adressen.

Varför routerreservationer ofta är säkrare än slumpmässigt valda statiska adresser

DHCP är utformat för att tilldela adresser centralt, så en manuellt vald IP-adress inom den aktiva poolen kan senare kollidera med en annan klient. DHCP-lånemodellen förklarar varför en reservation i routern behåller den centrala adresshanteringen samtidigt som NAS:en blir förutsägbar. Oavsett vilken metod du väljer bör du dokumentera adress, gateway, DNS-server och gränssnittets MAC-adress.

Vanliga frågor

Varför ändrades min ZimaOS-IP-adress efter omstart?

DHCP kan tilldela ett annat lån om inte routern reserverar adressen eller ZimaOS använder en manuell statisk IP-adress.

Bör jag använda DHCP-reservation eller statisk IP-adress?

En reservation i routern är enklare för de flesta hem; en manuell ZimaOS-adress är användbar när du avsiktligt hanterar nätverksinställningarna på servern.

Varför slutade mina appar fungera när IP-adressen ändrades?

Vissa app-URL:er, callbacks eller monteringar kan ha lagrat den gamla adressen.

Vad gör jag om jag angav fel statisk IP-adress?

Använd en annan Ethernet-port om det finns en tillgänglig, eller den aktuella USB-återställningsmetoden med _ResetNetwork.

Kan jag förlita mig på zimaos.local i stället?

mDNS-värdnamn är praktiska, men en stabil IP-adress är fortfarande användbar för infrastrukturtjänster, routning och felsökning.