Exemplu ilustrativ: Imaginați-vă o echipă mică ale cărei fișiere Nextcloud sunt găzduite la https://cloud.example.com. Administratorul acesteia dorește un server separat Collabora Online Development Edition (CODE) la https://office.example.com. Aceasta este o configurație ipotetică pentru explicarea pașilor, nu un raport al unei instalări reale. Înlocuiți ambele nume de gazdă exemplu cu domenii pe care le controlați.
CODE rulează ca un serviciu separat, alături de Nextcloud. Docker pornește serviciul Collabora; un proxy invers TLS îl publică; iar integrarea Nextcloud Office conectează cele două. Browserul dvs. trebuie să poată accesa adresa URL publică a biroului, iar serverele trebuie să poată accesa endpoint-urile Nextcloud și Collabora relevante. Manualul actual de instalare Nextcloud Office descrie Docker ca o opțiune de implementare și menționează că un server dedicat are nevoie, de obicei, de un proxy invers.
Înainte de a începe
De exemplu, să presupunem că o gazdă Linux poate rula Docker, Nextcloud funcționează deja prin HTTPS și înregistrările DNS pentru ambele nume de gazdă indică serverele corecte. Obțineți un certificat TLS valid pentru office.example.com. Planificați să expuneți serviciul Collabora prin intermediul acelui nume de gazdă, în loc să deschideți portul său Docker direct către internetul public.
- Confirmați că gazda CODE poate rezolva și se poate conecta la
cloud.example.com.
- Confirmați că browserele pot accesa
https://office.example.comHTTPS.
- Alegeți dacă proxy-ul invers rulează pe gazda Docker sau în altă parte. Un proxy de pe aceeași gazdă poate utiliza un port de container publicat prin loopback; un proxy dintr-un alt container are nevoie de o rețea Docker partajată accesibilă sau de o altă rută privată.
- Verificați documentația actuală CODE și Nextcloud pentru compatibilitate și cerințe de proxy înainte de utilizarea în producție. CODE este ediția de dezvoltare; echipele care au nevoie de stabilitate sau asistență susținută de furnizor ar trebui să evalueze o ofertă Collabora Online acceptată.
Comenzile de mai jos folosesc collabora/codenumele oficial al imaginii și o singură origine Nextcloud. Exemplele nu fixează o etichetă de lansare, așadar un administrator ar trebui să decidă asupra unei politici de versiune și actualizare, în loc să o trateze latestca pe o strategie de control al modificărilor în producție.
1. Indică numele de gazdă al biroului către serverul tău
Creați o înregistrare DNS A sau AAAA care office.example.comindică gazda sau echilibratorul de încărcare care deservește Collabora. Configurați proxy-ul invers pentru a termina HTTPS cu un certificat valid pentru acel nume și a redirecționa căile aplicației Collabora și traficul WebSocket către containerul CODE. Documentația oficială de proxy invers a Collabora oferă exemple specifice proxy-ului; utilizați secțiunea pentru software-ul proxy real și versiunea curentă de CODE.
Nu copiați orbește un fragment generic de proxy. Proxy-ul trebuie să accepte actualizări WebSocket, să păstreze informațiile necesare despre gazdă și protocolul de redirecționare și să transmită rute Collabora precum /browser, /hosting/discovery, și /cool. Directivele exacte diferă între Apache, NGINX, Traefik și alte gateway-uri. Dacă proxy-ul rulează pe gazda Docker, redirecționarea către 127.0.0.1:9980este o țintă privată comună. Dacă este un container separat, acea adresă de loopback se referă la containerul proxy în sine, nu la gazda CODE.
2. Porniți containerul CODE Docker
Pe gazda Docker, trageți și porniți containerul. În acest exemplu, portul este legat la loopback, deci nu este expus direct pe fiecare interfață de rețea a gazdei:
docker pull collabora/code
docker run -d --name collabora -p 127.0.0.1:9980:9980 -e 'aliasgroup1=https://cloud.example.com:443' --restart always --cap-add MKNOD collabora/code
Valoarea aliasgroup1autorizează originea Nextcloud care se așteaptă să utilizeze acest serviciu CODE. Păstrați schema și numele de gazdă aliniate cu URL-ul folosit de utilizatori pentru a accesa Nextcloud; includeți un port diferit de cel implicit dacă serviciul public Nextcloud utilizează unul. Dacă mai multe instanțe Nextcloud vor utiliza serviciul, configurați grupurile de gazde suplimentare permise conform documentației actuale a imaginii CODE, în loc să permiteți în general gazde arbitrare.
Această comandă presupune că proxy-ul invers se află pe aceeași mașină și redirecționează către portul loopback. Dacă utilizați Docker Compose, un proxy containerizat sau un proxy la distanță, ajustați în mod deliberat rețeaua și expunerea porturilor. Evitați expunerea publică a portului 9980 doar pentru a face o conexiune proxy să funcționeze; utilizați o rețea Docker privată, o regulă de firewall sau o altă cale restricționată. Pentru opțiunile actuale ale imaginii CODE Docker, consultați ghidul CODE Docker de la Collabora .
3. Configurați proxy-ul invers și verificați CODUL
După ce proxy-ul este configurat, reîncărcați-l folosind metoda corespunzătoare software-ului dvs. și verificați configurația acestuia înainte de a aplica modificările. Apoi, solicitați endpoint-ul public de descoperire de la o mașină care poate ajunge la domeniu:
curl -fsS https://office.example.com/hosting/discovery | head
Un răspuns reușit ar trebui să conțină informații despre descoperirea XML, nu o pagină de eroare proxy. Această verificare confirmă faptul că adresa URL publică ajunge la un punct final Collabora; nu dovedește că autorizarea Nextcloud, WebSockets sau editarea documentelor funcționează deja. De asemenea, inspectați containerul dacă punctul final eșuează:
docker ps --filter name=collabora
docker logs --tail=100 collabora
În configurația ipotetică, o conexiune refuzată la adresa URL publică indică mai întâi rutarea DNS, TLS, firewall sau proxy. Un răspuns 502 înseamnă de obicei că proxy-ul nu poate ajunge la ruta în amonte configurată a containerului. Dacă descoperirea funcționează, dar editorul eșuează ulterior în timpul încărcării, verificați redirecționarea WebSocket și dacă proxy-ul raportează o eroare de actualizare sau de rutare în amonte.
4. Conectați Nextcloud la Collabora
În Nextcloud, deschideți zona Aplicații și instalați sau activați integrarea Office oferită pentru versiunea dvs. Eticheta aplicației poate fi „Nextcloud Office” sau „Collabora Online”, în funcție de versiune și de catalogul de aplicații instalate. Apoi, deschideți setările de administrare pentru Office și introduceți:
https://office.example.com
Salvați setarea și verificați starea conexiunii. Documentația de configurare Office a Nextcloud identifică acest câmp ca fiind adresa URL și portul serverului Collabora și recomandă HTTPS. Folosiți adresa URL publică Collabora pe care browserele o pot accesa. În instalările split-DNS, NAT sau cu rețea segmentată, Nextcloud poate necesita și o rută internă către serviciul respectiv; consultați opțiunile avansate de conectare pentru versiunea aplicației instalate, în loc să presupuneți că DNS-ul public funcționează de pe server.
De exemplu, Nextcloud vede cloud.example.comca gazdă WOPI permisă, iar browserele utilizatorilor deschid editorul din office.example.com. Dacă pagina de administrare Nextcloud oferă o listă de solicitări WOPI permise, restricționați-o la adresele serverului Collabora așteptate după confirmarea adreselor corecte din rețea. Nextcloud recomandă limitarea solicitărilor WOPI la gazdele Collabora așteptate; nu adăugați intervale largi fără un motiv specific de rețea.
5. Testați cu un document exemplu
Conectați-vă ca utilizator Nextcloud obișnuit, creați un document text mic sau deschideți un fișier de test de unică folosință și alegeți editorul browserului. Confirmați că se încarcă bara de instrumente a editorului, faceți o modificare inofensivă, așteptați indicatorul de salvare, închideți fișierul și redeschideți-l pentru a verifica dacă modificarea a persistat. Dacă instalarea acceptă editarea simultană, deschideți același fișier de test într-o a doua sesiune de utilizator și confirmați că prezența sau modificările se actualizează conform așteptărilor.
Aceste verificări separă straturile principale: cererea de descoperire testează rutarea publică; starea Nextcloud testează conexiunea configurată la server; deschiderea editorului testează accesul browserului și schimbul WOPI; iar redeschiderea fișierului testează calea de salvare. Nu utilizați un document important pentru primul test. CODE este o ediție de dezvoltare, deci un test reușit nu înlocuiește evaluarea disponibilității, capacității resurselor, copiilor de rezervă și nevoilor de asistență pentru organizația dvs.
Probleme frecvente și ce trebuie verificat
Nextcloud raportează că serverul este inaccesibil
Verificați adresa URL Office pentru greșeli de scriere, un lanț de certificate valid și o schemă HTTPS potrivită. Testați adresa URL de descoperire atât dintr-un browser, cât și din gazda Nextcloud. Dacă DNS-ul public se rezolvă diferit în rețeaua serverului, configurați o rută internă adecvată sau utilizați setările avansate ale adresei URL a serverului acceptate de conectorul dvs.
Pagina se deschide, dar editorul de documente se blochează
Verificați jurnalele de acces și erori ale proxy-ului invers pentru a identifica erori de actualizare WebSocket. Confirmați că proxy-ul redirecționează rutele Collabora curente și menține deschise conexiunile WebSocket de lungă durată. Instrumentele pentru dezvoltatorii de browser pot afișa dacă solicitarea WebSocket este respinsă, redirecționată către HTTP sau blocată de o eroare de certificat.
Collabora respinge gazda Nextcloud
Comparați originea reală Nextcloud, inclusiv schema, numele de gazdă și portul, cu grupul de alias configurat. O nepotrivire între o adresă URL publică, un nume de gazdă intern și o rescriere a proxy-ului poate cauza erori de autorizare a gazdei sau WOPI. Adăugați doar numele de gazdă Nextcloud dorit la configurația permisă.
CODUL pornește și apoi se închide sau devine nefuncțional
Verificați docker logs collabora, disc și memorie disponibile, permisiunile containerului și cerințele de execuție pentru eticheta de imagine implementată. Evitați copierea semnalizărilor precum modul privilegiat din exemple fără legătură, cu excepția cazului în care instrucțiunile oficiale actuale pentru mediul dvs. le solicită.
Actualizări și îngrijire operațională
Mențineți imaginea containerului actualizată pentru securitate și compatibilitate, dar programați și testați actualizările în loc să extrageți o imagine nouă nerevizuită în timpul programului de lucru. Înregistrați versiunea pe care o utilizați, citiți notele de lansare relevante și păstrați o cale de revenire la versiunea inițială. Revizuiți configurația proxy după modificări majore ale Collabora sau Nextcloud, deoarece cerințele endpoint-ului și WebSocket pot evolua. De asemenea, monitorizați memoria, procesorul, spațiul de stocare și jurnalele containerului gazdei pe măsură ce crește numărul de editori activi.
Pentru echipa ipotetică, instalarea este gata pentru utilizare limitată doar după ce endpoint-ul de descoperire răspunde, Nextcloud raportează o conexiune, documentul exemplu se deschide într-un browser și o editare salvată rămâne după redeschidere. Dacă una dintre aceste verificări eșuează, depanați stratul respectiv înainte de a invita utilizatorii să depindă de serviciu.
Referințe oficiale
Documentația a fost revizuită pe 6 octombrie 2026. Manualul stabil al Nextcloud era etichetat ca versiunea 35 la verificare; ghidul Docker din link este versiunea 28, așa că folosiți-l ca exemplu de instalare și verificați sintaxa proxy în raport cu ghidul Collabora și versiunile pe care le rulați efectiv.