Nextcloud mit CODE Docker verbinden: Einrichtung und Abwägungen

Verbinden Sie Nextcloud mit Collabora CODE, indem Sie das offizielle collabora/codeImage ausführen, den Port auf den Host beschränken, eine HTTPS-Subdomain Ihres Büros über einen WebSocket-fähigen Reverse-Proxy leiten und diese öffentliche URL in der Collabora-Integration von Nextcloud festlegen. Zehn Minuten sind nur dann realistisch, wenn Docker, DNS, TLS und der Proxy bereit sind.

Wählen Sie zunächst den passenden Office-Service. Seit Oktober 2026 unterscheidet Nextcloud zwischen seinem Euro-Office-basierten Nextcloud Office und Collabora Online. CODE ist die Collabora Online Development Edition. Verwenden Sie daher die Collabora-Integration und nicht den Euro-Office-Connector. Die integrierte CODE-App ist für den privaten Gebrauch am schnellsten, Nextcloud beschreibt sie jedoch als langsamer und weniger skalierbar. Ein separater Container ist einfacher zu verwalten, erfordert aber zusätzlichen Aufwand für Proxys und Updates. CODE eignet sich für den privaten Gebrauch und zum Testen. Für den Produktivbetrieb Ihres Unternehmens wählen Sie eine unterstützte Collabora Online-Bereitstellung.

Bevor Sie beginnen: der Zehn-Minuten-Pfad

Sie benötigen eine funktionierende Nextcloud-HTTPS-Adresse, einen separaten Büro-Hostnamen mit gültigem TLS-Zertifikat und Docker-Zugriff auf dem CODE-Host. Leiten Sie den Büro-Hostnamen auf einen Reverse-Proxy weiter, der Anfragen an den Container weiterleiten kann. Sowohl die Browser der Benutzer als auch der Nextcloud-Server müssen die Büro-URL erreichen können.

Falls DNS oder TLS noch nicht bereit sind, geben Sie Port 9980 nicht öffentlich als Abkürzung frei. Binden Sie ihn an den Loopback-Port und stellen Sie den Proxy zuerst fertig.

1. Starten Sie den CODE-Docker-Container.

Ersetzen Sie den Beispiel-Hostnamen von Nextcloud durch die exakte HTTPS-Ursprungsadresse, die Benutzer zum Anmelden verwenden. Diese aliasgroup1Einstellung beschränkt die WOPI-Hosts (den Dateidienst, der dem Editor Dokumente bereitstellt), die Verbindungen herstellen dürfen. Verwenden Sie keinen Platzhalter, nur um eine fehlgeschlagene Verbindung zu kaschieren.

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

Durch die Bindung an 127.0.0.1einen Port bleibt dieser privat, während ein Proxy auf demselben Host darauf zugreifen kann. Befindet sich Ihr Proxy auf einem anderen Host, erlauben Sie nur diesem vertrauenswürdigen Proxy die Verbindung zu Port 9980.

Prüfen Sie, ob der Container gestartet wurde und sein Discovery-Endpunkt lokal antwortet:

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

-kDie Zertifikatsvalidierung wird nur für diese lokale, selbstsignierte Prüfung umgangen; ein ungültiges öffentliches Zertifikat wird dadurch nicht behoben.

2. Schützen Sie den Hostnamen der öffentlichen Einrichtung mit HTTPS.

Stellen Sie die https://office.example.comSeite über Ihren Reverse-Proxy mit einem gültigen Zertifikat bereit und leiten Sie Anfragen an CODE weiter. Die Proxy-Anleitung von Collabora umfasst Editor-Ressourcen, Erkennung/Funktionen /cool/und WebSocket-Weiterleitung. Ohne WebSocket-Upgrades kann es vorkommen, dass die Seite geladen wird, der Editor jedoch nicht funktioniert.

Verwenden Sie die für Ihre Proxy-Software hinterlegte Konfiguration. Falls die TLS-Verbindung vor CODE beendet wird, befolgen Sie die dokumentierten TLS-Einstellungen des Backends; deaktivieren Sie die Zertifikatsprüfung nicht global.

3. Verbinden Sie die Collabora-Integration in Nextcloud.

Aktivieren oder installieren Sie in Nextcloud die für Ihre Version verfügbare Collabora-Integrations-App. Öffnen Sie anschließend den Administrationsbereich für Office und geben Sie die öffentliche Collabora-URL ein https://office.example.com. In den aktuellen Handbüchern wird diese Einstellung als „Collabora Online Server“ bezeichnet; die Bezeichnungen können je nach Version variieren, insbesondere da Nextcloud die Euro-Office-Option hinzufügt. Wählen Sie für diesen CODE-Server „Collabora Online“ aus. Geben Sie die Containeradresse nur dann ein https://127.0.0.1:9980, wenn Nextcloud selbst auf demselben Host läuft und diese Adresse auch der konfigurierte Service-Endpunkt ist. Verwenden Sie in der empfohlenen Proxy-Konfiguration den öffentlichen Office-Hostnamen.

Speichern Sie die Einstellungen und führen Sie den integrierten Verbindungstest durch, falls Ihre Version einen solchen anzeigt. Falls dieser fehlschlägt, vergleichen Sie den genauen Nextcloud-Ursprung in der Konfigurationsdatei aliasgroup1, stellen Sie sicher, dass sowohl Nextcloud als auch der Browser den Hostnamen des Büros auflösen und erreichen können, und überprüfen Sie die Reverse-Proxy-Protokolle auf blockierte Pfade oder WebSocket-Fehler.

4. Überprüfen Sie die Bearbeitung und entscheiden Sie dann, ob der Code passt.

Öffnen Sie ein kleines Testdokument in Nextcloud und prüfen Sie, ob es sich im Browser-Editor öffnen lässt, Änderungen akzeptiert, speichert und sich anschließend mit den Änderungen wieder öffnen lässt. Testen Sie dies sowohl mit einem normalen Benutzerkonto als auch mit einem Administratorkonto. Ein funktionierender Erkennungstest bestätigt lediglich, dass CODE reagiert; er beweist jedoch nicht, dass die WOPI-Autorisierung, Proxy-WebSockets und das Speichern des Dokuments einwandfrei funktionieren.

Für einen persönlichen Server oder ein kleines Team trennt CODE Docker den Editor vom PHP-Stack von Nextcloud. Sie sind außerdem für Proxy, Neustarts, Kompatibilitätsprüfungen und Image-Updates verantwortlich. Die integrierte CODE-App ist einfacher, teilt sich aber den Host und bietet weniger Skalierbarkeit. Organisationen, die täglich bearbeiten müssen, sollten einen unterstützten Collabora Online-Dienst in Betracht ziehen, anstatt CODE als Produktionslösung zu betrachten.

Wenn Sie bereit sind, CODE zu aktualisieren, laden Sie das neue Image herunter und erstellen Sie den Container mit denselben Optionen neu. Lesen Sie die Versionshinweise und testen Sie das Öffnen und Speichern von Dokumenten, bevor Sie einen Dienst aktualisieren, auf den Benutzer angewiesen sind; das latestTag kann sich verschieben. Legen Sie eine bestimmte Image-Version fest, wenn wiederholbare Rollouts wichtig sind.

Überprüfung

Die Einrichtung funktioniert, wenn der Hostname des öffentlichen Büros ein gültiges Zertifikat vorlegt, die Nextcloud-Verbindungsprüfung erfolgreich ist und ein Testdokument im Editor geöffnet, gespeichert und erneut geöffnet werden kann. Lädt die Startseite des Büros, hängt sich aber die Bearbeitung auf, überprüfen Sie die WebSocket-Weiterleitung. Meldet Nextcloud, dass der Host nicht zulässig ist, korrigieren Sie dies, aliasgroup1sodass er mit dem tatsächlichen Nextcloud-Ursprung übereinstimmt. Antwortet CODE lokal, aber nicht über die Browser der Benutzer, überprüfen Sie das öffentliche DNS, das Firewall-Routing und den Reverse-Proxy.

Referenzen: Nextclouds Docker-Installationsbeispiel ; Nextcloud Office-Installationsoptionen ; Nextcloud Collabora-Konfiguration ; Collabora Reverse-Proxy-Einstellungen ; offizielle CODE Docker-Image-Details ; Nextcloud Hub 26 Summer Office-Optionen .