Cosa controllare quando ownCloud Web si apre su una pagina vuota

Quando ownCloud Web si apre su una pagina bianca, prova prima lo stesso URL in una finestra di navigazione in incognito e con un browser attualmente supportato. Se il problema persiste, apri gli strumenti per sviluppatori del browser e controlla i pannelli Console e Rete; utilizza l'errore di richiesta per decidere se cancellare i dati del sito web dal browser, riparare una risorsa web mancante o esaminare i servizi di Infinite Scale e reverse proxy. Evita di eliminare i dati del server o di reinstallare l'istanza prima di aver effettuato questa verifica.

ownCloud Web è l'interfaccia web fornita con Infinite Scale, sebbene gli amministratori possano sostituire le risorse compilate con una build personalizzata. Una pagina vuota può quindi derivare dal browser, da una risorsa JavaScript mancante o non corrispondente, oppure da una risposta del server/proxy che impedisce il caricamento dell'interfaccia. I passaggi seguenti distinguono questi casi. I pannelli dell'interfaccia sono esempi illustrativi; confrontali con l'output effettivo del browser e dell'implementazione.

1. Scopri se il problema è locale o a livello di server.

Chiedi a un altro utente di aprire lo stesso URL pubblico e prova tu stesso in una finestra di navigazione privata. Ad esempio, se un dipendente visualizza una pagina vuota mentre un collega può visualizzare i file, inizia a esaminare le cause specifiche del browser. Se tutti visualizzano la stessa pagina, passa direttamente ai controlli di rete e del server.

  1. Utilizza un browser desktop supportato da ownCloud Web. La pagina dei requisiti aggiornati elenca le versioni recenti di Chrome, Firefox ed Edge e Safari 16 o versioni successive sui sistemi operativi desktop supportati.
  2. Apri l'istanza in una finestra di navigazione privata. Se l'interfaccia si carica, disabilita le estensioni una alla volta nel profilo normale, quindi cancella i dati del sito solo per l'hostname di ownCloud. La cancellazione dei dati del sito ti disconnetterà automaticamente; non rimuove i file memorizzati sul server.
  3. Aggiorna la pagina vuota con la cache del browser disabilitata mentre gli strumenti per sviluppatori sono aperti. Se lo stesso errore persiste in più browser supportati e per più utenti, è più probabile che si tratti di un problema lato server o di distribuzione.

Finestra del browser a scopo illustrativo che mostra una pagina bianca completamente vuota all'indirizzo hostname cloud di esempio

Illustrazione del sintomo: il browser ha raggiunto l'host cloud, ma l'area del contenuto della pagina rimane vuota.

2. Utilizzare la richiesta non riuscita per scegliere una soluzione

Apri gli strumenti per sviluppatori (di solito F12 o Ctrl+Maiusc+I su Windows/Linux, oppure Opzione+Comando+I su macOS). Seleziona Console per visualizzare gli errori JavaScript, quindi seleziona Rete , ricarica la pagina e cerca le richieste non riuscite. Il codice di stato e il tipo di richiesta sono più utili della sola schermata bianca.

  • Una richiesta JavaScript o CSS restituisce un errore 404: il browser ha richiesto una risorsa che non è stata trovata a quell'URL. Se questo problema si verifica solo con un profilo browser, cancella i file memorizzati nella cache di quel sito e ricarica la pagina. Se la stessa risorsa non funziona per tutti, controlla il percorso della risorsa, il routing del proxy inverso e qualsiasi build web personalizzata.
  • Una richiesta restituisce un errore 502, 503 o un errore di connessione: il proxy non è riuscito a ottenere una risposta utilizzabile da un servizio a monte oppure il servizio non era disponibile. Prima di modificare le impostazioni del browser, verifica lo stato di distribuzione e i log.
  • La console segnala una richiesta bloccata, un errore del certificato o un avviso di contenuto misto: confronta il nome host pubblico e lo schema HTTPS utilizzati dal browser con l'URL e la configurazione del proxy. Se hai modificato di recente il dominio, la terminazione TLS o le regole del proxy, testa prima tale modifica.
  • La pagina carica le risorse con una risposta 200, ma JavaScript continua a fallire: registra il primo errore nella console e le versioni di ownCloud Web/Infinite Scale. Un errore di sintassi o di runtime può indicare una build personalizzata o un'estensione incompatibile; non dedurlo solo da una risposta 200.

Console degli strumenti per sviluppatori del browser a scopo illustrativo che mostra un esempio di risposta 404 per una risorsa JavaScript

Esempio di illustrazione diagnostica: un errore 404 per una risorsa JavaScript è un indizio per verificare l'URL della risorsa e il percorso di caricamento, non una prova di una causa specifica.

3. Verificare lo stato delle risorse web e dei servizi.

Se la richiesta non riuscita riguarda una risorsa, innanzitutto verifica se la tua istanza utilizza i file web di ownCloud inclusi nel pacchetto o file compilati su misura. La guida dell'amministratore di ownCloud 8.2 indica WEB_ASSET_PATHche punta alle risorse del client web compilate su misura. Se imposti questa variabile, verifica che il percorso esista all'interno dell'implementazione in esecuzione, contenga la build completa e sia leggibile dal processo che gestisce l'interfaccia web. Se non utilizzi risorse personalizzate, non aggiungere questa variabile come soluzione provvisoria.

Per un'implementazione con Docker Compose, esegui questi comandi dalla directory contenente il file Compose:

docker compose ps
docker compose logs --tail=100 ocis

Il primo comando mostra se i servizi sono in esecuzione; il secondo visualizza i log recenti per il servizio denominato ocis. Se il file Compose utilizza un nome di servizio diverso o esegue il frontend separatamente, sostituisci il nome del servizio con quello effettivo e controlla anche i log del proxy/frontend. Per un'installazione manuale o una distribuzione orchestrata, utilizza invece i comandi di servizio e di log della piattaforma. Cerca errori di avvio, errori di percorso delle risorse o errori di connessione upstream al momento del caricamento della pagina non riuscito.

Terminale illustrativo che mostra i comandi docker compose ps e docker compose logs senza output di esempio

Illustrazione dei due controlli Compose; i nomi effettivi dei servizi e i messaggi di log variano a seconda dell'implementazione.

4. Verificare l'URL pubblico e il percorso proxy

Se le richieste puntano a un vecchio nome host, a uno schema errato o a un percorso non gestito dal proxy, verificare la configurazione dell'URL pubblico e le regole del proxy. ownCloud documenta OCIS_URLl'URL utilizzato per definire le modalità di accesso a Infinite Scale. In una distribuzione che utilizza un proxy inverso, assicurarsi che l'indirizzo HTTPS, il nome DNS e le regole di routing accessibili dal browser corrispondano all'URL pubblico configurato. Se il proxy o il dominio sono stati modificati di recente, confrontare la configurazione corrente con l'ultima versione funzionante e correggere solo i valori non corrispondenti.

Eseguire questa verifica WEB_ASSET_PATHsolo se sono configurate risorse personalizzate. Controllare OCIS_URLle impostazioni proxy/TLS quando il browser viene reindirizzato a un host imprevisto o richiede risorse da un'origine errata. Queste impostazioni variano a seconda dell'implementazione, quindi non incollare un valore di esempio generico in un ambiente di produzione. La guida ufficiale di ownCloud Web sulle risorse personalizzate , la documentazione del servizio proxy e la guida TLS descrivono queste aree di configurazione.

Editor di configurazione illustrativo che evidenzia WEB_ASSET_PATH e OCIS_URL per i controlli di distribuzione.

Illustrazione dei valori di configurazione da esaminare; i valori corretti dipendono dall'URL pubblico e dall'eventuale utilizzo di risorse personalizzate.

Verifica la correzione

Ricarica il sito in una normale finestra del browser e verifica che l'interfaccia venga visualizzata correttamente, che la Console non presenti errori JavaScript bloccanti e che le richieste JavaScript/CSS necessarie non restituiscano più risposte 404 o 5xx. Chiedi a un secondo utente di testare lo stesso indirizzo pubblico. Se la pagina risulta ancora vuota mentre le risorse vengono caricate correttamente, conserva il primo errore della console, i dettagli della richiesta non riuscita, la versione di Infinite Scale e i log di servizio pertinenti per il tuo amministratore o per il supporto di ownCloud. Oscura i cookie, le intestazioni di autorizzazione e i token prima di condividere le schermate del browser.

Lascia un commento

Evita i timeout di blocco dei file di ownCloud con il backend giusto

Distingui i conflitti di blocco del database dai blocchi WebDAV scaduti, quindi scegli e configura la soluzione ownCloud 10 più adatta.

Cosa controllare quando ownCloud Web si apre su una pagina vuota

Cosa controllare quando ownCloud Web si apre su una pagina vuota

Individua le cause di una schermata web ownCloud vuota, come la cache del browser, la mancanza di risorse web, errori di servizio o impostazioni URL del proxy inverso, tramite controlli mirati.

Rimuovi l'avviso di memoria PHP di ownCloud nel runtime corretto

Imposta il limite di memoria PHP web di ownCloud, riavvia il servizio corrispondente e verifica il valore attivo senza confonderlo con le impostazioni della CLI o i limiti di caricamento.

Risoluzione dei problemi di connessione MySQL di ownCloud 10

Scopri se MySQL, PHP, le impostazioni dei socket o i permessi del database stanno bloccando ownCloud 10, quindi verifica una soluzione sicura.

Imposta un limite di scadenza preciso per i link pubblici di ownCloud.

Imposta un limite di scadenza preciso per i link pubblici di ownCloud.

Rendi obbligatoria la scadenza dei link pubblici in ownCloud Classic, imposta una durata massima e verifica le condivisioni esistenti che potrebbero richiedere una pulizia separata.

Aggiungi l'autenticazione a due fattori TOTP a ownCloud Infinite Scale con Keycloak

Aggiungi l'autenticazione a due fattori TOTP a ownCloud Infinite Scale con Keycloak

Abilita TOTP tramite Keycloak, registra gli utenti in modo sicuro e scopri quando si applicano le impostazioni MFA a livello di percorso di Infinite Scale.

Ripristina la sincronizzazione di ownCloud abbinando il client al tuo server

Verifica se il problema è dovuto a un'incompatibilità tra OC10 e 7.x o a un journal CSync danneggiato, quindi applica la soluzione corretta senza eliminare i file sincronizzati.

Metti ownCloud su HTTPS con Let's Encrypt e Nginx

Metti ownCloud su HTTPS con Let's Encrypt e Nginx

Scegli HTTP-01 o DNS-01, configura un proxy inverso ownCloud e verifica che Certbot rinnovi automaticamente i certificati HTTPS.

Collega ownCloud Infinite Scale a LDAP per l'accesso degli utenti.

Configura l'accesso LDAP di oCIS, allinea le ricerche di utenti e gruppi e verifica le impostazioni TLS e dello schema prima del rilascio.

Collega un bucket S3 a ownCloud 10 come spazio di archiviazione esterno.

Collega un bucket S3 a ownCloud 10 come spazio di archiviazione esterno.

Aggiungi un bucket Amazon S3 a ownCloud 10, prepara credenziali ed endpoint compatibili e verifica l'accesso senza confondere un punto di montaggio con lo storage primario.