Cum să creați copii de rezervă și să restaurați în siguranță fișierele de configurare CODE Collabora

Versiunea 26.04.4.2 a Collabora Online Development Edition (CODE) a fost lansată pe 24 septembrie 2026. Acest lucru este important pentru planificarea copiilor de rezervă, deoarece linia de lansare 26.04 a modificat și părți din gestionarea recomandată a căii de proxy invers pentru adresele URL WebSocket mai noi. Dacă vă pregătiți pentru o actualizare, o migrare sau o recuperare în caz de dezastru, este posibil ca o copie de rezervă a unui singur fișier XML să nu fie suficientă pentru a reproduce o implementare funcțională.

Nucleul verificat este simplu: fișierul principal de configurare a serverului Collabora este /etc/coolwsd/coolwsd.xml, inclusiv în interiorul containerului oficial CODE. Documentația oficială Docker acceptă, de asemenea, copierea acelui fișier dintr-un container, copierea lui înapoi sau montarea lui prin bind-mount de pe gazdă. Părțile care variază sunt tot ce îl înconjoară: variabile de mediu Docker, monturi de bind-uri, chei de probă WOPI, terminarea TLS și configurarea reverse-proxy.

Acest ghid prezintă un proces conservator de backup și restaurare atât pentru instalările native de pachete, cât și pentru implementările Docker. Separă în mod intenționat ceea ce este confirmat de documentația Collabora de ceea ce depinde de propria implementare.

Ce ar trebui să includă o copie de rezervă Collabora CODE?

Verificat: /etc/coolwsd/coolwsd.xml este fișierul de configurare principal Collabora Online. Collabora documentează direct această cale și descrie fișierul ca fiind auto-documentat pentru opțiunile disponibile ale serverului. Consultați manualul oficial al SDK-ului Collabora Online .

Dependent de implementare: o recuperare completă poate necesita și configurația utilizată pentru lansarea serviciului. Pentru Docker, aceasta poate include Compose YAML, variabile de mediu, monturi de legături, secrete și fișiere montate de pe gazdă. Pentru o instalare nativă, poate include o gazdă virtuală reverse-proxy și certificate dacă acestea sunt gestionate pe același server.

Acțiune: înainte de a crea o arhivă, notați dacă instanța dvs. este o instalare nativă a unui pachet sau o implementare Docker/Compose. Nu presupuneți că aceeași procedură de restaurare se aplică ambelor.

Neînțelegeri frecvente înainte de a începe

Copierea de rezervă a fișierului coolwsd.xml nu creează copii de rezervă ale documentelor utilizatorului.

CODE este conectat în mod normal la o platformă de stocare prin WOPI. Documentele rămân sub controlul acelei platforme de stocare, cum ar fi Nextcloud sau o altă gazdă WOPI. Prin urmare, restaurarea configurației CODE nu restaurează documentele în sine.

Acțiune: creați o copie de rezervă a gazdei WOPI și a depozitului său de date utilizând propria procedură de copie de rezervă a produsului respectiv. Tratați această copie de rezervă CODE ca o copie de rezervă a configurării serviciului.

Un container Docker nu este o copie de rezervă

Un container poate fi recreat dintr-o imagine. Configurația transmisă cu variabile de mediu sau monturi bind poate fi în afara containerului, în timp ce modificările făcute doar în interiorul containerului pot dispărea atunci când acesta este înlocuit.

Acțiune: salvați definiția implementării și fișierele montate pe gazdă, nu doar sistemul de fișiere al containerului.

Copierea unui fișier coolwsd.xml vechi peste o versiune mai nouă nu este întotdeauna cea mai sigură restaurare.

Opțiunile de configurare se pot schimba între liniile de lansare CODE. Notele de lansare actuale ale Collabora arată modificările continue ale serverului și proxy-ului în seria 26.04, inclusiv recomandări actualizate de proxy pentru adresa URL compactă WebSocket. Consultați notele oficiale de lansare CODE 26.04 .

Acțiune: înregistrați versiunea CODE la fiecare copie de rezervă. Când restaurați la o versiune diferită, comparați fișierul salvat cu setările implicite ale noului pachet înainte de a-l înlocui complet.

Pasul 1: Înregistrați versiunea instalată și tipul de implementare

Începeți prin a înregistra suficiente informații pentru a reproduce mediul. Pentru o implementare de container, inspectați containerul care rulează și imaginea acestuia:

docker ps --filter name=collabora
docker inspect collabora --format '{{.Config.Image}}'
docker inspect collabora --format '{{json .Mounts}}'

Dacă containerul dvs. folosește un nume diferit, înlocuiți-l collaboraîn mod corespunzător. Imaginea oficială este publicată ca collabora/code; Docker Hub identifică în prezent imaginea 26.04.4.2 în cea mai recentă linie de lansare. Consultați imaginea oficială Collabora CODE pe Docker Hub .

Pentru o instalare nativă a unui pachet, înregistrați versiunea pachetului cu managerul de pachete pe care îl utilizați efectiv. De exemplu, pe Debian sau Ubuntu:

dpkg-query -W 'coolwsd*' 'collaboraoffice*' 2>/dev/null

Acțiune: salvați versiunea de ieșire în același director de rezervă protejat ca și arhiva de configurare.

Pasul 2: Faceți o copie de rezervă a metadatelor de configurare și implementare de bază

Instalare nativă a pachetului

Creați un director de rezervă doar pentru utilizatorul root și arhivați întregul /etc/coolwsddirector în loc să selectați doar fișierul XML principal. Aceasta păstrează orice fișiere suplimentare pe care pachetul instalat sau personalizarea locală le-a plasat acolo.

sudo install -d -m 700 /var/backups/collabora
sudo tar -C /etc -czpf \
  /var/backups/collabora/coolwsd-etc-$(date +%F).tar.gz \
  coolwsd

Această comandă se schimbă în mod deliberat la /etcînainte de arhivare, astfel încât arhiva să conțină o coolwsd/cale relativă în loc de o cale absolută către sistemul de fișiere.

Docker sau Docker Compose

Documentația Collabora precizează că imaginea oficială conține /etc/coolwsd/coolwsd.xmlși că administratorii o pot copia, modifica, copia înapoi sau monta din afara containerului.

Dacă fișierul nu este deja montat prin bind de pe gazdă, copiați-l:

sudo install -d -m 700 /var/backups/collabora
docker cp collabora:/etc/coolwsd/coolwsd.xml \
  /var/backups/collabora/coolwsd.xml

Apoi, capturați modul în care a fost configurat containerul:

docker inspect collabora --format '{{json .Config.Env}}' \
  > /var/backups/collabora/container-env.json

docker inspect collabora --format '{{json .Mounts}}' \
  > /var/backups/collabora/container-mounts.json

Important: ieșirea mediului poate conține parole, acreditări ale consolei de administrare, nume de gazdă sau alte secrete. Păstrați aceste fișiere accesibile doar utilizatorilor root și criptați sau protejați în alt mod copiile din afara gazdei.

Dacă utilizați Docker Compose, copiați fișierul Compose propriu-zis și orice fișiere de mediu sau secrete la care se face referire de pe gazdă. Locațiile lor sunt specifice implementării dvs., deci nu există o cale universală care să poată fi presupusă în siguranță.

Acțiune: confirmați că backup-ul include sursa originală. Dacă coolwsd.xmleste montat prin bind, faceți o copie de rezervă a fișierului gazdă. Dacă configurația este furnizată prin variabile de mediu, păstrați configurația Compose/run care definește acele variabile.

Pasul 3: Includeți cheile de probă, configurația proxy și TLS numai atunci când se aplică

Aceste componente sunt importante tocmai pentru că nu sunt identice la fiecare instalație.

Cheie de verificare WOPI: Collabora documentează faptul că instalările RPM și DEB generează automat perechea de chei de verificare WOPI. Pentru Docker, perechea de chei nu este livrată în imaginea publică; atunci când este utilizată, trebuie generată și furnizată containerului, de obicei printr-un volum. Manualul documentează coolconfig generate-proof-keymodul de generare a cheii. Deoarece cheia Docker se află în afara imaginii imuabile, pierderea cheii montate pe partea gazdă poate schimba identitatea utilizată pentru semnarea de verificare WOPI.

Acțiune: utilizați lista de montare a containerului pentru a identifica locația gazdă a oricărei montări de cheie de probă și creați o copie de rezervă în siguranță a fișierului sau directorului gazdă. Nu inventați o cale dacă implementarea dvs. nu utilizează una.

Proxy invers: Apache, Nginx, HAProxy, Traefik sau un alt proxy poate deține numele public de gazdă, terminarea TLS, rutarea WebSocket și regulile de redirecționare a cererilor. În CODE 26.04, Collabora a actualizat instrucțiunile proxy pentru adresa URL WebSocket compactă mai nouă, păstrând în același timp o soluție alternativă moștenită în unele cazuri.

Acțiune: faceți o copie de rezervă a configurației exacte de proxy care deservește numele dvs. de gazdă Collabora. Calea către sistemul de fișiere depinde de sistemul de operare și de proxy, așadar identificați-o din configurația proxy activă, în loc să copiați o cale generică dintr-un tutorial.

Certificate TLS: creați o copie de rezervă a acestora numai dacă această gazdă le deține efectiv. Dacă TLS este terminat la un echilibrator de sarcină, un controler de intrare, o rețea CDN sau un proxy invers separat, copia de rezervă a certificatului aparține acolo.

Pasul 4: Verificați copia de rezervă înainte de a o avea nevoie

O tarcomandă executată cu succes nu este suficientă. Testați dacă arhiva poate fi listată și dacă fișierul de configurare principal așteptat este prezent.

sudo tar -tzf /var/backups/collabora/coolwsd-etc-$(date +%F).tar.gz \
  | grep 'coolwsd/coolwsd.xml'

Creați o sumă de control pentru verificarea în afara gazdei:

cd /var/backups/collabora
sha256sum * > SHA256SUMS

Apoi copiați copia de rezervă într-o a doua locație protejată folosind sistemul dumneavoastră obișnuit de backup. Nu lăsați singura copie pe aceeași gazdă pe care o protejați.

Acțiune: testați extragerea într-un director temporar cel puțin o dată. O copie de rezervă pe care nu ați deschis-o niciodată este doar o presupunere.

Pasul 5: Restaurați conservativ, apoi validați serviciul care rulează

Restaurarea unei instalări native

Preferați să instalați mai întâi aceeași versiune de CODE. Opriți serviciul, extrageți arhiva într-un director de testare și comparați configurația salvată cu configurația implicită nou instalată:

sudo systemctl stop coolwsd
sudo mkdir -p /root/collabora-restore
sudo tar -xzf /var/backups/collabora/coolwsd-etc-YYYY-MM-DD.tar.gz \
  -C /root/collabora-restore

sudo diff -u \
  /etc/coolwsd/coolwsd.xml \
  /root/collabora-restore/coolwsd/coolwsd.xml

Dacă versiunile corespund și intenționați o înlocuire completă, păstrați mai întâi directorul nou ca o copie de rollback:

sudo cp -a /etc/coolwsd /etc/coolwsd.pre-restore
sudo cp -a /root/collabora-restore/coolwsd/. /etc/coolwsd/
sudo systemctl start coolwsd

Dacă versiunile diferă, îmbinați setările pe care le-ați modificat efectiv în loc să înlocuiți orbește noul fișier. Acest lucru evită eliminarea noilor setări implicite sau a elementelor obligatorii introduse de versiunea mai nouă.

Restaurați o implementare Docker

Recreați containerul din versiunea imaginii înregistrate și din Docker Compose sau docker rundefiniția originală. Restaurați configurația montată la legarea gazdei, cheile de probă și alte fișiere externe în căile gazdă originale înainte de a porni containerul.

Dacă ați păstrat în mod deliberat fișierul coolwsd.xmlîn interiorul containerului, mai degrabă decât ca o montare bind, abordarea documentată a Collabora permite copierea fișierului înapoi. În practică, o montare bind a gazdei este mai ușor de reprodus, deoarece configurația supraviețuiește înlocuirii containerului.

Acțiune: restaurați mai întâi definiția implementării, apoi restaurați fișierele la care face referire. Aceasta menține consecvența între variabilele de mediu, volumele și configurația XML.

Cum să confirmi că restaurarea a funcționat efectiv

Nu judecați succesul doar după pornirea procesului. Verificați serviciul de pe aceeași cale de rețea utilizată de clienți.

Pentru o instalare nativă:

sudo systemctl status coolwsd --no-pager
sudo journalctl -u coolwsd -n 100 --no-pager

Pentru Docker:

docker ps --filter name=collabora
docker logs --tail 100 collabora

Collabora documentează /hosting/capabilitiesendpoint-ul ca o modalitate de a recupera, printre alte informații, numele și versiunea produsului care rulează. Prin intermediul adresei URL publice Collabora, testați-l cu:

curl -fsS https://office.example.com/hosting/capabilities

Înlocuiți numele de gazdă cu al dvs. De asemenea, deschideți un document real de la gazda WOPI și verificați dacă editarea, salvarea și reconectarea funcționează prin calea normală de proxy invers.

Acțiune: considerați restaurarea finalizată numai după ce endpoint-ul capabilităților răspunde și un document real poate fi deschis și salvat.

Listă de verificare practică pentru copii de rezervă

Recomandare finală

Cel mai fiabil plan de recuperare CODE Collabora nu este un singur fișier copiat. Păstrați coolwsd.xml, versiunea exactă de CODE și definiția implementării împreună ca un set recuperabil. Adăugați chei de probă, reguli proxy și material TLS doar acolo unde arhitectura dvs. le utilizează efectiv. Pentru actualizări, restaurați în aceeași versiune atunci când este posibil; dacă treceți la o versiune mai nouă, comparați și îmbinați configurația în loc să suprascrieți noile valori implicite fără revizuire.

Începând cu 6 octombrie 2026, CODE 26.04.4.2 este versiunea curentă prezentată în notele oficiale de lansare Collabora 26.04 și în metadatele imaginilor Docker. Verificați din nou aceste surse oficiale înainte de o migrare viitoare, deoarece versiunile de imagini, recomandările de proxy și opțiunile de configurare continuă să evolueze.