Återställ ZimaOS-instrumentpanelens port från CLI på ett säkert sätt

Använd ZimaOS webbgränssnitt för vanliga portändringar

Den officiella community-guiden anger att ZimaOS-instrumentpanelens port normalt ska ändras via webbgränssnittet. CLI-metoden nedan är avsedd för nödsituationer eller räddningssituationer, till exempel när porten har ändrats av misstag eller när en avsiktlig ändring gjorde instrumentpanelen otillgänglig.

ZimaOS allmänna inställningar där fältet för webbgränssnittets port är inställt på port 80 — Guiden visar inställningen för webbgränssnittets port i ZimaOS panel för allmänna inställningar som den rekommenderade platsen för att hantera instrumentpanelens port.

När CLI-räddningsmetoden är användbar

Guiden identifierar två vanliga fall: instrumentpanelens port ändrades av misstag, eller så ändrades den avsiktligt och den nya konfigurationen fungerar inte längre som förväntat. Målet för återställningen är port 80, för att återställa åtkomsten till ZimaOS-instrumentpanelen.

Den här guiden publicerades i april 2025. Konfigurationssökvägar och tjänstenamn kan ändras i senare versioner, så bekräfta det aktuella beteendet på den aktuella ZimaOS-sidan innan du använder den här historiska räddningsproceduren på en betydligt nyare version.

Återställ instrumentpanelens port från den lokala CLI:n

Den här proceduren ändrar en systemkonfigurationsfil och startar om en ZimaOS-tjänst. Anteckna den aktuella inställningen innan du redigerar den och se till att viktiga data är säkerhetskopierade innan du utför systemomfattande återställningsarbete.

1. Anslut tangentbord och bildskärm

Guiden börjar med direkt fysisk åtkomst till ZimaOS-maskinen. Anslut ett tangentbord och en bildskärm så att du kan arbeta lokalt även när instrumentpanelen inte är tillgänglig via nätverket.

2. Öppna CLI:n och växla till root

Tryck på Alt + F3 för att växla till kommandoradsgränssnittet, logga in och höj sedan behörigheten till root:

sudo -i

3. Öppna gateway-konfigurationen

Använd VI-redigeraren för att öppna gateway-konfigurationsfilen:

vi /etc/casaos/gateway.ini

Leta reda på raden som anger instrumentpanelens port. Guiden använder ett ändrat värde, till exempel:

port = 8080

Återställ den till:

port = 80

För att spara filen i VI trycker du på Esc, skriver :wq och trycker på Enter.

4. Starta om ZimaOS gateway-tjänst

Tillämpa konfigurationsändringen genom att starta om gateway-tjänsten:

systemctl restart zimaos-gateway.service

Försök öppna instrumentpanelen igen med den återställda porten när tjänsten har startats om.

Varför port 80 används i den här guiden

Återställningsguiden återställer specifikt instrumentpanelen till port 80 som ett känt mål för att återställa åtkomsten. Det betyder inte att varje installation permanent måste använda port 80. När åtkomsten har återställts bör vanlig portadministration hanteras via webbgränssnittet som beskrivs i guiden.

Vanliga frågor

Bör jag använda CLI:n varje gång jag vill ändra ZimaOS-instrumentpanelens port?

Nej. Guiden anger uttryckligen webbgränssnittet som den normala metoden och CLI-arbetsflödet som ett alternativ för nödsituationer eller räddning.

Vilken konfigurationsfil redigerar guiden?

Proceduren från april 2025 redigerar /etc/casaos/gateway.ini. Eftersom detta är en versionsspecifik systemsökväg bör du verifiera den innan du tillämpar samma steg på en nyare ZimaOS-version.

Vilken tjänst startas om efter portändringen?

Guiden startar om zimaos-gateway.service med systemctl så att den nya gateway-konfigurationen kan börja gälla.

Vad ska jag göra om instrumentpanelen fortfarande inte läses in?

Källguiden innehåller ingen djupare diagnostiksekvens efter omstarten av gatewayen. Undvik att upprepade gånger ändra orelaterade systeminställningar. Bekräfta i stället den versionsspecifika ZimaOS-vägledningen och sök support med den exakta porten, konfigurationen och tjänststatusen som du observerade.