Soluzione della community

Come risolvere il problema delle app di ZimaOS che si aprono su una pagina vuota

A user found that most ZimaOS apps opened as blank pages even though direct IP-and-port access still worked. Clearing the browser cache restored normal app launching.

Perché le app di ZimaOS si aprono come pagine vuote?

Nel febbraio 2026, un utente di ZimaOS ha segnalato che quasi tutte le app, tranne Plex, si aprivano come pagine vuote dalla dashboard. L'indizio diagnostico importante era che le stesse applicazioni continuavano ad aprirsi quando l'utente inseriva manualmente l'indirizzo IP di ZimaOS e la porta dell'applicazione.

Questo comportamento suggerisce che i container delle applicazioni potrebbero essere ancora in esecuzione. Il problema potrebbe invece trovarsi tra il launcher della dashboard, lo stato del browser e il livello di routing o proxy locale utilizzato per aprire l'applicazione.

Che cosa ha risolto il problema nella discussione originale?

La soluzione confermata è stata semplice: l'utente ha svuotato la cache del browser e ha riferito che le applicazioni hanno ricominciato a funzionare normalmente. Questo rende lo stato del browser la prima cosa da verificare quando l'accesso diretto tramite IP:PORTA funziona, ma l'avvio dalla dashboard di ZimaOS produce solo una pagina vuota.

Che cosa dovresti controllare per prima cosa?

  1. Verifica che l'applicazione interessata si apra ancora direttamente utilizzando il suo indirizzo IP locale e la porta assegnata.
  2. Apri la dashboard di ZimaOS in una finestra privata o in incognito. Se l'app funziona in questa modalità, i dati memorizzati nella cache del browser sono probabilmente la causa.
  3. Cancella i dati del sito memorizzati nella cache per la dashboard di ZimaOS e ricaricala.
  4. Prova un altro browser o un altro dispositivo client per stabilire se il problema riguarda il server o soltanto un profilo del browser.
  5. Passa alla risoluzione dei problemi relativi a launcher, proxy o container solo se la cancellazione dei dati del browser non risolve il problema.

Perché è importante l'accesso diretto tramite IP e porta?

Se l'interfaccia web dell'applicazione risponde ancora direttamente, questo indica che il servizio è raggiungibile e che il container non è completamente inattivo. L'indagine può quindi concentrarsi sul modo in cui ZimaOS avvia o instrada l'app, invece di attribuire subito la colpa all'applicazione stessa.

Non si tratta di una garanzia universale: un'app può presentare comunque malfunzionamenti parziali anche quando la sua porta web risponde. Tuttavia, è un'utile prima distinzione nel processo di risoluzione dei problemi.

Quando il problema potrebbe dipendere da qualcosa di più della cache del browser?

Se la pagina vuota appare in più browser puliti, oppure anche l'accesso diretto tramite IP e porta non funziona, il problema non è più lo stesso del caso risolto dalla community. Verifica se l'applicazione è in esecuzione, se la porta assegnata è cambiata e se tra il browser e ZimaOS sono presenti un proxy inverso o una configurazione di rete.

Le versioni attuali di ZimaOS continuano a migliorare l'avvio delle applicazioni, il download delle immagini e il comportamento dell'App Store. Se il problema si manifesta subito dopo un aggiornamento, annota la versione di ZimaOS e le versioni delle app interessate prima di modificare la distribuzione.

Per informazioni aggiornate sul comportamento delle applicazioni e sulle opzioni di installazione, consulta la guida all'App Store di ZimaOS.

Domande frequenti

Devo reinstallare tutte le app se la dashboard le apre come pagine vuote?

Non come prima cosa. Nella discussione risolta, i container erano raggiungibili direttamente e la cancellazione della cache del browser ha risolto il problema di avvio dalla dashboard.

Perché Plex continuava a funzionare mentre le altre app non funzionavano?

La discussione non stabilisce una ragione definitiva. Il risultato importante è che il problema generale è scomparso dopo la cancellazione della cache del browser.

Un URL IP-porta funzionante dimostra che il container è completamente integro?

No, ma dimostra che il servizio web è raggiungibile e aiuta a distinguere un problema di avvio o del browser da un servizio completamente arrestato.

Che cosa posso fare se la cancellazione della cache non aiuta?

Prova un altro browser pulito, verifica che l'app risponda ancora direttamente, quindi analizza lo stato dell'app, le assegnazioni delle porte, la rete e l'eventuale livello proxy coinvolto.