Cum să integrezi Collabora Online cu ownCloud Infinite Scale

Integrarea Collabora Online cu ownCloud Infinite Scale (oCIS) este o integrare WOPI, nu aceeași configurație utilizată de ownCloud Classic. WOPI, sau Web Application Open Platform Interface, este protocolul care permite unei suite de birou online să solicite un fișier de pe o platformă de stocare, să îl editeze în browser și să scrie rezultatul înapoi.

Această distincție este importantă deoarece implementările actuale Infinite Scale utilizează serviciul de colaborare încorporat ca punte între oCIS și Collabora. Nu instalați vechea aplicație ownCloud Classic Collabora și nu o direcționați către o adresă URL a serverului. Aplicația Office este înregistrată prin intermediul serviciilor de colaborare și de înregistrare a aplicațiilor. Documentația oficială ownCloud WOPI listează Collabora ca o aplicație Office acceptată, în timp ce documentația serviciului de colaborare explică serviciul și setările necesare.

Începând cu octombrie 2026, versiunile oficiale GitHub ale ownCloud includ Infinite Scale 8.2.0, lansată pe 10 august 2026. Exemplul de implementare al proiectului poate evolua independent, așadar folosiți o etichetă de producție testată, în loc să presupuneți că o imagine continuă este potrivită. Exemplul oficial de implementare completă oCIS recomandă în prezent eticheta Collabora CODE 26.04.3.1.1în fișierul său de mediu. Verificați versiunile oficiale Infinite Scale și fișierul oficial de mediu al exemplului de implementare înainte de a fixa versiunile.

În primul rând, înțelegeți cele trei puncte finale

O integrare de producție implică în mod normal trei puncte finale logice:

Verificat: COLLABORATION_APP_ADDR este adresa URL Collabora și COLLABORATION_WOPI_SRCidentifică sursa WOPI utilizată de aplicația Office. Dependent de mediu: sursa WOPI nu trebuie să fie un nume de gazdă public separat atunci când Collabora și serviciul de colaborare partajează o rețea de containere de încredere. Exemplul oficial Compose actual folosește http://collaboration:9300intern. O implementare separată poate necesita un nume de gazdă WOPI HTTPS rutat.

Acțiune utilă: decideți topologia înainte de a copia valorile de configurare. Dacă toate componentele rulează într-o stivă oficială Compose, începeți de la acel exemplu. Dacă Collabora se află pe o altă gazdă sau cluster Kubernetes, documentați ce nume DNS poate rezolva și accesa fiecare parte.

Etapa 1: Verificarea DNS, HTTPS și Collabora Discovery

Înainte de a atinge configurația oCIS, asigurați-vă că numele ownCloud și Collabora se rezolvă corect și că Collabora își expune endpoint-ul de descoperire. Collabora publică capabilitățile WOPI prin /hosting/discovery. O verificare de bază este:

dig +short cloud.example.com
dig +short office.example.com

curl -fsS https://office.example.com/hosting/discovery | head

Ar trebui să primiți XML de la punctul final de descoperire. Dacă TLS se termină la un proxy invers, confirmați că certificatul prezentat office.example.comeste valid din perspectiva gazdei oCIS sau a rețelei de containere.

Legendă: Verificați rezoluția numelui și /hosting/discoveryendpoint-ul Collabora înainte de a depana înregistrarea WOPI în Infinite Scale.

Neînțelegere frecventă: afișarea unei pagini de destinație Collabora într-un browser nu dovedește că integrarea WOPI funcționează. Dovedește că endpoint-ul web este accesibil. Serviciul de colaborare trebuie să ajungă și la Collabora, iar Collabora trebuie să poată ajunge la sursa WOPI.

Acțiune utilă: rulați teste de conectivitate din același spațiu de nume de rețea ca și serviciul relevant - de exemplu, din interiorul containerului de colaborare atunci când utilizați Docker.

Etapa 2: Configurați serviciul de colaborare la scară infinită

Serviciul de colaborare nu este pornit automat de o ocis serverconfigurare generică în mod supravegheat. Documentația ownCloud precizează că trebuie pornit explicit, deoarece administratorii pot rula mai multe instanțe de servicii de colaborare pentru diferite produse office.

Setările importante pentru Collabora sunt:

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.com

Sursa WOPI exactă de mai sus corespunde topologiei utilizate de exemplul oficial Compose actual: Collabora și serviciul de colaborare partajează aceeași rețea Docker. Dacă serverul Collabora este extern, înlocuiți adresa URL internă cu adresa pe care Collabora o poate accesa.

Serviciul depinde, de asemenea, de infrastructura gateway-ului și a furnizorului de aplicații Infinite Scale. Într-o implementare split-container, documentația ownCloud avertizează în mod specific că configurația oCIS trebuie partajată cu containerul de colaborare, deoarece secretele generate sunt necesare pentru toate serviciile. Consultați definiția oficială actuală Collabora Compose .

Legendă: Un proces de colaborare a serviciilor ar trebui să înceapă cu adresa Collabora și sursa WOPI dorite; utilizați jurnale de servicii reale pentru a confirma valorile din implementare.

Acțiune utilă: dacă ați construit implementarea manual, comparați mediul cu cel oficial collabora.ymlîn loc să copiați setările dintr-un tutorial vechi cs3org/wopiserver.

Etapa 3: Configurați Collabora pentru gazda WOPI și încorporarea în browser

Collabora trebuie să aibă încredere în gazda WOPI și să i se permită randarea în pagina web ownCloud. Exemplul oficial oCIS Compose transmite opțiuni Collabora care termină TLS la proxy-ul invers și setează net.frame_ancestorsdomeniul oCIS. De asemenea, generează o cheie de probă WOPI înainte de a porni Collabora.

În exemplul oficial, valorile relevante din partea Collabora includ:

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.com

Indicatoarele SSL exacte depind de locul unde se termină TLS. Aranjamentul recomandat pentru acces la internet este HTTPS cu verificarea certificatelor activată. INSECURE=trueOpțiunea din exemplu există pentru configurările locale care utilizează certificate autosemnate; ghidul de implementare ownCloud le spune în mod explicit administratorilor să o elimine sau să o seteze la fals pentru serverele publice.

Legendă: Un punct final Collabora accesibil este o condiție prealabilă; implementările de producție ar trebui să îl expună prin HTTPS cu un certificat în care celelalte componente au încredere.

Acțiune utilă: dacă încărcarea documentului produce o eroare iframe sau CSP goală, verificați instrumentele pentru dezvoltatori de browser și anteturile reverse-proxy. Nu dezactivați verificarea certificatelor sau restricțiile de securitate a conținutului în general doar pentru a face pagina să se încarce.

Etapa 4: Tipuri de fișiere la Oficiul de Registru și editare de test

Serviciul de registry al aplicațiilor Infinite Scale decide ce aplicație poate deschide fiecare tip MIME. Configurația sa poate defini tipul MIME, extensia, pictograma, aplicația implicită și dacă utilizatorii pot crea fișiere noi de acel tip. Documentația oficială App Registry descrie aceste câmpuri.

Un detaliu cheie este că numele aplicației utilizat de registru trebuie să corespundă furnizorului de colaborare pe care l-ați înregistrat efectiv. Exemplele oficiale actuale de implementare Collabora utilizează „ CollaboraOnlineas” COLLABORATION_APP_NAMEși Collabora„ca nume de produs”. Nu amestecați nume copiate din exemple mai vechi fără a verifica versiunea de implementare.

După pornire, conectați-vă la ownCloud Web și deschideți un document Office compatibil. Un flux de lucru reușit arată astfel:

• ownCloud Web selectează aplicația sediului social pentru tipul MIME al documentului.
• Serviciul de colaborare creează informațiile de lansare WOPI.
• Collabora se încarcă în browser și solicită fișierul prin WOPI.
• Modificările sunt rescrise în Infinite Scale prin aceeași integrare.

Legendă: Testul final constă în deschiderea unui document Office real din ownCloud Web, editarea acestuia în Collabora, închiderea acestuia și confirmarea faptului că versiunea salvată este din nou vizibilă în Infinite Scale.

Acțiune utilă: faceți o mică modificare la un document de test detașabil, închideți editorul, redeschideți fișierul și verificați dacă modificarea a persistat. O pagină care doar încarcă editorul nu este un test complet al căii de scriere.

Folosește exemplul oficial Compose atunci când nu ai nevoie de o topologie personalizată

Pentru o implementare Docker convențională, calea cu cel mai mic risc este ocis_fullexemplul întreținut de ownCloud. Aceasta include Infinite Scale, serviciul de colaborare, Collabora și Traefik. Ghidul oficial precizează că implementarea necesită domenii pentru oCIS și Collabora și documentează componenta WOPI ca parte a stivei. Consultați ghidul oficial complet de implementare .

Un fișier tipic de mediu orientat spre producție include valori conceptuale precum:

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=false

Apoi începeți stiva cu:

docker compose pull
docker compose up -d
docker compose ps

Verificat: exemplul oficial actual de reverse proxy permite bare oblice codificate, semne de întrebare și caractere procentuale pe punctul de intrare HTTPS, deoarece colaborarea/Collabora le necesită. Depinde de mediu: dacă utilizați Nginx, HAProxy, un controler de intrare sau un echilibrator de încărcare în cloud în loc de Traefik, trebuie să reproduceți gestionarea URL-urilor, comportamentul WebSocket/proxy, certificatele și timeout-urile necesare în platforma respectivă.

Acțiune utilă: nu traduceți etichetele Traefik literalmente într-un alt proxy. Folosiți-le pentru a înțelege cerințele de rutare, apoi implementați aceste cerințe folosind sintaxa documentată a proxy-ului.

Referință de depanare

Ce se știe, ce depinde de implementarea dvs. și ce presupuneri trebuie evitate

Cunoscut: Infinite Scale acceptă Collabora prin WOPI, serviciul de colaborare încorporat este puntea actuală, iar implementarea completă oficială oferă o arhitectură de referință funcțională.

Depinde de mediul dvs.: dacă punctul final WOPI este o adresă URL internă a containerului sau un nume de gazdă public, unde se termină TLS, ce proxy utilizați și dacă Collabora rulează în aceeași rețea ca oCIS.

Nu presupuneți: instrucțiunile pentru ownCloud Classic se aplică și la Infinite Scale. Documentația Classic care vă spune să instalați o aplicație Collabora/richdocuments sau să o configurați prin intermediul interfeței de administrare a Classic descrie o arhitectură diferită a produsului.

Prin urmare, cel mai fiabil flux de lucru pentru integrare este: pornirea de la modelul oficial de implementare Infinite Scale, demonstrarea accesibilității rețelei și TLS, configurarea serviciului de colaborare, confirmarea încrederilor Collabora și posibilitatea de a accesa gazda WOPI, înregistrarea tipurilor MIME relevante și, în final, testarea atât a deschiderii, cât și a salvării unui document real.