Om ZimaClient på macOS fastnar på ”Ansluter” ska du logga ut från klienten och logga in igen innan du installerar om appen eller ändrar din ZimaOS-server. Just den åtgärden återställde den verifierade källsituationen för version 2.1.0 efter flera timmars problem.
Behandla dock inte utloggning och inloggning som en universell grundorsakslösning. Samma tråd gällde anslutningsproblem på både Mac och Android efter uppgraderingar av ZimaOS, och IceWhale frågade specifikt om brandväggar, VPN, proxyservrar, ISP-byten och nätverkskonfiguration. En bra felsökningsmetod skiljer mellan konto- och sessionstillstånd samt nätverkstillgänglighet.
Steg 1: Bekräfta att servern fungerar lokalt
Öppna ZimaOS-instrumentpanelen direkt via LAN-IP-adressen i en webbläsare. Om servern fungerar lokalt men ZimaClient inte kan ansluta bör du fokusera på klient-, sessions- eller fjärråtkomstlagret.
Steg 2: Logga ut och logga in igen
Den ursprungliga användaren hade redan installerat om ZimaClient och startat om ZimaOS utan resultat. När användaren loggade ut från ZimaClient och autentiserade sig igen återställdes anslutningen.
Det tyder på att ett inaktuellt klient- eller sessionstillstånd var inblandat, men tråden bevisade inte exakt vilken token eller nätverksstatus som ändrades.
Steg 3: Kontrollera fjärråtkomst i ZimaOS
Den aktuella guiden för fjärråtkomst i ZimaOS anger att fjärråtkomst kan aktiveras eller inaktiveras under Inställningar → Nätverk.
Kontrollera att den är aktiverad om du förväntar dig att ZimaClient ska fungera utanför hemmet.
Steg 4: Testa på samma LAN
Den aktuella introduktionsguiden för ZimaOS rekommenderar att den första anslutningen görs i samma nätverk. Om ZimaClient inte kan ansluta ens lokalt är fjärranslutning genom NAT inte det första problemet att undersöka.
Steg 5: Kontrollera VPN, proxy, brandvägg och nätverksändringar
IceWhales support frågade specifikt om användaren hade ändrat brandvägg, VPN/proxy, ISP eller nätverksadministration innan problemet uppstod.
Inaktivera tillfälligt VPN- eller proxyklienter som kan orsaka konflikter under felsökningen och kontrollera att macOS-behörigheten för lokalt nätverk tillåter ZimaClient att upptäcka enheter.
Steg 6: Starta om processer som har fastnat i ZimaClient
Den aktuella installationsguiden för ZimaClient rekommenderar att du använder Aktivitetskontroll för att stänga Zima-relaterade processer när appen verkar vara igång men inte fungerar korrekt.
Steg 7: Samla in loggar innan du installerar om igen
Den aktuella dokumentationen anger att ZimaClients loggar på macOS finns under:
~/Library/Application Support/Zima/logsSamla in dem direkt efter att du återskapat problemet så att supporten kan skilja mellan fel vid upptäckt, autentisering och fjärrnätverk.
Använd vanliga VPN-verktyg som en alternativ väg
Aktuella ZimaOS stöder även Tailscale, WireGuard Easy, Firefly och NetBird som alternativa fjärrnätverkslösningar. De ersätter inte ZimaClients integrering med säkerhetskopiering eller Finder, men kan tillhandahålla en separat privat nätverksväg.
Guiden för fjärranslutning hjälper dig att jämföra dessa lager.
Skilj mellan autentisering och anslutning
Om Mac-datorn kan upptäcka servern men autentiseringen misslyckas kan du jämföra samma ZimaOS-konto i det lokala webbgränssnittet. Om kontot fungerar i webbläsaren men inte i ZimaClient ligger problemet troligen i klient- eller sessionstillståndet, inte i själva lösenordet.
Om varken webbläsaren eller klienten kan nå servern via IP-adressen bör du först felsöka servern eller LAN-nätverket.
Kontrollera macOS-behörigheten för lokalt nätverk
macOS kan begränsa en apps möjlighet att upptäcka enheter i det lokala nätverket. Om ZimaClient inte visar en närliggande ZimaOS-enhet kan du kontrollera appens behörighet för lokalt nätverk under Integritet och säkerhet i macOS och sedan starta om klienten efter ändringen.
Återställ endast det lager som är trasigt
Återställ inte ZimaOS-servern, Remote ID, lösenordet och klientinstallationen samtidigt. Ändra ett lager i taget så att du vet vad som faktiskt löste problemet.
Källsituationen är ett bra exempel: omstart av servern och ominstallation av klienten hjälpte inte, men det gjorde utloggning och ny inloggning. Det pekar på ett sessionsproblem snarare än en skadad serverinstallation.
När du bör använda en alternativ fjärranslutning
Om ZimaClient fortfarande inte är tillgängligt men själva servern fungerar kan en separat konfigurerad Tailscale- eller WireGuard-anslutning hålla administrationen tillgänglig medan du samlar in loggar. Använd den som en oberoende nätverksväg, inte som bevis på att ZimaClient-problemet är löst.
Vanliga frågor
Varför hjälpte det inte att installera om ZimaClient?
En ominstallation kan lämna konto- eller sessionsförhållanden samt nätverksförhållanden oförändrade. I den verifierade källsituationen var det utloggning och ny inloggning som återställde tjänsten.
Varför kan SMB fungera när ZimaClient inte gör det?
SMB på LAN-nätverket och ZimaClients fjärr- och sessionsanslutning är olika lager. Det ena kan fungera medan det andra är trasigt.
Var finns ZimaClients Mac-loggar?
Den aktuella officiella dokumentationen anger ~/Library/Application Support/Zima/logs.
Bör jag återställa mitt ZimaOS-lösenord?
Inte enbart för att ZimaClient visar ”Ansluter”. Kontrollera först direktinloggning, utloggning och ny inloggning, nätverksstatus och loggar.
