Collega Nextcloud a Collabora CODE eseguendo l' collabora/codeimmagine ufficiale, limita la porta all'host, instrada un sottodominio HTTPS dell'ufficio attraverso un proxy inverso compatibile con WebSocket e imposta l'URL pubblico nell'integrazione di Nextcloud con Collabora. Dieci minuti sono un tempo plausibile solo se Docker, DNS, TLS e il proxy sono pronti.
Innanzitutto, scegli il servizio Office più adatto alle tue esigenze. A partire da ottobre 2026, Nextcloud distingue Nextcloud Office, basato su Euro-Office, da Collabora Online. CODE è la versione di sviluppo di Collabora Online, quindi è necessario utilizzare l'integrazione con Collabora e non il connettore Euro-Office. L'app CODE integrata è la più veloce per uso personale, ma Nextcloud la descrive come più lenta e priva di funzionalità di scalabilità avanzate. Un container separato è più facile da gestire in modo indipendente, ma richiede attività di proxy e aggiornamento. CODE è adatto all'uso domestico e ai test; se un'azienda necessita di supporto per la produzione, è consigliabile scegliere una distribuzione Collabora Online supportata.
Assicurati di avere un indirizzo HTTPS Nextcloud funzionante, un hostname separato per l'ufficio con TLS valido e l'accesso a Docker sull'host CODE. Punta l'hostname dell'ufficio a un proxy inverso in grado di instradare il traffico verso il container. Sia i browser degli utenti che il server Nextcloud devono essere in grado di raggiungere l'URL dell'ufficio.
Se DNS o TLS non sono pronti, non esporre la porta 9980 pubblicamente come scorciatoia. Associala all'interfaccia di loopback e completa prima la configurazione del proxy.
Sostituisci il nome host di esempio di Nextcloud con l'origine HTTPS esatta utilizzata dagli utenti per accedere. Questa aliasgroup1impostazione limita gli host WOPI (il servizio di file che fornisce i documenti all'editor) a cui è consentita la connessione. Non utilizzare un carattere jolly solo per far sparire una connessione non riuscita.
docker pull collabora/code
docker run -t -d --name collabora-code -p 127.0.0.1:9980:9980 -e 'aliasgroup1=https://cloud.example.com:443' --restart unless-stopped --cap-add MKNOD collabora/codeIl binding 127.0.0.1mantiene la porta privata mentre un proxy sullo stesso host può raggiungerla. Se il proxy si trova altrove, consenti solo a quel proxy attendibile di connettersi alla porta 9980.
Verifica che il container sia stato avviato e che il suo endpoint di rilevamento risponda localmente:
docker ps --filter name=collabora-code
docker logs --tail=50 collabora-code
curl -kfsS -o /dev/null -w 'Discovery HTTP %{http_code}\n' https://127.0.0.1:9980/hosting/discovery-kIgnora la convalida del certificato solo per questo controllo locale autofirmato; non corregge un certificato pubblico non valido.
Servite https://office.example.comil vostro proxy inverso con un certificato valido e instradate le richieste a CODE. Le linee guida di Collabora sui proxy riguardano le risorse dell'editor, il rilevamento/le funzionalità /cool/e l'inoltro WebSocket. Senza gli aggiornamenti WebSocket, la pagina potrebbe caricarsi mentre l'editor non funziona.
Utilizza la configurazione predefinita del tuo software proxy. Se termina la connessione TLS prima di CODE, segui le impostazioni TLS del backend documentate; non disabilitare la verifica dei certificati a livello globale.
In Nextcloud, abilita o installa l'app di integrazione Collabora disponibile per la tua versione. Quindi apri l'area di amministrazione di Office e inserisci l'URL pubblico di Collabora https://office.example.com. I manuali attuali etichettano l'impostazione come "Collabora Online Server"; la terminologia e le etichette dell'app possono variare a seconda della versione, soprattutto perché Nextcloud ha aggiunto l'opzione Euro-Office. Seleziona Collabora Online per questo server CODE. Non inserire l'indirizzo solo container https://127.0.0.1:9980a meno che Nextcloud stesso non sia in esecuzione sullo stesso host e tale indirizzo non sia anche l'endpoint del servizio configurato; nella configurazione proxy consigliata, utilizza il nome host pubblico di Office.
Salva le impostazioni ed esegui il controllo di connessione integrato, se la tua versione lo prevede. Se fallisce, confronta l'origine Nextcloud esatta in aliasgroup1, verifica che sia Nextcloud che il browser possano risolvere e raggiungere il nome host dell'ufficio e controlla i log del reverse proxy per percorsi negati o errori WebSocket.
Apri un piccolo documento di prova in Nextcloud e verifica che si apra nell'editor del browser, accetti una modifica, salvi e si riapra con la modifica intatta. Esegui il test sia da un account utente normale che da un account amministratore. Un semplice controllo di rilevamento funzionante conferma che CODE risponde; non dimostra che l'autorizzazione WOPI, i WebSocket proxy e le operazioni di salvataggio del documento funzionino correttamente.
Per un server personale o un piccolo team, CODE Docker separa l'editor dallo stack PHP di Nextcloud. Inoltre, hai il controllo del proxy, dei riavvii, dei controlli di compatibilità e degli aggiornamenti delle immagini. L'app CODE integrata è più semplice, ma condivide l'host e offre meno funzionalità di scalabilità. Per un'organizzazione che necessita di modifiche quotidiane, è consigliabile valutare un servizio Collabora Online supportato anziché considerare CODE come una soluzione di produzione garantita.
Quando sei pronto per aggiornare CODE, scarica la nuova immagine e ricrea il container con le stesse opzioni. Prima di aggiornare un servizio da cui dipendono gli utenti, consulta le note di rilascio e verifica l'apertura e il salvataggio dei documenti; il latesttag potrebbe cambiare. Blocca una versione specifica dell'immagine quando è importante garantire implementazioni ripetibili.
La configurazione funziona correttamente quando il nome host dell'ufficio pubblico presenta un certificato valido, il controllo della connessione a Nextcloud ha esito positivo e un documento di prova si apre, viene salvato e riaperto tramite l'editor. Se la pagina iniziale dell'ufficio si carica ma la modifica si blocca, verificare l'inoltro WebSocket. Se Nextcloud segnala che l'host non è autorizzato, correggerlo aliasgroup1in modo che corrisponda all'origine Nextcloud effettiva. Se CODE risponde localmente ma non dai browser degli utenti, verificare il DNS pubblico, il routing del firewall e il proxy inverso.
Riferimenti: esempio di installazione Docker di Nextcloud ; opzioni di installazione di Nextcloud Office ; configurazione di Nextcloud Collabora ; impostazioni del reverse proxy di Collabora ; dettagli ufficiali dell'immagine Docker di CODE ; opzioni di Nextcloud Hub 26 Summer Office .
Sposta il lavoro sulle miniature in una pianificazione in background controllata, ridimensiona le anteprime non utilizzate e verifica la coda senza sovraccaricare il server Nextcloud.
Individua il file, la regola di esclusione, il problema di connessione o lo stato del database del client che blocca la sincronizzazione di Nextcloud, quindi verifica che i caricamenti e i download avvengano in sicurezza.
Individua il limite di PHP OPcache che causa l'avviso di Nextcloud, aggiorna la configurazione PHP web corretta, riavvia in modo sicuro e verifica il risultato.
Confronta il codice integrato e quello basato su Docker, quindi connetti Collabora Online a Nextcloud tramite un proxy inverso HTTPS sicuro.
Pianifica un'implementazione HA affidabile di Nextcloud con storage condiviso, blocco Redis, routing MariaDB con supporto al quorum e controlli di failover pratici.
Configurare e verificare la raggiungibilità di un relay TURN per Nextcloud Talk quando firewall o NAT restrittivi bloccano i flussi multimediali diretti delle chiamate.
Utilizza il report sui file non validi per identificare il codice Nextcloud modificato, mancante o in eccesso, ripristinare in modo sicuro i file attendibili e verificarne il risultato.
Configura OAuth2 per Nextcloud Mail con Gmail o Microsoft 365, verifica la ricezione e l'invio e risolvi i problemi più comuni relativi al consenso e al protocollo SMTP.
Utilizza OCC per ripristinare l'accesso a Nextcloud, verificare lo stato della migrazione del database e scegliere il comando corretto per le installazioni di archivio, Docker o Snap.
Collega Nextcloud a LDAP o Active Directory, limita l'accesso con filtri per utenti e gruppi e verifica l'autenticazione sicura prima del lancio.
