ZimaClient kan inte ansluta efter ändring av ZimaOS-portar: fixen i version 1.5 och aktuell vägledning för portändring

Den här källan har ett enkelt slutresultat: när ZimaOS WebUI flyttades från portarna 80/443 slutade Zima App 2.3.0 att ansluta till användarens ZimaBoard 2, men efter att ZimaOS uppdaterats till version 1.5 återkom användaren och meddelade att problemet var löst.

Det innebär att sidan inte bör lära aktuella användare att manuellt konfigurera en dold ”ZimaClient-port” utifrån problemet från 2025. Det var ett historiskt kompatibilitetsproblem mellan klienten och en anpassad WebUI-port, och källan visar själv att återställningen skedde i version 1.5.

Användaren ändrade portarna för Nginx Proxy Manager

Nginx Proxy Manager behöver normalt värdportarna 80 och 443 för inkommande HTTP-/HTTPS-trafik. Användaren flyttade därför ZimaOS till:

[gateway]
port = 8080
[ssl]
enabled = true
port = 30443

och startade om CasaOS/ZimaOS-gatewaytjänsten.

Windows-appen Zima kunde sedan inte ansluta

Källmiljön var:

• ZimaBoard 2 1664;
• ZimaOS-kärna 6.12.25;
• Zima App 2.3.0 i Windows 11.

Efter ändringen av WebUI-porten misslyckades det att ansluta igen när Windows-appen startades om.

IceWhale bad om reproducerbara detaljer i stället för att gissa en portinställning

Zima-Giorgio bad användaren ange den exakta problembeskrivningen, stegen för att återskapa problemet, tidigare ändringar, försök till lösningar, maskinvara, OS-version och klientversion. Det är god hantering av felsökningsunderlag, eftersom samma synliga anslutningsfel kan bero på identifiering, fjärråtkomst, TLS, portar eller klientversioner.

Uppdatering till ZimaOS 1.5 löste problemet i källfallet

Tre dagar senare skrev ThomasSpi: ”Efter uppdateringen till Zima OS 1.5 fungerar det. Problemet är löst.”

Detta är den tydligaste slutsatsen från källan och bör ersätta spekulationer om att manuellt lära Zima App en anpassad port.

Den aktuella ZimaClient har fortsatt att utvecklas

Aktuell dokumentation från IceWhale beskriver ZimaClient som en klient som automatiskt hittar den snabbaste användbara anslutningen till WebUI via LAN, externt nätverk, hotspot och andra stödda anslutningsvägar.

Använd den aktuella installations- och anslutningsmodellen för ZimaClient innan du återskapar en lösning från tiden för version 2.3.0.

ZimaOS 1.7.1 förbättrade ytterligare Docker Web-URL:er och dynamisk nätverkshantering

Ändringsloggen för 1.7.1 innehåller flexiblare konfiguration av porten för Docker Web-URL:er och förbättrad URL-hantering i dynamiska nätverksmiljöer. Dessa ändringar gäller program-URL:er och bevisar inget specifikt om det gamla ZimaClient-felet, men de visar att plattformens hantering av portar och URL:er har fortsatt att utvecklas.

Omvänd proxy och ZimaClient är separata åtkomstvägar

Nginx Proxy Manager kan tillhandahålla lättanvända HTTPS-domäner för appar eller till och med ZimaOS-instrumentpanelen. ZimaClient använder sin egen logik för identifiering och fjärråtkomst. Man bör inte anta att en ändring av den omvända proxyn automatiskt konfigurerar om ZimaClient i alla versioner.

Om du proxar ZimaOS-instrumentpanelen ska WebSocket bevaras

Ett senare communityfall från 2026 visade att instrumentpanelen kunde läsas in visuellt via Nginx Proxy Manager medan livewidgetar och appdialoger slutade fungera tills WebSocket Support aktiverades. Portkonflikter och WebSocket-proxying är separata lager.

Ett säkrare sätt att ändra WebUI-porten

1. Notera den ursprungliga porten.
2. Ändra WebUI-porten via det stödda gränssnittet när det är möjligt.
3. Verifiera direkt webbläsaråtkomst via den nya IP-adressen och porten.
4. Starta om eller uppdatera ZimaClient och bekräfta identifieringen.
5. Tilldela först därefter portarna 80/443 till den omvända proxyn.
6. Behåll en lokal återställningsväg om både proxyn och klienten slutar fungera.

Vanliga frågor om byte av ZimaClient-port

Hittade användaren i källan en manuell inställning för anpassad port i Zima App?

Nej. Tråden avslutades med att OS-uppdateringen löste problemet.

Vilken version löste problemet i källfallet?

Användaren uppgav uttryckligen att ZimaOS 1.5 löste det.

Bör aktuella användare anta att beteendet i ZimaClient 2.3.0 fortfarande gäller?

Nej. Den aktuella hanteringen av anslutningar i ZimaClient och ZimaOS är betydligt nyare.