Conectează Collabora Online la ownCloud Infinite Scale

Folosește serviciul Collaboration al ownCloud Infinite Scale ca punte WOPI între interfața web și Collabora Online. Pentru o instalare nouă, cea mai sigură rută este ocis_fullexemplul oficial modular Docker Compose al ownCloud, care include Infinite Scale, Collaboration, Collabora și Traefik. Setează adresele URL publice Infinite Scale, Collabora și WOPI, folosește certificate TLS valide și păstrează consecvența tuturor secretelor de serviciu. Nu configura acest lucru ca și cum Infinite Scale ar fi serverul clasic ownCloud.

Această distincție este verificată în documentația actuală a ownCloud: Infinite Scale integrează suite de birou prin WOPI și serviciul său Collaboration. Acest serviciu înlocuiește cs3org/wopiserverul extern mai vechi în versiunile mai noi, așa că administratorii care actualizează o implementare mai veche trebuie să urmeze instrucțiunile de migrare pentru versiunea instalată.

1. Verificați cerințele preliminare pentru versiune și rețea

Confirmați versiunea exactă de Infinite Scale înainte de a instala orice. Documentația actuală de ownCloud listează serviciul Collaboration în documentația de dezvoltare 9.0 și precizează că trebuie pornit separat atunci când Infinite Scale rulează în mod supravegheat. Exemplul full-stack de ownCloud avertizează, de asemenea, că configurarea depinde de versiunile care conțin serviciul Collaboration și nu funcționează cu versiunile de producție 5.x. Folosiți documentația și fișierele Compose care corespund versiunii instalate; nu copiați un exemplu rulant într-un sistem de producție mai vechi fără a verifica compatibilitatea.

Pentru o implementare publică, planificați nume de gazdă separate, cum ar fi cloud.example.com, office.example.comși wopi.example.com. Browserul trebuie să ajungă la adresele URL din cloud și Collabora, în timp ce Collabora trebuie să poată ajunge la endpoint-ul WOPI expus de Infinite Scale. DNS, firewall-urile și încrederea TLS trebuie să funcționeze în ambele direcții. O gazdă accesibilă de pe laptop, dar nu și din containerul Collabora, nu este suficientă.

Exemplul de implementare ownCloud folosește Traefik ca proxy invers și așteaptă un SSL valid pentru configurarea unui server. Configurația sa locală de testare poate utiliza certificate autosemnate, dar instalările publice nu ar trebui să dezactiveze în mod silențios verificarea certificatelor. Decideți ce nume de gazdă și certificate veți utiliza înainte de a configura stiva.

2. Începeți de la exemplul Compose corespunzător al ownCloud

1. Deschideți ghidul oficial de implementare oCIS modular complet cu WebOffice de la ownCloud și directorul exemplu ocis_full corespunzător . Pentru producție, consultați o versiune sau o etichetă care se potrivește cu versiunea dvs. Infinite Scale, în loc să vă bazați pe ramura continuă a depozitului.
2. Examinați fișierul exemplului .env. Setați OCIS_DOMAIN, COLLABORA_DOMAIN, și WOPISERVER_DOMAINla numele de gazdă care se rezolvă la serverul dvs. Exemplul activează Collabora cu COLLABORA=:collabora.yml; păstrați această setare dacă Collabora este editorul de birou pe care doriți să îl utilizați.
3. Setați acreditări de administrator puternice și private și urmați instrucțiunile TLS de producție ale exemplului. Nu lăsați parolele exemple neschimbate. Dacă versiunea depozitului a modificat numele variabilelor de mediu sau aspectul fișierelor, utilizați fișierele din aceeași versiune etichetată, în loc să combinați instrucțiuni din versiuni diferite.
4. Verificați configurația Compose înainte de a o porni. Confirmați că serviciile Collabora, Collaboration, Infinite Scale și proxy partajează rețeaua și configurația dorite. Ghidul ownCloud avertizează că, dacă Collaboration rulează într-un container separat, configurația Infinite Scale relevantă și secretele generate trebuie partajate cu celelalte servicii.

Exemplul de implementare este o stivă integrată, nu o configurație universală pentru fiecare instalare existentă. Dacă deja rulați Infinite Scale cu systemd, Kubernetes sau un proxy invers personalizat, păstrați acel model de implementare și configurați serviciul Collaboration și App Registry folosind documentația pentru versiunea respectivă, în loc să lansați o a doua stivă completă.

3. Conectați colaborarea la Collabora cu WOPI

Setările de bază identifică adresa URL a editorului și sursa WOPI accesibilă extern. În documentația actuală a serviciului, COLLABORATION_APP_NAMEeste numele afișat al aplicației, COLLABORATION_APP_PRODUCTidentifică produsul, COLLABORATION_APP_ADDRindică Collabora și COLLABORATION_WOPI_SRCeste adresa URL pe care Collabora o folosește pentru a citi și scrie fișiere prin Infinite Scale. O configurație conceptuală arată astfel:

COLLABORATION_APP_NAME=CollaboraOnline
COLLABORATION_APP_PRODUCT=Collabora
COLLABORATION_APP_ADDR=https://office.example.com
COLLABORATION_WOPI_SRC=https://wopi.example.com

Folosiți adresele URL publice reale și formatul variabilei necesare implementării. Dacă serviciile comunică într-o rețea internă de containere, adresa internă poate fi potrivită pentru o setare, în timp ce adresa URL orientată spre browser aparține altei setări. Nu înlocuiți un nume de gazdă exclusiv pentru container cu o valoare pe care Collabora trebuie să o rezolve extern.

Serviciul Collaboration necesită, de asemenea, valorile de execuție Infinite Scale OCIS_URL, OCIS_JWT_SECRET, OCIS_REVA_GATEWAY, și MICRO_REGISTRY_ADDRESS. Acestea trebuie să corespundă cu instanța care rulează; exemplul oficial full-stack furnizează relații de servicii pentru propria rețea Compose. Nu inventați secrete noi pentru un singur serviciu și nu dezactivați verificările cheii de probă WOPI pentru a ocoli o nepotrivire. Păstrați verificarea certificatului activată pentru certificatele publice de încredere; COLLABORATION_APP_INSECUREeste documentat doar ca o opțiune pentru un certificat de aplicație WOPI autosemnat, nu ca o soluție generală de producție.

Registrul aplicațiilor controlează ce aplicație Office apare pentru fiecare tip MIME și ce aplicație se deschide în mod implicit. Dacă Collabora rulează, dar documentele nu afișează o opțiune de deschidere cu, verificați configurația tipului MIME al registrului și default_appvaloarea acestuia. Numele utilizat acolo trebuie să corespundă cu numele aplicației Office configurate. ownCloud documentează acest lucru ca configurație YAML; variabilele de mediu nu înlocuiesc maparea tipului MIME.

4. Porniți, testați și diagnosticați integrarea

Cu exemplul oficial Compose, validați configurația randată și apoi porniți stiva din directorul său de implementare:

docker compose config
docker compose up -d

Dacă nu utilizați exemplul Compose, porniți mai întâi serviciile gateway, App Provider și Collabora. În modul supravegheat, ownCloud documentează pornirea explicită a serviciului Collaboration cu ocis collaboration server; acesta nu pornește automat. Asigurați-vă că variabilele de mediu necesare sunt populate în procesul serviciului Collaboration înainte de a-l porni.

1. Deschideți https://office.example.com/hosting/discoveryîntr-un browser. Un punct final accesibil ar trebui să returneze codul XML de descoperire Collabora, în loc de o eroare DNS, TLS sau proxy.
2. Conectați-vă la Infinite Scale, deschideți un document acceptat și alegeți Collabora dacă interfața cu utilizatorul oferă mai multe aplicații Office. Testați atât un fișier existent, cât și, dacă este activat în App Registry, creați un document nou.
3. Faceți o mică modificare, așteptați ca indicatorul de salvare să se stabilizeze, închideți editorul și redeschideți fișierul pentru a confirma că modificarea a persistat.
4. Dacă editorul nu se deschide, verificați jurnalele Infinite Scale Collaboration și App Provider, jurnalele Collabora și jurnalele reverse-proxy cu aceeași marcă temporală. „Gazdă WOPI neautorizată” indică configurația de încredere WOPI a Collabora; o eroare de apel invers eșuată sau TLS indică accesibilitatea URL-ului sau încrederea în certificat; o opțiune de aplicație lipsă indică App Registry.

Integrarea reușită înseamnă că browserul încarcă editorul, conexiunea WOPI atinge Infinite Scale, iar editările persistă după redeschidere. Numele exacte ale containerelor, conexiunile URL și locațiile fișierelor de configurare depind de versiunea Infinite Scale și de metoda de implementare. Folosiți documentația ownCloud corespunzătoare versiunii pentru aceste detalii, în special atunci când migrați de pe serverul WOPI extern existent.

Referințe: configurația serviciului ownCloud Collaboration , configurația ownCloud App Registry și note de lansare și note de migrare Infinite Scale .