Cum se instalează codul Collabora Online cu Docker și Nextcloud

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.

Lasă un comentariu

Importul și exportul Office Outlook 2010: Mutarea datelor cu un fișier PST

Importul și exportul Office Outlook 2010: Mutarea datelor cu un fișier PST

Aflați cum să importați un fișier PST în Outlook 2010 sau să exportați e-mailuri, contacte, calendar și activități. Urmați meniurile corecte și evitați folderele lipsă sau duplicatele.

Modificarea înălțimii și lățimii grilei în Word 2010

Modificarea înălțimii și lățimii grilei în Word 2010

Aflați cum să ajustați înălțimea și lățimea grilei în Word 2010, să modificați frecvența liniilor vizibile și să setați spațierea orizontală și verticală subiacentă a grilei de desen.

Recuperarea unei parole Outlook PST cu Nucleus Kernel

Recuperarea unei parole Outlook PST cu Nucleus Kernel

Recuperează o parolă Outlook PST uitată cu pașii actuali ai Kernel, inclusiv cum să identifici fișierul corect, să faci o copie de rezervă și să verifici limitele instrumentului.

Cum se inserează o pagină web live într-un diapozitiv PowerPoint

Cum se inserează o pagină web live într-un diapozitiv PowerPoint

Utilizați programul de completare LiveWeb pentru a plasa un site web pe un diapozitiv PowerPoint, a seta dimensiunea și comportamentul de reîmprospătare și a verifica compatibilitatea înainte de prezentare.

Adăugați sărbători naționale în calendarul Outlook

Adăugați sărbători naționale în calendarul Outlook

Adăugați sărbători specifice fiecărei țări în noul Outlook, Outlook pe web sau Outlook clasic. Aflați cum să evitați evenimentele duplicate și să verificați dacă lipsesc datele din perioada 2026-2027.

Access 2010: Exportul unui tabel de bază de date în Excel 2010

Access 2010: Exportul unui tabel de bază de date în Excel 2010

Exportați un tabel Access 2010 în Excel 2010, alegeți dacă doriți să includeți formatarea, salvați pașii de export reutilizabili și verificați problemele comune legate de transferul de date.

Șabloane Microsoft Word 2010: Găsiți-le, utilizați-le și creați-le

Șabloane Microsoft Word 2010: Găsiți-le, utilizați-le și creați-le

Găsiți șabloane Word 2010 încorporate, începeți un document dintr-un fișier .dotx descărcat și salvați un șablon personalizat reutilizabil fără a suprascrie lucrarea.

Cum să organizezi o prezentare PowerPoint 2010 cu secțiuni

Cum să organizezi o prezentare PowerPoint 2010 cu secțiuni

Utilizați secțiunile PowerPoint 2010 pentru a grupa diapozitive corelate, a redenumi și a rearanja grupuri și a naviga printr-un pachet lung de diapozitive fără a modifica conținutul diapozitivelor.

Cum să eliminați metadatele și conținutul ascunse dintr-un document Word

Cum să eliminați metadatele și conținutul ascunse dintr-un document Word

Folosește Inspectorul de documente din Word pentru a revizui detaliile autorului, comentariile, modificările urmărite, textul ascuns și alte date înainte de partajare și pentru a afla ce poate omite scanarea.

Setări de export și import pentru panglică și bara de instrumente cu acces rapid în Office 2010

Setări de export și import pentru panglică și bara de instrumente cu acces rapid în Office 2010

Mutați filele personalizate din panglică și comenzile din bara de instrumente Acces rapid în Office 2010 cu un fișier .exportedUI și protejați setările deja existente pe PC-ul de destinație.