Inizia verificando che il browser, Nextcloud e Collabora possano raggiungere gli URL del server corretti tramite lo stesso schema HTTP o HTTPS. In Nextcloud, testa gli endpoint di Collabora /hosting/capabilities; /hosting/discoveryse questi rispondono ma i documenti continuano a non essere caricati, controlla il percorso WebSocket del proxy inverso e l'elenco di WOPI consentiti.
Il messaggio "Beh, questo è imbarazzante" indica un errore generico nell'apertura del documento, non costituisce di per sé una diagnosi. La causa potrebbe essere un URL irraggiungibile, un'incongruenza TLS o DNS, un proxy che blocca gli aggiornamenti WebSocket o un host WOPI di cui Collabora o Nextcloud non si fidano. I controlli seguenti utilizzano un esempio tipico con Nextcloud all'indirizzo https://cloud.example.come Collabora all'indirizzo https://office.example.com; sostituire entrambi i nomi con i propri hostname effettivi.
Da un browser sulla stessa rete dell'utente, apri questi URL, modificando il nome host Collabora:
https://office.example.com/hosting/capabilitieshttps://office.example.com/hosting/discoveryDovrebbero restituire i dati dell'endpoint Collabora anziché un avviso del certificato del browser, una pagina 404 o un errore del proxy inverso. L'endpoint di rilevamento normalmente restituisce XML. È possibile eseguire il test anche dall'host Nextcloud o dal suo container applicativo:
curl -fsS https://office.example.com/hosting/capabilities
curl -fsS https://office.example.com/hosting/discoveryUn errore dal browser indica un problema con il DNS pubblico o LAN, il firewall, il certificato o il routing proxy. Un successo del browser ma un errore da riga di comando da Nextcloud significa che il percorso lato server è diverso; il browser dell'utente e il server Nextcloud necessitano ciascuno di un proprio percorso funzionante per raggiungere Collabora. Il manuale di amministrazione di Nextcloud raccomanda di testare entrambi gli endpoint da entrambe le posizioni e di verificare che Collabora possa raggiungere Nextcloud anche tramite HTTP(S).
In Nextcloud, apri Impostazioni → Amministrazione → Office e verifica che il campo Server Collabora Online contenga l'URL pubblico o comunque raggiungibile di Collabora. Utilizzalo https://se il servizio è configurato per HTTPS. La documentazione di Nextcloud afferma che l'URL configurato dovrebbe utilizzare lo stesso protocollo dell'installazione di Collabora e raccomanda HTTPS.
Ora controlla il percorso di ritorno. Dall'host o dal container di Collabora, richiedi l'endpoint di stato di Nextcloud:
curl -fsS https://cloud.example.com/status.phpLa risposta dovrebbe essere raggiungibile da Collabora, non solo dal tuo laptop. Se uno dei server si trova in Docker, esegui il test dal container o dallo spazio dei nomi di rete pertinente: un nome host che si risolve sull'host potrebbe non risolversi all'interno di un container. Per un server CODE integrato, Nextcloud deve essere in grado di raggiungere se stesso utilizzando lo stesso nome host che gli utenti usano nel browser. Se la risoluzione DNS divisa o la risoluzione del nome locale lo impediscono, correggi il DNS o la mappatura host invece di inserirlo localhostper un servizio remoto.
Se l'URL di individuazione si carica ma la finestra dell'editor rimane vuota, continua a caricare all'infinito o si disconnette, controlla il proxy davanti a Collabora. La modifica utilizza una connessione WebSocket persistente: il proxy deve instradare /cool/…/wsl'endpoint corrente di Collabora al servizio Collabora e passare le intestazioni di aggiornamento HTTP/1.1. Consulta l'esempio di proxy Collabora aggiornato per il tuo software proxy e la tua versione; non incollare una vecchia configurazione senza modificarla.
Le installazioni più vecchie potrebbero ancora utilizzare percorsi come /lool. La guida alla migrazione di Collabora documenta il passaggio da loola coole da loleafleta browser. Un proxy lasciato sui vecchi percorsi può restituire errori 404 anche quando il dominio di base è aperto. Dopo aver modificato un file proxy, convalidarne la sintassi con il comando di test del server, ricaricarlo, quindi testare nuovamente l'URL di rilevamento e aprire un documento.
Controlla i log di accesso ed errore allo stesso timestamp del tentativo fallito. Un errore 404 /browsersuggerisce /coolun percorso di routing; un aggiornamento WebSocket non riuscito suggerisce una gestione dell'aggiornamento mancante o un timeout; un errore 502 di solito significa che il proxy non riesce a raggiungere il server upstream di Collabora. Questi sono indizi, non diagnosi definitive, quindi confrontali con i log di Collabora.
WOPI (Web Application Open Platform Interface) è il protocollo utilizzato da Nextcloud e Collabora per scambiarsi le richieste di accesso ai documenti. Se il log di Collabora segnala "Nessun host WOPI accettabile trovato" o un host WOPI non autorizzato, verificare che Collabora sia stato configurato per considerare attendibile il nome host di Nextcloud e non il proprio nome host di Collabora. Utilizzando l'immagine Docker, esaminare la configurazione di avvio e i log del container:
docker ps
docker logs --tail=100 CONTAINER_NAMESostituire CONTAINER_NAMEcon il nome effettivo del contenitore Collabora. Per un'installazione di pacchetto nativo, esaminare il registro del servizio con sudo journalctl -u coolwsd --since "15 minutes ago". Seguire le istruzioni di configurazione dell'host WOPI per il metodo di installazione; evitare regole di autorizzazione con caratteri jolly generici.
In Nextcloud Office è presente anche un elenco separato di indirizzi IP consentiti per WOPI. Questo elenco limita gli indirizzi IP dei server Collabora che possono richiedere file da Nextcloud. Aggiungi l'indirizzo IP di origine che Nextcloud effettivamente utilizza per Collabora, che può variare in presenza di reti Docker o di un proxy inverso. Non inserire 0.0.0.0o disabilitare la restrizione solo per evitare un errore: Nextcloud consiglia di limitare le richieste WOPI agli indirizzi IP previsti dei server Collabora.
Eseguire nuovamente il test da un browser utente e dal server Nextcloud: gli endpoint di rilevamento e funzionalità dovrebbero rispondere, Nextcloud dovrebbe raggiungere l'URL di Collabora configurato e Collabora dovrebbe raggiungere l'endpoint di stato di Nextcloud. Quindi, aprire un piccolo documento di prova. Se il problema persiste, registrare la data e l'ora, l'azione sul documento interessata, lo stato HTTP o WebSocket nel log del proxy e le corrispondenti voci di log di Nextcloud e Collabora. Queste informazioni aiutano a distinguere un errore del percorso di rete da un problema di autorizzazione WOPI.
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.
Analizza le connessioni del browser, WOPI e WebSocket di Collabora per capire perché un documento non si apre, quindi applica la soluzione più adatta alla tua configurazione di Nextcloud.
Distribuisci repliche di Collabora CODE con Helm, mantieni ogni documento su un singolo pod tramite l'affinità WOPI e verifica l'ingress, il posizionamento dei nodi e la modifica su Nextcloud.
Traccia un handshake socket non riuscito dal browser a coolwsd, quindi abbina il percorso del reverse proxy alla tua versione di Collabora, inclusa la modifica Apache CODE 26.04.
Traccia gli errori di WOPI di Collabora dovuti a chiavi non corrispondenti, dati di rilevamento obsoleti, deriva dell'orologio o modifiche all'URL del proxy, senza indebolire la convalida.
Reimposta lo zoom del browser, testa una sessione pulita e identifica quando un menu di dimensioni non corretto richiede un aggiornamento del server Collabora.
Implementa Collabora CODE con Docker, connettilo in modo sicuro a Nextcloud Office e verifica la modifica dei documenti con pratici controlli WOPI e proxy.
Attivare temporaneamente la modalità di debug di coolwsd, acquisire un'apertura non riuscita e utilizzare la sequenza di log per separare i problemi relativi a WebSocket, WOPI, proxy e container.
