Conectarea Nextcloud la CODE Docker: Configurare și compromisuri

Conectați Nextcloud la CODE-ul Collabora rulând collabora/codeimaginea oficială, restricționați portul acesteia către gazdă, direcționați un subdomeniu HTTPS office printr-un proxy invers compatibil cu WebSocket și setați adresa URL publică respectivă în integrarea Collabora a Nextcloud. Zece minute sunt plauzibile doar dacă Docker, DNS, TLS și proxy-ul sunt gata.

Alegeți mai întâi serviciul de birou potrivit. Începând cu octombrie 2026, Nextcloud distinge Nextcloud Office, bazat pe Euro-Office, de Collabora Online. CODE este Collabora Online Development Edition, așadar folosiți integrarea Collabora, nu conectorul Euro-Office. Aplicația CODE încorporată este cea mai rapidă pentru uz personal, dar Nextcloud o descrie ca fiind mai lentă și lipsită de scalabilitate avansată. Un container separat este mai ușor de gestionat independent, dar adaugă proxy și lucrări de actualizare. CODE este potrivit pentru utilizarea acasă și testare; alegeți o implementare Collabora Online acceptată atunci când o afacere are nevoie de asistență pentru producție.

Înainte de a începe: traseul de zece minute

Trebuie să aveți o adresă HTTPS Nextcloud funcțională, un nume de gazdă separat pentru birou cu TLS valid și acces Docker pe gazda CODE. Indicați numele de gazdă al biroului către un proxy invers care poate ruta către container. Atât browserele utilizatorilor, cât și serverul Nextcloud trebuie să ajungă la adresa URL a biroului.

Dacă DNS sau TLS nu este gata, nu expuneți public portul 9980 ca scurtătură. Legați-l la loopback și terminați mai întâi proxy-ul.

1. Porniți containerul CODE Docker

Înlocuiți numele de gazdă Nextcloud eșantion cu originea HTTPS exactă pe care utilizatorii o folosesc pentru a se conecta. Setarea aliasgroup1restricționează ce gazdă WOPI (serviciul de fișiere care furnizează documente editorului) se poate conecta. Nu utilizați un wildcard doar pentru a face să dispară o conexiune eșuată.

docker pull collabora/code

docker run -t -d --name collabora-code -p 127.0.0.1:9980:9980 -e 'aliasgroup1=https://cloud.example.com:443' --restart unless-stopped --cap-add MKNOD collabora/code

Legarea la 127.0.0.1menține portul privat în timp ce un proxy de pe aceeași gazdă îl poate accesa. Dacă proxy-ul dvs. este în altă parte, permiteți doar acelui proxy de încredere să se conecteze la portul 9980.

Verificați dacă containerul a pornit și dacă endpoint-ul său de descoperire răspunde local:

docker ps --filter name=collabora-code
docker logs --tail=50 collabora-code
curl -kfsS -o /dev/null -w 'Discovery HTTP %{http_code}\n' https://127.0.0.1:9980/hosting/discovery

-kocolește validarea certificatului doar pentru această verificare locală autosemnată; nu remediază un certificat public invalid.

2. Puneți numele de gazdă al biroului public după HTTPS

Serviți https://office.example.comde la proxy-ul invers cu un certificat valid și direcționați cererile către CODE. Îndrumările proxy de la Collabora acoperă resursele editorului, descoperirea/capacitățile /cool/și redirecționarea WebSocket. Fără actualizări WebSocket, pagina se poate încărca în timp ce editorul eșuează.

Folosește configurația întreținută pentru software-ul tău proxy. Dacă acesta termină TLS înainte de CODE, urmează setările TLS documentate pentru backend; nu dezactivează verificările certificatelor la nivel global.

3. Conectați integrarea Collabora în Nextcloud

În Nextcloud, activați sau instalați aplicația de integrare Collabora disponibilă pentru versiunea dvs. Apoi, deschideți zona de administrare pentru Office și introduceți adresa URL publică Collabora https://office.example.com. Manualele actuale etichetează setarea „Server Collabora Online”; textul și etichetele aplicației pot varia în funcție de versiune, mai ales că Nextcloud adaugă opțiunea Euro-Office. Selectați Collabora Online pentru acest server CODE. Nu introduceți adresa exclusivă pentru container https://127.0.0.1:9980decât dacă Nextcloud rulează pe aceeași gazdă și acea adresă este, de asemenea, punctul final configurat al serviciului; în configurația proxy recomandată, utilizați numele de gazdă public office.

Salvați setarea și rulați verificarea conexiunii încorporată dacă versiunea dvs. afișează una. Dacă eșuează, comparați originea exactă Nextcloud în aliasgroup1, confirmați că atât Nextcloud, cât și browserul pot rezolva și ajunge la numele de gazdă al biroului și inspectați jurnalele de proxy invers pentru căi refuzate sau erori WebSocket.

4. Verificați editarea, apoi alegeți dacă CODUL se potrivește

Deschideți un mic document de test în Nextcloud și confirmați că se deschide în editorul browserului, acceptă o modificare, salvează și se redeschide cu modificarea intactă. Testați atât dintr-un cont de utilizator normal, cât și dintr-un cont de administrator. O verificare funcțională a descoperirii confirmă singură că CODE răspunde; nu dovedește că autorizarea WOPI, proxy WebSockets și operațiunile de salvare a documentelor funcționează toate.

Pentru un server personal sau o echipă mică, CODE Docker separă editorul de stiva PHP a Nextcloud. De asemenea, dețineți proxy-ul, repornirile, verificările de compatibilitate și actualizările de imagini. Aplicația CODE încorporată este mai simplă, dar partajează gazda și are mai puține funcții de scalabilitate. Pentru o organizație care depinde de editarea zilnică, evaluați un serviciu Collabora Online acceptat în loc să tratați CODE ca o garanție de producție.

Când sunteți gata să actualizați CODE, extrageți noua imagine și recreați containerul cu aceleași opțiuni. Consultați notele de lansare și testați deschiderea și salvarea documentului înainte de a actualiza un serviciu pe care se bazează utilizatorii; eticheta latestse poate muta. Fixați o anumită versiune de imagine atunci când implementările repetabile sunt importante.

Verificare

Configurarea funcționează atunci când numele de gazdă al biroului public prezintă un certificat valid, verificarea conexiunii Nextcloud are succes și un document de test se deschide, se salvează și se redeschide prin intermediul editorului. Dacă pagina de destinație a biroului se încarcă, dar editarea se blochează, verificați redirecționarea WebSocket. Dacă Nextcloud raportează că gazda nu este permisă, corectați-o aliasgroup1pentru a se potrivi cu originea reală a Nextcloud. Dacă CODE răspunde local, dar nu din browserele utilizatorilor, verificați DNS-ul public, rutarea firewall-ului și proxy-ul invers.

Referințe: Exemplu de instalare Docker în Nextcloud ; Opțiuni de instalare Nextcloud Office ; Configurarea Nextcloud Collabora ; Setări reverse-proxy Collabora ; detalii despre imaginea oficială CODE Docker ; Opțiuni Nextcloud Hub 26 Summer Office .