Hoe u Collabora CODE-configuratiebestanden veilig kunt back-uppen en herstellen.

Collabora Online Development Edition (CODE) 26.04.4.2 is uitgebracht op 24 september 2026. Dit is belangrijk voor back-upplanning, omdat de releaseversie 26.04 ook delen van de aanbevolen afhandeling van reverse-proxy-paden voor nieuwere WebSocket-URL's heeft gewijzigd. Als u zich voorbereidt op een upgrade, migratie of noodherstel, is het maken van een back-up van slechts één XML-bestand mogelijk niet voldoende om een ​​werkende implementatie te reproduceren.

De geverifieerde kern is eenvoudig: het belangrijkste serverconfiguratiebestand van Collabora is /etc/coolwsd/coolwsd.xml, dat zich in de officiële CODE-container bevindt. De officiële Docker-documentatie ondersteunt ook het kopiëren van dat bestand uit een container, het terug kopiëren ervan of het binden ervan vanaf de host. De onderdelen die variëren, zijn alles eromheen: Docker-omgevingsvariabelen, bind mounts, WOPI-bewijssleutels, TLS-terminatie en reverse-proxy-configuratie.

Deze handleiding beschrijft een conservatief back-up- en herstelproces voor zowel native pakketinstallaties als Docker-implementaties. Er wordt bewust onderscheid gemaakt tussen wat door de Collabora-documentatie wordt bevestigd en wat afhankelijk is van uw eigen implementatie.

Wat moet een back-up van Collabora CODE bevatten?

Geverifieerd: /etc/coolwsd/coolwsd.xml dit is het primaire configuratiebestand van Collabora Online. Collabora documenteert dit pad direct en beschrijft het bestand als zelfdocumenterend voor de beschikbare serveropties. Zie de officiële Collabora Online SDK-handleiding .

Implementatieafhankelijk: een volledig herstel kan ook de configuratie vereisen die is gebruikt om de service te starten. Voor Docker kan dit Compose YAML, omgevingsvariabelen, bind mounts, secrets en bestanden die vanaf de host zijn gemount, omvatten. Voor een native installatie kan dit een reverse-proxy virtuele host en certificaten omvatten, indien deze op dezelfde server worden beheerd.

Actie: voordat u een archief aanmaakt, noteer of uw instantie een native pakketinstallatie of een Docker/Compose-implementatie betreft. Ga er niet van uit dat dezelfde herstelprocedure voor beide geldt.

Veelvoorkomende misverstanden voordat je begint

Het maken van een back-up van coolwsd.xml maakt geen back-up van gebruikersdocumenten.

CODE is normaal gesproken via WOPI verbonden met een opslagplatform. Documenten blijven onder de controle van dat opslagplatform, zoals Nextcloud of een andere WOPI-host. Het herstellen van de CODE-configuratie herstelt daarom niet de documenten zelf.

Actie: maak een back-up van de WOPI-host en de bijbehorende datastore met behulp van de back-upprocedure van dat product. Beschouw deze CODE-back-up als een back-up van de serviceconfiguratie.

Een Docker-container is geen back-up.

Een container kan opnieuw worden gemaakt op basis van een image. Configuratie die wordt doorgegeven via omgevingsvariabelen of bind mounts kan buiten de container worden opgeslagen, terwijl wijzigingen die alleen binnen de container zijn aangebracht, kunnen verdwijnen wanneer de container wordt vervangen.

Actie: sla de implementatiedefinitie en de op de host gekoppelde bestanden op, niet alleen het bestandssysteem van de container.

Het kopiëren van een oude coolwsd.xml over een nieuwere versie is niet altijd de veiligste herstelmethode.

Configuratieopties kunnen tussen verschillende CODE-releases verschillen. De huidige release-opmerkingen van Collabora tonen voortdurende wijzigingen in de server en proxy in de 26.04-serie, inclusief bijgewerkte proxy-aanbevelingen voor de compacte WebSocket-URL. Zie de officiële release-opmerkingen van CODE 26.04 .

Actie: registreer de CODE-versie bij elke back-up. Vergelijk bij het herstellen naar een andere versie het opgeslagen bestand met de standaardinstellingen van het nieuwe pakket voordat u het volledig vervangt.

Stap 1: Noteer de geïnstalleerde versie en het implementatietype.

Begin met het vastleggen van voldoende informatie om de omgeving te kunnen reproduceren. Inspecteer bij een containerimplementatie de draaiende container en de bijbehorende image:

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

Als uw container een andere naam gebruikt, vervang deze collaboradan dienovereenkomstig. De officiële image is gepubliceerd als collabora/code; Docker Hub identificeert momenteel de 26.04.4.2 image in de nieuwste release-lijn. Bekijk de officiële Collabora CODE image op Docker Hub .

Voor een native pakketinstallatie moet u de pakketversie noteren met de pakketbeheerder die u gebruikt. Op Debian of Ubuntu bijvoorbeeld:

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

Actie: sla de versie-output op in dezelfde beveiligde back-upmap als het configuratiearchief.

Stap 2: Maak een back-up van de kernconfiguratie en de implementatiemetadata.

Native pakketinstallatie

Maak een back-upmap aan die alleen toegankelijk is voor de root-gebruiker en archiveer de volledige /etc/coolwsdmap in plaats van alleen het hoofd-XML-bestand te selecteren. Zo blijven alle extra bestanden behouden die uw geïnstalleerde pakket of lokale aanpassingen daar hebben geplaatst.

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

Deze opdracht wijzigt de locatie opzettelijk /etcvóór het archiveren, zodat het archief een relatief coolwsd/pad bevat in plaats van een absoluut bestandssysteempad.

Docker of Docker Compose

Volgens de documentatie van Collabora bevat de officiële image de benodigde bestanden /etc/coolwsd/coolwsd.xmlen kunnen beheerders deze kopiëren, wijzigen, terugzetten of van buiten de container koppelen.

Als het bestand nog niet vanaf de host is gekoppeld, kopieer het dan:

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

Leg vervolgens vast hoe de container is geconfigureerd:

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

Belangrijk: de uitvoer van omgevingsvariabelen kan wachtwoorden, inloggegevens voor de beheerdersconsole, hostnamen of andere geheimen bevatten. Zorg ervoor dat deze bestanden alleen leesbaar zijn voor rootgebruikers en versleutel of beveilig kopieën die niet op de host aanwezig zijn.

Als je Docker Compose gebruikt, kopieer dan het Compose-bestand zelf en alle omgevings- of geheime bestanden waarnaar wordt verwezen vanaf de host. De locaties hiervan zijn specifiek voor jouw implementatie, dus er is geen universeel pad dat je zomaar kunt aannemen.

Actie: controleer of uw back-up de bron van waarheid bevat. Als de host via coolwsd.xmlbind-mount is gekoppeld, maak dan een back-up van het hostbestand. Als de configuratie via omgevingsvariabelen wordt aangeleverd, bewaar dan de Compose/run-configuratie die deze variabelen definieert.

Stap 3: Voeg bewijssleutels, proxyconfiguratie en TLS alleen toe wanneer ze van toepassing zijn.

Deze onderdelen zijn juist belangrijk omdat ze niet bij elke installatie identiek zijn.

WOPI-bewijssleutel: Collabora documenteert dat RPM- en DEB-installaties het WOPI-bewijssleutelpaar automatisch genereren. Voor Docker wordt het sleutelpaar niet meegeleverd in de publieke image; indien gebruikt, moet het worden gegenereerd en aan de container worden toegevoegd, meestal via een volume. De handleiding beschrijft coolconfig generate-proof-keyhoe de sleutel gegenereerd moet worden. Omdat de Docker-sleutel zich buiten de onveranderlijke image bevindt, kan het verlies van de aan de hostzijde gekoppelde sleutel de identiteit wijzigen die wordt gebruikt voor WOPI-bewijsondertekening.

Actie: gebruik de lijst met mountpunten van de container om de hostlocatie van elk mountpunt voor bewijssleutels te achterhalen en maak een veilige back-up van dat bestand of die map aan de hostzijde. Verzin geen pad als uw implementatie er geen gebruikt.

Reverse proxy: Apache, Nginx, HAProxy, Traefik of een andere proxy kan de publieke hostnaam, TLS-terminatie, WebSocket-routering en regels voor het doorsturen van verzoeken beheren. In CODE 26.04 heeft Collabora de proxyrichtlijnen voor de nieuwere compacte WebSocket-URL bijgewerkt, terwijl in sommige gevallen een oudere fallback-optie behouden blijft.

Actie: maak een back-up van de exacte proxyconfiguratie die uw Collabora-hostnaam bedient. Het bestandspad is afhankelijk van uw besturingssysteem en proxy, dus achterhaal het in de actieve proxyconfiguratie in plaats van een algemeen pad uit een handleiding te kopiëren.

TLS-certificaten: maak er alleen een back-up van als deze host ze daadwerkelijk bezit. Als TLS wordt beëindigd bij een load balancer, ingress controller, CDN of aparte reverse proxy, hoort de certificaatback-up daar thuis.

Stap 4: Controleer de back-up voordat u deze nodig hebt.

Een succesvol taruitgevoerde opdracht is niet voldoende. Controleer of het archief kan worden weergegeven en of het verwachte hoofdconfiguratiebestand aanwezig is.

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

Maak een checksum aan voor verificatie buiten de host:

cd /var/backups/collabora
sha256sum * > SHA256SUMS

Kopieer de back-up vervolgens naar een tweede beveiligde locatie met behulp van uw gebruikelijke back-upsysteem. Laat de enige kopie niet op dezelfde host staan ​​die u beveiligt.

Actie: test het uitpakken naar een tijdelijke map minstens één keer. Een back-up die u nooit hebt geopend, is slechts een aanname.

Stap 5: Herstel voorzichtig en controleer vervolgens of de service werkt.

Een native installatie herstellen

Installeer bij voorkeur eerst dezelfde CODE-release. Stop de service, pak het archief uit naar een tijdelijke map en vergelijk de opgeslagen configuratie met de zojuist geïnstalleerde standaardconfiguratie:

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

Als de versies overeenkomen en u een volledige vervanging wilt uitvoeren, bewaar dan eerst de nieuwe map als back-up voor terugdraaiing:

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

Als de versies verschillen, voeg dan de instellingen die je daadwerkelijk hebt gewijzigd samen in plaats van het nieuwe bestand blindelings te vervangen. Zo voorkom je dat nieuwe standaardwaarden of vereiste elementen die door de nieuwere versie zijn geïntroduceerd, verloren gaan.

Een Docker-implementatie herstellen

Maak de container opnieuw aan op basis van de opgenomen imageversie en de originele Docker Compose- of docker rundefinitie. Herstel de host-bind-mounted configuratie, proof keys en andere externe bestanden naar hun oorspronkelijke hostpaden voordat u de container start.

Als je het bestand bewust coolwsd.xmlbinnen de container hebt bewaard in plaats van als een bind mount, staat de gedocumenteerde aanpak van Collabora toe dat het bestand wordt teruggekopieerd. In de praktijk is een bind mount op de host gemakkelijker te reproduceren, omdat de configuratie behouden blijft bij vervanging van de container.

Actie: herstel eerst de implementatiedefinitie en vervolgens de bestanden waarnaar deze verwijst. Dit zorgt ervoor dat omgevingsvariabelen, volumes en de XML-configuratie consistent blijven.

Hoe te controleren of het herstel daadwerkelijk gelukt is?

Beoordeel succes niet alleen op basis van het feit of het proces start. Controleer de service vanaf hetzelfde netwerkpad dat door de clients wordt gebruikt.

Voor een native installatie:

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

Voor Docker:

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

Collabora beschrijft het /hosting/capabilitieseindpunt als een manier om onder andere de naam en versie van het actieve product op te halen. Test het via uw openbare Collabora-URL met:

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

Vervang de hostnaam door uw eigen hostnaam. Open ook een echt document vanaf de WOPI-host en controleer of bewerken, opslaan en opnieuw verbinding maken werkt via het normale reverse-proxy-pad.

Actie: beschouw het herstel pas als voltooid wanneer het mogelijkheden-eindpunt reageert en er daadwerkelijk een document kan worden geopend en opgeslagen.

Praktische back-up checklist

Eindaanbeveling

Het meest betrouwbare herstelplan voor Collabora CODE is niet een enkel gekopieerd bestand. Bewaar coolwsd.xmlde exacte CODE-versie en de implementatiedefinitie bij elkaar als één herstelbare set. Voeg bewijssleutels, proxyregels en TLS-materiaal alleen toe waar uw architectuur deze daadwerkelijk gebruikt. Herstel bij upgrades indien mogelijk naar dezelfde release; als u overstapt naar een nieuwere release, vergelijk en voeg de configuratie samen in plaats van de nieuwe standaardinstellingen te overschrijven zonder deze te controleren.

Vanaf 6 oktober 2026 is CODE 26.04.4.2 de actuele release, zoals weergegeven in de officiële release-opmerkingen van Collabora voor versie 26.04 en de metadata van de Docker-image. Controleer deze officiële bronnen nogmaals voordat u een toekomstige migratie uitvoert, aangezien imageversies, proxy-aanbevelingen en configuratieopties voortdurend veranderen.