L'integrazione di Collabora Online con ownCloud Infinite Scale (oCIS) avviene tramite WOPI, una configurazione diversa da quella utilizzata da ownCloud Classic. WOPI, acronimo di Web Application Open Platform Interface, è il protocollo che consente a una suite per ufficio online di richiedere un file da una piattaforma di archiviazione, modificarlo nel browser e riscriverne il risultato.
Questa distinzione è importante perché le attuali implementazioni di Infinite Scale utilizzano il servizio di collaborazione integrato come ponte tra oCIS e Collabora. Non è necessario installare la vecchia app ownCloud Classic Collabora e configurarla in modo che punti a un URL del server. L'applicazione Office viene invece registrata tramite i servizi di collaborazione e di registrazione delle app. La documentazione ufficiale di ownCloud WOPI elenca Collabora come applicazione Office supportata, mentre la documentazione del servizio di collaborazione ne illustra il funzionamento e le impostazioni richieste.
A partire da ottobre 2026, le release ufficiali di ownCloud su GitHub includono Infinite Scale 8.2.0, rilasciata il 10 agosto 2026. L'esempio di implementazione del progetto potrebbe evolversi in modo indipendente, pertanto si consiglia di utilizzare un tag di produzione testato anziché presumere che un'immagine rolling sia appropriata. L'esempio di implementazione completo ufficiale di oCIS attualmente raccomanda il tag Collabora CODE 26.04.3.1.1nel suo file di ambiente. Prima di bloccare le versioni, si prega di verificare le release ufficiali di Infinite Scale e il file di ambiente dell'esempio di implementazione ufficiale .
L'integrazione in produzione prevede in genere tre endpoint logici:
| Punto finale | Scopo | Esempio |
|---|---|---|
| Scala infinita | API web e di archiviazione di ownCloud rivolte all'utente | https://cloud.example.com |
| Collabora online | Editor del browser e client WOPI | https://office.example.com |
| Servizio di collaborazione WOPI | Ponte attraverso il quale Collabora legge e scrive file oCIS | URL del servizio interno o nome host WOPI instradato esternamente, a seconda della topologia |
Verificato: COLLABORATION_APP_ADDR è l'URL di Collabora e COLLABORATION_WOPI_SRCidentifica la sorgente WOPI utilizzata dall'applicazione Office. Dipendente dall'ambiente: la sorgente WOPI non deve necessariamente essere un nome host pubblico separato quando Collabora e il servizio di collaborazione condividono una rete di container attendibile. L'esempio ufficiale di Compose attualmente in uso utilizza http://collaboration:9300internamente. Una distribuzione separata potrebbe richiedere un nome host WOPI HTTPS instradato.
Suggerimento utile: prima di copiare i valori di configurazione, definisci la topologia. Se tutti i componenti vengono eseguiti in un unico stack Compose ufficiale, parti da quell'esempio. Se Collabora si trova su un altro host o cluster Kubernetes, documenta quale nome DNS ciascuna parte può effettivamente risolvere e raggiungere.
Prima di modificare la configurazione di oCIS, assicurarsi che i nomi ownCloud e Collabora vengano risolti correttamente e che Collabora esponga il suo endpoint di rilevamento. Collabora pubblica le funzionalità WOPI tramite /hosting/discovery. Un controllo di base è:
dig +short cloud.example.com
dig +short office.example.com
curl -fsS https://office.example.com/hosting/discovery | headDovresti ricevere un file XML dall'endpoint di rilevamento. Se la connessione TLS termina su un proxy inverso, verifica che il certificato presentato office.example.comsia valido dal punto di vista dell'host o della rete del container oCIS.
Didascalia: Verificare la risoluzione dei nomi e l' /hosting/discoveryendpoint Collabora prima di eseguire il debug della registrazione WOPI all'interno di Infinite Scale.
Un equivoco comune: visualizzare una landing page di Collabora in un browser non dimostra che l'integrazione con WOPI funzioni. Dimostra solo che l'endpoint web è raggiungibile. Il servizio di collaborazione deve poter raggiungere Collabora e Collabora deve essere in grado di raggiungere la sorgente WOPI.
Azione utile: eseguire i test di connettività dallo stesso namespace di rete del servizio pertinente, ad esempio dall'interno del container di collaborazione quando si utilizza Docker.
Il servizio di collaborazione non viene avviato automaticamente da una ocis serverconfigurazione generica in modalità supervisionata. La documentazione di ownCloud specifica che deve essere avviato esplicitamente, poiché gli amministratori possono eseguire più istanze del servizio di collaborazione per diversi prodotti Office.
Le impostazioni importanti per Collabora sono:
COLLABORATION_APP_NAME=CollaboraOnline
COLLABORATION_APP_PRODUCT=Collabora
COLLABORATION_APP_ADDR=https://office.example.com
COLLABORATION_WOPI_SRC=http://collaboration:9300
OCIS_URL=https://cloud.example.comIl codice sorgente WOPI riportato sopra corrisponde esattamente alla topologia utilizzata dall'esempio ufficiale di Compose: Collabora e il servizio di collaborazione condividono la stessa rete Docker. Se il server di Collabora è esterno, sostituire l'URL interno con l'indirizzo raggiungibile da Collabora.
Il servizio dipende anche dal gateway e dall'infrastruttura del fornitore di app di Infinite Scale. In una distribuzione con container separati, la documentazione di ownCloud avverte specificamente che la configurazione oCIS deve essere condivisa con il container di collaborazione perché i segreti generati sono necessari tra i servizi. Consultare la definizione ufficiale corrente di Collabora Compose .
Didascalia: Un processo di servizio di collaborazione dovrebbe iniziare con l'indirizzo Collabora e la sorgente WOPI previsti; utilizzare i log di servizio reali per confermare i valori nella propria implementazione.
Suggerimento utile: se hai creato l'installazione manualmente, confronta il tuo ambiente con quello ufficiale collabora.ymlinvece di copiare le impostazioni da un vecchio tutorial di cs3org/wopiserver.
Collabora deve potersi fidare dell'host WOPI ed essere autorizzato a eseguire il rendering all'interno della pagina Web di ownCloud. L'esempio ufficiale di oCIS Compose passa a Collabora le opzioni che terminano la connessione TLS sul proxy inverso e la impostano net.frame_ancestorssul dominio oCIS. Genera inoltre una chiave di prova WOPI prima di avviare Collabora.
Nell'esempio ufficiale, i valori rilevanti dal punto di vista collaborativo includono:
DONT_GEN_SSL_CERT=YES
extra_params:
--o:ssl.enable=...
--o:ssl.ssl_verification=...
--o:ssl.termination=true
--o:welcome.enable=false
--o:net.frame_ancestors=cloud.example.comI flag SSL esatti dipendono da dove termina la connessione TLS. La configurazione consigliata per le connessioni esposte a Internet è HTTPS con verifica del certificato abilitata. L' INSECURE=trueopzione presente nell'esempio è disponibile per le configurazioni locali che utilizzano certificati autofirmati; la guida di implementazione di ownCloud indica esplicitamente agli amministratori di rimuoverla o di impostarla su false per i server pubblici.
Didascalia: Un endpoint Collabora raggiungibile è un prerequisito; le implementazioni in produzione dovrebbero esporlo tramite HTTPS con un certificato considerato attendibile dagli altri componenti.
Azione utile: se il caricamento del documento produce un iframe vuoto o un errore CSP, controlla gli strumenti per sviluppatori del browser e le intestazioni del proxy inverso. Non disabilitare indiscriminatamente la verifica del certificato o le restrizioni di sicurezza dei contenuti solo per far caricare la pagina.
Il servizio di registro delle applicazioni di Infinite Scale decide quale applicazione può aprire ciascun tipo MIME. La sua configurazione può definire il tipo MIME, l'estensione, l'icona, l'applicazione predefinita e se gli utenti possono creare nuovi file di quel tipo. La documentazione ufficiale del Registro delle applicazioni descrive questi campi.
Un dettaglio fondamentale è che il nome dell'app utilizzato dal registro deve corrispondere al provider di collaborazione effettivamente registrato. Gli esempi di distribuzione ufficiali di Collabora attualmente in uso utilizzano CollaboraOnlinee COLLABORATION_APP_NAMEcome Collaboranome del prodotto. Non utilizzare nomi copiati da esempi precedenti senza prima verificare la versione di distribuzione.
Dopo l'avvio, accedi a ownCloud Web e apri un documento Office supportato. Un flusso di lavoro corretto si presenta in questo modo:
Didascalia: Il test finale consiste nell'aprire un vero documento di Office da ownCloud Web, modificarlo in Collabora, chiuderlo e verificare che la versione salvata sia nuovamente visibile in Infinite Scale.
Un'azione utile: apporta una piccola modifica a un documento di prova temporaneo, chiudi l'editor, riapri il file e verifica che la modifica sia stata salvata. Una pagina che si limita a caricare l'editor non costituisce un test completo del percorso di scrittura.
Per una distribuzione Docker convenzionale, il percorso a minor rischio è ocis_fulll'esempio gestito da ownCloud. Include Infinite Scale, il servizio di collaborazione Collabora e Traefik. La guida ufficiale afferma che la distribuzione richiede domini per oCIS e Collabora e documenta il componente WOPI come parte dello stack. Consultare la guida ufficiale completa alla distribuzione .
Un tipico file di ambiente orientato alla produzione include valori concettualmente come:
OCIS_DOCKER_IMAGE=owncloud/ocis
OCIS_DOCKER_TAG=<tested-production-version>
OCIS_DOMAIN=cloud.example.com
COLLABORA=:collabora.yml
COLLABORA_DOCKER_TAG=<tested-collabora-version>
COLLABORA_DOMAIN=office.example.com
INSECURE=falseQuindi avvia lo stack con:
docker compose pull
docker compose up -d
docker compose psVerificato: l'attuale esempio ufficiale di reverse proxy abilita barre, punti interrogativi e caratteri di percentuale codificati nel punto di ingresso HTTPS perché la collaborazione/Collabora li richiede. Dipendente dall'ambiente: se si utilizza Nginx, HAProxy, un controller di ingresso o un bilanciatore di carico cloud al posto di Traefik, è necessario riprodurre la gestione degli URL, il comportamento WebSocket/proxy, i certificati e i timeout richiesti in tale piattaforma.
Suggerimento utile: non tradurre letteralmente le etichette di Traefik in quelle di un altro proxy. Usale per comprendere i requisiti di routing, quindi implementali utilizzando la sintassi documentata del tuo proxy.
| Sintomo | area probabile | Controlla successivo |
|---|---|---|
| Nessuna opzione per ufficio per DOCX/ODT | Registro delle applicazioni / registrazione del fornitore | Verificare che il servizio di collaborazione sia registrato e che il tipo MIME punti al nome corretto dell'app. |
| La pagina di collaborazione funziona, ma il documento non si apre. | raggiungibilità WOPI | Verificare che Collabora possa accedere COLLABORATION_WOPI_SRCe ispezionare i registri di collaborazione. |
| Finestra vuota o errore CSP del browser | Configurazione Frame/CSP | Verifica frame_ancestors, oCIS CSP e l'origine effettivamente utilizzata dal browser. |
| Errore TLS o del certificato | Proxy inverso / catena di fiducia | Utilizza certificati validi in ambiente di produzione e testa HTTPS dai container del servizio, non solo dalla tua workstation. |
| L'editor si apre ma il salvataggio fallisce. | Percorso di scrittura WOPI / segreti condivisi | Esaminare i log di collaborazione e Collabora e verificare che la configurazione oCIS condivisa sia montata dove necessario. |
| Un file si apre inaspettatamente in più suite di uffici | Integrazioni con più uffici | Il file di configurazione ufficiale attualmente avverte di non abilitare applicazioni Office sovrapposte perché la funzionalità di interblocco tra applicazioni che utilizzano lo stesso file non è disponibile. |
Nota: Infinite Scale supporta Collabora tramite WOPI, il servizio di collaborazione integrato funge attualmente da ponte e la distribuzione completa ufficiale fornisce un'architettura di riferimento funzionante.
Dipende dal tuo ambiente: se l'endpoint WOPI è un URL interno del container o un nome host pubblico, dove termina la connessione TLS, quale proxy utilizzi e se Collabora è in esecuzione nella stessa rete di oCIS.
Non dare per scontato che le istruzioni per ownCloud Classic siano valide anche per Infinite Scale. La documentazione di Classic che indica di installare un'app Collabora/richdocuments o di configurarla tramite l'interfaccia utente di amministrazione di Classic descrive un'architettura di prodotto diversa.
Il flusso di lavoro di integrazione più affidabile è quindi il seguente: partire dal modello di implementazione ufficiale di Infinite Scale, verificare la raggiungibilità della rete e di TLS, configurare il servizio di collaborazione, confermare che Collabora si fidi e possa raggiungere l'host WOPI, registrare i tipi MIME pertinenti e, infine, testare sia l'apertura che il salvataggio di un documento reale.
Scopri come aggiungere contatti a Outlook sul web, al nuovo Outlook, a Outlook classico e ai dispositivi mobili, e come funzionano la sincronizzazione dei contatti e l'importazione di file CSV.
Cambiare il colore di una pagina di Word, aggiungere un'immagine di sfondo, rimuoverla e abilitare la stampa in background su Windows o Mac con istruzioni chiare e aggiornate.
Collega ONLYOFFICE Desktop Editors al tuo server ownCloud, accedi, apri i file nel cloud, gestisci la connessione e risolvi i problemi di configurazione più comuni.
Risolvere i problemi di utilizzo elevato della CPU di Collabora Online identificando i processi del kit che consumano troppe risorse, controllando metriche e log, ottimizzando la concorrenza e la pulizia e verificando la sicurezza delle correzioni.
Scopri come personalizzare ONLYOFFICE Docs con un logo nell'intestazione e i colori dell'interfaccia, inclusi i limiti di licenza, la configurazione del tema JSON, i percorsi Docker e i test.
Per correggere il testo di difficile lettura in LibreOffice Calc, controlla il tema dell'applicazione, il carattere delle celle, i colori di riempimento, gli stili e la formattazione condizionale, quindi verifica l'output di stampa.
Rimuovi in modo sicuro l'avviso di blocco da utente sconosciuto di LibreOffice. Verifica le sessioni attive, proteggi una copia, rimuovi solo i blocchi obsoleti verificati e testa il documento.
Correggi il testo arabo o ebraico che scorre, si allinea o si mescola in modo errato con l'inglese in LibreOffice Writer. Abilita layout di testo complessi, imposta la direzione del paragrafo e verifica il risultato.
Scopri come utilizzare le funzioni CERCA.VERT e CERCA.X in LibreOffice Calc, incluse le corrispondenze esatte, le ricerche a sinistra, i risultati non trovati, la ricerca inversa, le alternative a INDICE/CONFRONTA e gli errori più comuni.
Risolvere i problemi di convalida della prova WOPI di Collabora Online verificando le chiavi di individuazione, la rotazione delle chiavi, gli URL proxy, i timestamp e le liste di host consentiti.
