Deze bron heeft een eenvoudig eindresultaat: nadat de ZimaOS WebUI niet langer poorten 80/443 gebruikte, werkte Zima App 2.3.0 niet meer op de ZimaBoard 2 van de gebruiker. Nadat de gebruiker ZimaOS had bijgewerkt naar versie 1.5, meldde die dat het probleem was opgelost.
Dit betekent dat de pagina huidige gebruikers niet moet leren om handmatig een verborgen ‘ZimaClient-poort’ te configureren op basis van de storing uit 2025. Het ging om een historisch compatibiliteitsprobleem tussen de client en een aangepaste WebUI-poort, en de bron zelf geeft aan dat de update naar versie 1.5 het probleem oploste.
De gebruiker wijzigde de poorten voor Nginx Proxy Manager
Nginx Proxy Manager heeft normaal gesproken hostpoorten 80 en 443 nodig voor inkomend HTTP-/HTTPS-verkeer. Daarom verplaatste de gebruiker ZimaOS naar:
[gateway]
port = 8080
[ssl]
enabled = true
port = 30443Daarna werd de CasaOS/ZimaOS-gatewayservice opnieuw gestart.
De Windows Zima App kon vervolgens geen verbinding meer maken
De bronomgeving bestond uit:
- ZimaBoard 2 1664;
- ZimaOS-kernel 6.12.25;
- Zima App 2.3.0 op Windows 11.
Na de wijziging van de WebUI-poort mislukte het opnieuw starten van de Windows-app en het opnieuw verbinden.
IceWhale vroeg om reproduceerbare details in plaats van een poortinstelling te raden
Zima-Giorgio vroeg de gebruiker om een exacte probleembeschrijving, reproductiestappen, eerdere wijzigingen, uitgeprobeerde oplossingen, hardware, besturingssysteemversie en clientversie te geven. Dit is een goede aanpak voor het verzamelen van bewijs, omdat dezelfde zichtbare verbindingsfout kan worden veroorzaakt door problemen met detectie, externe toegang, TLS, poorten of de clientversie.
Bijwerken naar ZimaOS 1.5 loste het probleem in de bronzaak op
Drie dagen later plaatste ThomasSpi het bericht: ‘Na de update naar Zima OS 1.5 werkt het. Probleem opgelost.’
Dat is de sterkste conclusie uit de bron en moet speculatie over het handmatig aanleren van een aangepaste poort aan Zima App vervangen.
De huidige ZimaClient is verder ontwikkeld
In de huidige documentatie van IceWhale staat dat ZimaClient automatisch de snelst bruikbare verbinding met de WebUI zoekt via LAN, externe netwerken, hotspots en andere ondersteunde verbindingen.
Gebruik het huidige installatie- en verbindingsmodel van ZimaClient voordat je een oplossing uit het tijdperk van versie 2.3.0 opnieuw probeert toe te passen.
ZimaOS 1.7.1 verbeterde de Docker-web-URL en dynamische netwerkverwerking verder
De changelog van versie 1.7.1 vermeldt flexibelere configuratie van Docker-web-URL-poorten en verbeterde URL-verwerking voor dynamische netwerkomgevingen. Deze wijzigingen hebben betrekking op applicatie-URL’s en bewijzen niets specifieks over de oude ZimaClient-bug, maar laten wel zien dat de verwerking van poorten en URL’s op het platform verder is ontwikkeld.
Reverse proxy en ZimaClient zijn afzonderlijke toegangspaden
Nginx Proxy Manager kan gebruiksvriendelijke HTTPS-domeinen bieden voor apps of zelfs voor het ZimaOS-dashboard. ZimaClient gebruikt zijn eigen logica voor detectie en externe toegang. Je mag er niet van uitgaan dat een wijziging in de reverse proxy ZimaClient in elke versie automatisch opnieuw configureert.
Behoud WebSockets als je het ZimaOS-dashboard proxyt
In een latere communityzaak uit 2026 kon het dashboard visueel worden geladen via Nginx Proxy Manager, terwijl livewidgets en appdialoogvensters niet werkten totdat WebSocket Support werd ingeschakeld. Een poortconflict en WebSocket-proxying zijn afzonderlijke lagen.
Een veiligere manier om de WebUI-poort te wijzigen
- Noteer de oorspronkelijke poort.
- Wijzig de WebUI-poort via de ondersteunde gebruikersinterface, indien beschikbaar.
- Controleer directe browserverbinding via het nieuwe IP-adres en de nieuwe poort.
- Start ZimaClient opnieuw of werk deze bij en controleer de detectie.
- Wijs pas daarna 80/443 toe aan de reverse proxy.
- Houd een lokale herstelmogelijkheid beschikbaar voor het geval zowel de proxy als de client niet werken.
Veelgestelde vragen over het wijzigen van de ZimaClient-poort
Heeft de gebruiker in de bron een handmatige instelling voor aangepaste poorten in Zima App gevonden?
Nee. De thread eindigde met de melding dat de update van het besturingssysteem het probleem had opgelost.
Welke versie loste het probleem in de bronzaak op?
De gebruiker meldde expliciet dat ZimaOS 1.5 het probleem oploste.
Moeten huidige gebruikers ervan uitgaan dat het gedrag van ZimaClient 2.3.0 nog steeds van toepassing is?
Nee. De verbindingsafhandeling van de huidige ZimaClient en ZimaOS is aanzienlijk vernieuwd.
