Nextcloud verbinden met CODE Docker: installatie en afwegingen

Verbind Nextcloud met Collabora CODE door de officiële collabora/codeimage te draaien, de poort te beperken tot de host, een HTTPS-subdomein voor het kantoor via een reverse proxy met WebSocket-functionaliteit te routeren en die openbare URL in te stellen in de Collabora-integratie van Nextcloud. Tien minuten is alleen haalbaar als Docker, DNS, TLS en de proxy gereed zijn.

Kies eerst de juiste kantooroplossing. Vanaf oktober 2026 maakt Nextcloud onderscheid tussen Nextcloud Office (aangedreven door EuroOffice) en Collabora Online. CODE staat voor Collabora Online Development Edition, dus gebruik de Collabora-integratie en niet de EuroOffice-connector. De ingebouwde CODE-app is het snelst voor persoonlijk gebruik, maar Nextcloud beschrijft deze als trager en zonder geavanceerde schaalbaarheid. Een aparte container is gemakkelijker onafhankelijk te beheren, maar brengt extra werk met zich mee op het gebied van proxy's en updates. CODE is geschikt voor thuisgebruik en testen; kies voor een ondersteunde Collabora Online-implementatie wanneer een bedrijf productieondersteuning nodig heeft.

Voordat je begint: het tien minuten durende pad

Zorg voor een werkend Nextcloud HTTPS-adres, een aparte kantoorhostnaam met geldige TLS-verbinding en Docker-toegang op de CODE-host. Verwijs de kantoorhostnaam naar een reverse proxy die de verbinding met de container kan doorsturen. Zowel de browsers van de gebruikers als de Nextcloud-server moeten de kantoor-URL kunnen bereiken.

Als DNS of TLS nog niet gereed is, stel poort 9980 dan niet publiekelijk beschikbaar als snelkoppeling. Koppel deze aan de loopback-poort en voltooi eerst de proxy-configuratie.

1. Start de CODE Docker-container

Vervang de voorbeeld-Nextcloud-hostnaam door de exacte HTTPS-bron die gebruikers gebruiken om in te loggen. Deze aliasgroup1instelling beperkt welke WOPI-host (de bestandsservice die documenten aan de editor levert) verbinding mag maken. Gebruik geen wildcard om een ​​mislukte verbinding te verbergen.

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

Door de poort te binden, 127.0.0.1blijft deze privé, terwijl een proxy op dezelfde host er wel toegang toe heeft. Als uw proxy zich elders bevindt, sta dan alleen die vertrouwde proxy toe om verbinding te maken met poort 9980.

Controleer of de container is gestart en of het discovery-eindpunt lokaal reageert:

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

-kDit omzeilt de certificaatvalidatie alleen voor deze lokale controle van een zelfondertekend certificaat; het corrigeert geen ongeldig openbaar certificaat.

2. Plaats de hostnaam van het openbare kantoor achter HTTPS.

Gebruik https://office.example.comuw reverse proxy met een geldig certificaat en routeer verzoeken naar CODE. De proxy-richtlijnen van Collabora behandelen editor-assets, detectie/mogelijkheden /cool/en WebSocket-doorsturing. Zonder WebSocket-upgrades kan de pagina wel laden, maar de editor niet.

Gebruik de bestaande configuratie voor uw proxysoftware. Als deze TLS beëindigt vóór CODE, volg dan de gedocumenteerde TLS-instellingen voor de backend; schakel certificaatcontroles niet globaal uit.

3. Verbind de Collabora-integratie in Nextcloud.

Schakel in Nextcloud de Collabora-integratie-app in of installeer deze, die beschikbaar is voor uw release. Open vervolgens het beheerdersgedeelte voor Office en voer de openbare Collabora-URL in https://office.example.com. In de huidige handleidingen wordt deze instelling aangeduid als 'Collabora Online Server'; de formulering en app-labels kunnen per release verschillen, met name wanneer Nextcloud de Euro-Office-optie toevoegt. Selecteer Collabora Online voor deze CODE-server. Voer niet alleen het containeradres in, https://127.0.0.1:9980tenzij Nextcloud zelf op dezelfde host draait en dat adres ook het geconfigureerde service-eindpunt is; gebruik in de aanbevolen proxy-instellingen de openbare hostnaam van Office.

Sla de instelling op en voer de ingebouwde verbindingscontrole uit als uw versie deze functie biedt. Als deze mislukt, vergelijk dan de exacte Nextcloud-oorsprong in de configuratie aliasgroup1, controleer of zowel Nextcloud als de browser de hostnaam van het kantoor kunnen oplossen en bereiken, en inspecteer de logboeken van de reverse-proxy op geweigerde paden of WebSocket-fouten.

4. Controleer de bewerking en kies vervolgens of de code past.

Open een klein testdocument in Nextcloud en controleer of het in de browsereditor wordt geopend, een wijziging accepteert, wordt opgeslagen en opnieuw wordt geopend met die wijziging intact. Test dit zowel vanuit een normaal gebruikersaccount als vanuit een beheerdersaccount. Een werkende detectiecontrole bevestigt dat CODE reageert; het bewijst niet dat WOPI-autorisatie, proxy-WebSockets en het opslaan van documenten allemaal werken.

Voor een persoonlijke server of een klein team scheidt CODE Docker de editor van de PHP-stack van Nextcloud. Je beheert ook de proxy, herstarts, compatibiliteitscontroles en image-updates. De ingebouwde CODE-app is eenvoudiger, maar deelt de host en heeft minder schaalbaarheidsfuncties. Voor een organisatie die dagelijks bewerkingen uitvoert, is het raadzaam om een ​​ondersteunde Collabora Online-service te overwegen in plaats van CODE als productiegarantie te beschouwen.

Wanneer u CODE wilt bijwerken, haal dan de nieuwe image op en maak de container opnieuw aan met dezelfde opties. Lees de release notes door en test het openen en opslaan van documenten voordat u een service bijwerkt waar gebruikers van afhankelijk zijn; de latesttag kan namelijk veranderen. Stel een specifieke imageversie in wanneer herhaalbare uitrolprocedures belangrijk zijn.

Verificatie

De configuratie werkt correct wanneer de openbare kantoorhostnaam een ​​geldig certificaat presenteert, de Nextcloud-verbindingscontrole slaagt en een testdocument kan worden geopend, opgeslagen en opnieuw geopend via de editor. Als de kantoorpagina wel laadt, maar het bewerken vastloopt, controleer dan de WebSocket-doorsturing. Als Nextcloud meldt dat de host niet is toegestaan, corrigeer dit dan aliasgroup1zodat deze overeenkomt met de werkelijke Nextcloud-origin. Als CODE lokaal wel reageert, maar niet vanuit de browsers van gebruikers, controleer dan de openbare DNS, de firewall-routering en de reverse proxy.

Referenties: Installatievoorbeeld van Nextcloud Docker ; Installatieopties voor Nextcloud Office ; Configuratie van Nextcloud Collabora ; Reverse-proxy-instellingen voor Collabora ; Details van de officiële CODE Docker-image ; Opties voor Nextcloud Hub 26 Summer Office .