Als ZimaClient op macOS op ‘Verbinden…’ blijft hangen, meld je dan af bij de client en meld je opnieuw aan voordat je de app opnieuw installeert of je ZimaOS-server wijzigt. Precies die actie herstelde de geverifieerde broncase 2.1.0 nadat de verbinding enkele uren was blijven hangen.
Behandel afmelden en opnieuw aanmelden echter niet als een universele oplossing voor de onderliggende oorzaak. In dezelfde thread waren er na ZimaOS-upgrades verbindingsproblemen op zowel Mac als Android, en IceWhale vroeg specifiek naar firewalls, VPN's, proxy's, wijzigingen van internetprovider en netwerkconfiguratie. Een goede probleemoplossingsroute maakt onderscheid tussen account- en sessiestatus enerzijds en netwerkbereikbaarheid anderzijds.
Stap 1: Bevestig dat de server lokaal werkt
Open het ZimaOS-dashboard rechtstreeks via het lokale IP-adres in een browser. Als de server lokaal werkt, maar ZimaClient geen verbinding kan maken, richt je dan op de client-, sessie- en externe-toegangslaag.
Stap 2: Meld je af en meld je opnieuw aan
De oorspronkelijke gebruiker had ZimaClient al opnieuw geïnstalleerd en ZimaOS opnieuw opgestart, zonder resultaat. Afmelden bij ZimaClient en opnieuw authenticeren herstelde de verbinding.
Dit wijst erop dat verouderde client- of sessiestatus een rol speelde, maar de thread bewees niet precies welk token of welke netwerkstatus was gewijzigd.
Stap 3: Controleer externe toegang in ZimaOS
De huidige handleiding voor externe toegang tot ZimaOS vermeldt dat externe toegang kan worden in- of uitgeschakeld via Instellingen → Netwerk.
Zorg ervoor dat deze optie is ingeschakeld als je verwacht dat ZimaClient buitenshuis werkt.
Stap 4: Test op hetzelfde LAN
De huidige onboarding-instructies voor ZimaOS adviseren om de eerste verbinding op hetzelfde netwerk tot stand te brengen. Als ZimaClient zelfs lokaal geen verbinding kan maken, is NAT-traversal op afstand niet het eerste probleem.
Stap 5: Controleer VPN, proxy, firewall en netwerkwijzigingen
De ondersteuning van IceWhale vroeg specifiek of de gebruiker vóór het probleem wijzigingen had aangebracht in de firewall, VPN/proxy, internetprovider of netwerkbeheer.
Schakel conflicterende VPN- of proxyclients tijdens de diagnose tijdelijk uit en controleer of de lokale-netwerktoestemming van macOS ZimaClient toestaat apparaten te ontdekken.
Stap 6: Start vastgelopen ZimaClient-processen opnieuw
De huidige installatiehandleiding voor ZimaClient adviseert Activiteitenweergave te gebruiken om Zima-gerelateerde processen te sluiten wanneer de app actief lijkt, maar niet correct werkt.
Stap 7: Verzamel logs voordat je opnieuw installeert
De huidige documentatie vermeldt de ZimaClient-logs op macOS op de volgende locatie:
~/Library/Application Support/Zima/logsVerzamel deze direct nadat je het probleem opnieuw hebt veroorzaakt, zodat de ondersteuning onderscheid kan maken tussen problemen met detectie, authenticatie en externe netwerkverbindingen.
Gebruik standaard VPN-tools als alternatief
Het huidige ZimaOS ondersteunt ook Tailscale, WireGuard Easy, Firefly en NetBird als alternatieve opties voor externe netwerken. Ze vervangen de back-up- of Finder-integratie van ZimaClient niet, maar kunnen wel een afzonderlijke privénetwerkroute bieden.
De handleiding voor externe verbindingen helpt deze lagen met elkaar te vergelijken.
Maak onderscheid tussen authenticatie en connectiviteit
Als de Mac de server kan ontdekken, maar authenticatie mislukt, vergelijk dan hetzelfde ZimaOS-account in de lokale webinterface. Als het account in de browser wel werkt, maar niet in ZimaClient, ligt het probleem waarschijnlijk bij de client- of sessiestatus en niet bij het wachtwoord zelf.
Als noch de browser, noch de client via het IP-adres verbinding kan maken met de server, los dan eerst het probleem met de server of het LAN op.
Controleer de lokale-netwerktoestemming van macOS
macOS kan beperken of een applicatie apparaten op het lokale netwerk mag ontdekken. Als ZimaClient geen ZimaOS-apparaat in de buurt weergeeft, controleer dan de toestemming voor Lokaal netwerk van de app in de instellingen voor Privacy en beveiliging van macOS en start de client opnieuw nadat je deze hebt gewijzigd.
Reset alleen de defecte laag
Reset de ZimaOS-server, Remote ID, het wachtwoord en de clientinstallatie niet allemaal tegelijk. Wijzig één laag per keer, zodat je weet wat het probleem daadwerkelijk heeft opgelost.
De broncase is hiervan een goed voorbeeld: het opnieuw opstarten van de server en het opnieuw installeren van de client hielpen niet; afmelden en opnieuw aanmelden wel. Dat bewijs wijst eerder op een probleem met de sessiestatus dan op een beschadigde serverinstallatie.
Wanneer gebruik je een alternatieve externe route?
Als ZimaClient niet beschikbaar blijft, maar de server zelf wel gezond is, kan een afzonderlijk geconfigureerde Tailscale- of WireGuard-route het beheer beschikbaar houden terwijl je logs verzamelt. Gebruik dit als een onafhankelijke netwerkroute, niet als bewijs dat het ZimaClient-probleem is opgelost.
Veelgestelde vragen
Waarom hielp het opnieuw installeren van ZimaClient niet?
Een herinstallatie kan de account- of sessiestatus en netwerkomstandigheden ongewijzigd laten. In de geverifieerde broncase was afmelden en opnieuw aanmelden de actie die de service herstelde.
Waarom kan SMB werken terwijl ZimaClient niet werkt?
SMB op het LAN en de externe sessieconnectiviteit van ZimaClient zijn verschillende lagen. De ene kan werken terwijl de andere defect is.
Waar staan de Mac-logs van ZimaClient?
De huidige officiële documentatie vermeldt ~/Library/Application Support/Zima/logs.
Moet ik mijn ZimaOS-wachtwoord opnieuw instellen?
Niet alleen omdat ZimaClient ‘Verbinden…’ weergeeft. Controleer eerst directe aanmelding, meld je af en opnieuw aan, controleer de netwerkstatus en bekijk de logs.
