Inizia verificando se la schermata vuota interessa un solo file o tutti i file, quindi esamina i pannelli Rete e Console del browser insieme ai log di Collabora e della piattaforma di archiviazione. Una schermata vuota è un sintomo, non una diagnosi: l'editor potrebbe essersi caricato mentre la connessione al documento, l'autorizzazione WOPI o le risorse incorporate non funzionavano.
Apri un documento funzionante nella stessa applicazione, quindi prova il file problematico in un altro browser supportato o in una finestra di navigazione in incognito. Non modificare l'originale durante la diagnosi. Un singolo file problematico indica un problema di formato, contenuto o autorizzazioni; un problema diffuso indica un problema con i servizi condivisi o con la rete.
| Ciò che osservi | Controllo successivo più utile | Compromesso |
|---|---|---|
| Un documento è vuoto | Prova con un file diverso dello stesso formato; controlla i file dell'app di archiviazione e i log WOPI. | Isolamento rapido, ma non esclude un problema di analisi o di permessi specifico del file. |
| Tutti i documenti non funzionano in un browser | Finestra privata, un altro browser, estensioni e console del browser. | Una soluzione rapida e a basso rischio, ma che si basa sull'utilizzo del browser e non risolve i problemi del server. |
| Tutti gli utenti e i browser falliscono | Richieste di rete, proxy inverso, policy host WOPI e log del server. | Maggiore utilità diagnostica, ma le modifiche potrebbero interessare tutti gli utenti; si consiglia di acquisire prima le impostazioni attuali. |
L'utilizzo di una finestra di navigazione in incognito è solo un test, non una soluzione definitiva. Se in questa finestra funziona, disattiva le estensioni una alla volta oppure cancella i dati del sito per l'origine interessata solo dopo aver verificato di non avere attività non sincronizzate. La cancellazione di tutti i dati del browser può disconnettere gli utenti e rimuovere lo stato del sito non correlato.
In Chrome o Chromium, apri gli Strumenti per sviluppatori ( F12 o Ctrl+Maiusc+I ), seleziona Rete , abilita Mantieni registro e ricarica la pagina. Filtra per WS (WebSocket) e analizza gli errori; la documentazione di riferimento di Chrome sugli Strumenti per sviluppatori relativa alla rete spiega i filtri delle richieste e i dettagli sullo stato. Controlla la Console per errori relativi a CSP, certificati, contenuti misti o JavaScript.
Interpretare le prove anziché applicare una formula generica predefinita:
/browser/percorsi dell'editor: verificare se il proxy inverso inoltra i percorsi Collabora correnti al flusso di sistema corretto./hosting/discoveryendpoint raggiungibile dimostra solo l'accesso HTTP di base; non garantisce il corretto funzionamento della connessione in tempo reale dell'editor.Per le richieste WebSocket, l'obiettivo è un handshake riuscito; lo stato visualizzato dipende dalla versione HTTP e dal percorso proxy, quindi non considerare un singolo numero di stato previsto come universale.
Le attuali linee guida per la risoluzione dei problemi di Nextcloud indicano che il browser dell'utente deve raggiungere entrambi i server tramite HTTP(S), Nextcloud deve raggiungere Collabora e Collabora deve raggiungere Nextcloud. Si richiede inoltre l'utilizzo dello stesso protocollo su entrambi i servizi. Testare l'indirizzo pubblico di Collabora da un browser all'indirizzo https://office.example.com/hosting/discoverye https://office.example.com/hosting/capabilities. Dall'host Nextcloud, utilizzare:
curl -fsS https://office.example.com/hosting/discovery -o /dev/null
curl -fsS https://office.example.com/hosting/capabilities -o /dev/null
Sostituisci il nome host di esempio con il tuo URL Collabora effettivo. Questi controlli verificano la raggiungibilità HTTP, non la corretta esecuzione della modifica. Se il server ha successo ma il browser non funziona, controlla il DNS pubblico, TLS, il firewall o l'esposizione del proxy. La guida alla risoluzione dei problemi di Nextcloud Office elenca questi controlli di connessione e consiglia di esaminare i log di entrambe le applicazioni.
Se le risorse dell'editor statico restituiscono un errore 404 o la connessione live restituisce un errore 502, confronta le tue route del reverse proxy con le impostazioni proxy ufficiali di Collabora . Assicurati che il proxy invii i percorsi Collabora richiesti al server upstream corretto e supporti la connessione WebSocket utilizzata dal browser. Mantieni le informazioni sull'host esterno e sul protocollo HTTPS previste dalla tua implementazione. Non copiare una configurazione per un proxy, un prefisso URL o una versione di Collabora diversi senza verificarne i presupposti. Un nome host Collabora dedicato è spesso più facile da sottoporre a debug; il routing basato sui percorsi richiede una gestione coerente dei prefissi.
WOPI è il protocollo che Collabora utilizza per recuperare e salvare un documento tramite la piattaforma di archiviazione. L'host WOPI è solitamente il nome host di Nextcloud o di un altro servizio di archiviazione, non il nome host di Collabora. Se i log indicano un No acceptable WOPI hosts founderrore, aggiungi o correggi l'host di archiviazione esatto nella configurazione dell'host WOPI di Collabora, quindi verifica che l'elenco di richieste WOPI consentite della piattaforma di archiviazione contenga l'indirizzo del server di Collabora. Nextcloud consiglia di limitare le richieste WOPI agli indirizzi IP previsti di Collabora e di configurare Collabora in modo che si fidi degli host previsti, come indicato nelle sue linee guida di configurazione di Office .
Aggiungere un host attendibile specifico è più sicuro che disabilitare la convalida dell'host o consentire domini generici. Annotate l'impostazione corrente, modificate solo la voce pertinente e riavviate o ricaricate i servizi solo se richiesto dalla vostra implementazione. Se utilizzate Docker, esaminate l'output recente di Collabora con docker logs --since=10m <collabora-container>; sostituite il segnaposto con il nome reale del container. Per le installazioni di pacchetti o Kubernetes, utilizzate invece i log dei servizi o dei pod corrispondenti.
Ricarica lo stesso documento. Verifica che le risorse vengano caricate, che la connessione live rimanga aperta, che il contenuto venga visualizzato e che gli errori della console cessino. Se il problema è condiviso, prova con un secondo documento e un altro utente. Salva una modifica di prova innocua e riaprila per verificare che venga letta e salvata correttamente.
Se la schermata rimane vuota ma le richieste ora hanno esito positivo, controlla i log del server per individuare errori di conversione del documento o specifici del file e confronta un altro file con lo stesso formato. Se il problema è iniziato subito dopo un aggiornamento di Collabora, del browser o del proxy, prova a eseguire un rollback controllato o una modifica del proxy specifica per la versione durante una finestra di manutenzione, anziché modificare più variabili contemporaneamente. La cancellazione della cache del browser è utile solo quando le prove indicano risorse client obsolete; non può risolvere i problemi relativi a percorsi bloccati o richieste WOPI rifiutate.
Installa il chart Helm ufficiale di Collabora, configura l'accesso WOPI e l'affinità di ingresso e verifica che la distribuzione non presenti errori di configurazione comuni.
Utilizza le richieste del browser, i log di WOPI e i controlli proxy mirati per scoprire perché Collabora apre un documento vuoto e scegli una soluzione adeguata alle prove raccolte.
Configura correttamente i dizionari di CODE Docker e contrassegna i passaggi del documento in modo che l'inglese, il francese e le altre lingue supportate ricevano il corretto controllo ortografico.
Regola la soglia di inattività per singola visualizzazione in coolwsd e distinguila dall'oscuramento delle schede in background, dallo scaricamento dei documenti, dal salvataggio automatico e dalla scadenza dell'accesso.
Interrompere i controlli programmati di aggiornamento del CODICE, esaminare i servizi remoti opzionali e utilizzare i controlli di rete in uscita senza interrompere la modifica dei documenti.
Abilita la modifica sicura dei documenti in Seafile configurando l'URL di individuazione di Collabora, HTTPS e l'accesso WOPI per la tua implementazione.
Verifica gli appunti di sistema, regola le autorizzazioni del browser e identifica quando un'integrazione di Collabora incorporata richiede una modifica dei criteri iframe.
Monta i file dei font nella cartella di sistema di Docker e Collabora in modo che i caratteri personalizzati vengano visualizzati nell'editor e riprodotti correttamente nei documenti.
Eseguire il backup del file coolwsd.xml e delle relative sorgenti di distribuzione, ripristinarli in modo sicuro e verificare il CODICE prima che gli utenti riprendano la modifica.
Consenti l'origine Nextcloud o altra origine WOPI esatta nel CODE, quindi verifica l'elenco degli host consentiti attivi e distinguilo dalla restrizione IP di origine di Nextcloud.
