Soluzione della community

ZimaClient non riesce a connettersi dopo la modifica delle porte di ZimaOS: la soluzione nella versione 1.5 e le indicazioni attuali per cambiare porta

An October 2025 ZimaBoard 2 thread where a user moved the ZimaOS WebUI from 80/443 to 8080/30443 for Nginx Proxy Manager and Zima App 2.3.0 could no longer connect. After providing reproduction details, the user updated to ZimaOS 1.5 and explicitly reported the problem fixed.

Questa fonte ha un esito finale semplice: modificare l'interfaccia Web di ZimaOS allontanandola dalle porte 80/443 ha interrotto la connettività di Zima App 2.3.0 sullo ZimaBoard 2 dell'utente, ma dopo aver aggiornato ZimaOS alla versione 1.5 l'utente è tornato a riferire che il problema era stato risolto.

Ciò significa che la pagina non dovrebbe insegnare agli utenti attuali a configurare manualmente una “porta ZimaClient” nascosta sulla base del problema del 2025. Si è trattato di un problema storico di compatibilità tra il client e una porta Web personalizzata, e la fonte stessa stabilisce che la versione 1.5 ha segnato il ripristino del funzionamento.

L'utente ha modificato le porte per Nginx Proxy Manager

Nginx Proxy Manager richiede normalmente le porte host 80 e 443 per il traffico in ingresso HTTP/HTTPS. L'utente ha quindi spostato ZimaOS su:

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

e ha riavviato il servizio gateway di CasaOS/ZimaOS.

L'app Zima per Windows non è più riuscita a connettersi

L'ambiente della fonte era:

  • ZimaBoard 2 1664;
  • kernel ZimaOS 6.12.25;
  • Zima App 2.3.0 su Windows 11.

Dopo la modifica della porta dell'interfaccia Web, il riavvio dell'app Windows e il tentativo di riconnessione non hanno avuto successo.

IceWhale ha chiesto dettagli riproducibili invece di ipotizzare un'impostazione della porta

Zima-Giorgio ha chiesto all'utente di fornire la descrizione esatta del problema, i passaggi per riprodurlo, le modifiche precedenti, i tentativi di risoluzione, l'hardware, la versione del sistema operativo e la versione del client. Si tratta di una buona gestione delle informazioni, perché lo stesso errore di connessione visibile può dipendere da problemi di rilevamento, accesso remoto, TLS, porte o versione del client.

L'aggiornamento a ZimaOS 1.5 ha risolto il caso della fonte

Tre giorni dopo, ThomasSpi ha scritto: «Dopo l'aggiornamento a Zima OS 1.5 funziona. Problema risolto.»

Questa è la conclusione più solida della fonte e dovrebbe sostituire le ipotesi sulla configurazione manuale di una porta personalizzata in Zima App.

L'attuale ZimaClient ha continuato a evolversi

La documentazione attuale di IceWhale descrive ZimaClient come uno strumento che individua automaticamente la connessione utilizzabile più veloce all'interfaccia Web tramite LAN, rete esterna, hotspot e altri percorsi supportati.

Consulta il modello attuale di installazione e connessione di ZimaClient prima di ricreare una soluzione dell'epoca della versione 2.3.0.

ZimaOS 1.7.1 ha ulteriormente migliorato l'URL Web di Docker e la gestione dinamica della rete

Il changelog della versione 1.7.1 include una configurazione più flessibile delle porte degli URL Web di Docker e una gestione migliorata degli URL negli ambienti di rete dinamici. Queste modifiche riguardano gli URL delle applicazioni e non dimostrano nulla di specifico sul vecchio problema di ZimaClient, ma mostrano che la gestione delle porte e degli URL della piattaforma ha continuato a evolversi.

Il reverse proxy e ZimaClient sono percorsi di accesso separati

Nginx Proxy Manager può fornire domini HTTPS intuitivi per le applicazioni o persino per il pannello di ZimaOS. ZimaClient utilizza una propria logica di rilevamento e accesso remoto. Non si dovrebbe presumere che una modifica al reverse proxy riconfiguri automaticamente ZimaClient in ogni versione.

Se esegui il proxy del pannello di ZimaOS, mantieni i WebSocket

Un caso della community del 2026 ha mostrato che il pannello poteva caricarsi visivamente tramite Nginx Proxy Manager, mentre i widget dinamici e le finestre di dialogo delle app non funzionavano finché non veniva abilitato il supporto WebSocket. Il conflitto tra porte e il proxying dei WebSocket sono livelli distinti.

Un modo più sicuro per modificare la porta dell'interfaccia Web

  1. Annota la porta originale.
  2. Modifica la porta dell'interfaccia Web tramite l'interfaccia supportata, quando disponibile.
  3. Verifica l'accesso diretto dal browser al nuovo indirizzo IP:porta.
  4. Riavvia o aggiorna ZimaClient e conferma il rilevamento.
  5. Solo a quel punto assegna le porte 80/443 al reverse proxy.
  6. Mantieni un percorso di ripristino locale nel caso in cui il proxy e il client smettano entrambi di funzionare.

Domande frequenti sulla modifica della porta di ZimaClient

L'utente della fonte ha trovato un'impostazione manuale per una porta personalizzata in Zima App?

No. La discussione si è conclusa con la risoluzione del problema tramite l'aggiornamento del sistema operativo.

Quale versione ha risolto il caso della fonte?

L'utente ha dichiarato esplicitamente che ZimaOS 1.5 ha risolto il problema.

Gli utenti attuali dovrebbero presumere che il comportamento di ZimaClient 2.3.0 sia ancora valido?

No. ZimaClient e la gestione delle connessioni di ZimaOS attuali sono molto più recenti.