To źródło prowadzi do prostego wniosku: zmiana portów interfejsu WebUI ZimaOS z 80/443 spowodowała utratę łączności aplikacji Zima App 2.3.0 z urządzeniem użytkownika ZimaBoard 2, ale po aktualizacji ZimaOS do wersji 1.5 użytkownik wrócił i poinformował, że problem został rozwiązany.
Oznacza to, że strona nie powinna uczyć obecnych użytkowników ręcznego konfigurowania ukrytego „portu ZimaClient” na podstawie awarii z 2025 roku. Był to historyczny problem zgodności między klientem a niestandardowym portem WebUI, a samo źródło wskazuje aktualizację do wersji 1.5 jako punkt przywrócenia działania.
Użytkownik zmienił porty na potrzeby Nginx Proxy Manager
Nginx Proxy Manager zwykle potrzebuje portów hosta 80 i 443 do obsługi ruchu wejściowego HTTP/HTTPS. Dlatego użytkownik zmienił ustawienia ZimaOS na:
[gateway]
port = 8080
[ssl]
enabled = true
port = 30443i ponownie uruchomił usługę bramy CasaOS/ZimaOS.
Aplikacja Zima na Windowsie nie mogła się wtedy połączyć
Środowisko opisane w źródle obejmowało:
- ZimaBoard 2 1664;
- jądro ZimaOS 6.12.25;
- Zima App 2.3.0 w systemie Windows 11.
Po zmianie portu WebUI ponowne uruchomienie aplikacji Windows i próba nawiązania połączenia zakończyły się niepowodzeniem.
IceWhale poprosiło o szczegóły umożliwiające odtworzenie problemu, zamiast zgadywać ustawienie portu
Zima-Giorgio poprosił użytkownika o dokładny opis problemu, kroki pozwalające go odtworzyć, wcześniejsze zmiany, podjęte próby naprawy, informacje o sprzęcie, wersji systemu operacyjnego i wersji klienta. To dobre podejście do analizy problemu, ponieważ ta sama widoczna awaria połączenia może wynikać z problemów z wykrywaniem urządzenia, dostępem zdalnym, TLS, portem lub wersją klienta.
Aktualizacja do ZimaOS 1.5 rozwiązała problem opisany w źródle
Trzy dni później ThomasSpi napisał: „Po aktualizacji do Zima OS 1.5 wszystko działa. Problem rozwiązany.”
To najmocniejszy wniosek wynikający ze źródła i powinien zastąpić spekulacje o ręcznym konfigurowaniu niestandardowego portu w Zima App.
Obecny ZimaClient nadal się rozwija
Aktualna dokumentacja IceWhale opisuje ZimaClient jako narzędzie, które automatycznie wyszukuje najszybsze dostępne połączenie z WebUI przez sieć LAN, sieć zewnętrzną, hotspot i inne obsługiwane ścieżki.
Przed odtwarzaniem rozwiązania z ery wersji 2.3.0 zapoznaj się z aktualnym sposobem instalacji i nawiązywania połączenia przez ZimaClient.
ZimaOS 1.7.1 dodatkowo usprawnił adresy internetowe Dockera i obsługę dynamicznej sieci
Dziennik zmian wersji 1.7.1 zawiera bardziej elastyczną konfigurację portów adresów internetowych Dockera oraz ulepszoną obsługę adresów URL w dynamicznych środowiskach sieciowych. Zmiany te dotyczą adresów aplikacji, a nie stanowią bezpośredniego dowodu na cokolwiek konkretnego w sprawie starego błędu ZimaClient, ale pokazują, że obsługa portów i adresów URL na platformie nadal się rozwija.
Reverse proxy i ZimaClient to oddzielne ścieżki dostępu
Nginx Proxy Manager może udostępniać aplikacje, a nawet pulpit ZimaOS, pod przyjaznymi domenami HTTPS. ZimaClient korzysta z własnej logiki wykrywania urządzenia i dostępu zdalnego. Nie należy zakładać, że zmiana konfiguracji reverse proxy automatycznie przeprogramuje ZimaClient w każdej wersji.
Jeśli używasz reverse proxy dla pulpitu ZimaOS, zachowaj obsługę WebSocketów
W późniejszym przypadku opisanym przez społeczność w 2026 roku pulpit ładował się wizualnie przez Nginx Proxy Manager, ale aktywne widżety i okna dialogowe aplikacji nie działały do momentu włączenia obsługi WebSocketów. Konflikt portów i przekazywanie WebSocketów przez proxy to odrębne warstwy konfiguracji.
Bezpieczniejszy sposób zmiany portu WebUI
- Zapisz oryginalny port.
- Zmień port WebUI za pomocą obsługiwanego interfejsu, jeśli jest dostępny.
- Sprawdź bezpośredni dostęp w przeglądarce pod nowym adresem IP i portem.
- Uruchom ponownie lub zaktualizuj ZimaClient i potwierdź wykrywanie urządzenia.
- Dopiero potem przypisz porty 80/443 do reverse proxy.
- Zachowaj lokalną ścieżkę odzyskiwania dostępu na wypadek awarii zarówno proxy, jak i klienta.
FAQ: zmiana portu ZimaClient
Czy użytkownik opisany w źródle znalazł ręczne ustawienie niestandardowego portu w Zima App?
Nie. Wątek zakończył się informacją, że aktualizacja systemu operacyjnego rozwiązała problem.
Która wersja rozwiązała problem opisany w źródle?
Użytkownik wyraźnie poinformował, że rozwiązała go aktualizacja do ZimaOS 1.5.
Czy obecni użytkownicy powinni zakładać, że nadal obowiązuje sposób działania ZimaClient 2.3.0?
Nie. Obecne mechanizmy obsługi połączeń w ZimaClient i ZimaOS są znacznie nowsze.
