Wie man Collabora Online mit ownCloud Infinite Scale integriert

Die Integration von Collabora Online mit ownCloud Infinite Scale (oCIS) ist eine WOPI-Integration und unterscheidet sich von der Konfiguration, die bei ownCloud Classic verwendet wird. WOPI (Web Application Open Platform Interface) ist das Protokoll, das es einer Online-Office-Suite ermöglicht, eine Datei von einer Speicherplattform anzufordern, sie im Browser zu bearbeiten und das Ergebnis zurückzuschreiben.

Diese Unterscheidung ist wichtig, da aktuelle Infinite Scale-Implementierungen den integrierten Kollaborationsdienst als Schnittstelle zwischen oCIS und Collabora nutzen. Sie installieren nicht die alte ownCloud Classic Collabora-App und verweisen auf eine Server-URL. Die Office-Anwendung wird stattdessen über die Kollaborations- und App-Registrierungsdienste registriert. Die offizielle ownCloud WOPI-Dokumentation führt Collabora als unterstützte Office-Anwendung auf, während die Dokumentation des Kollaborationsdienstes den Dienst und seine erforderlichen Einstellungen erläutert.

Stand Oktober 2026 umfasst die offizielle GitHub-Version von ownCloud Infinite Scale 8.2.0 (veröffentlicht am 10. August 2026). Da sich das Bereitstellungsbeispiel des Projekts unabhängig weiterentwickeln kann, empfiehlt es sich, ein getestetes Produktions-Tag zu verwenden, anstatt von einem fortlaufend aktualisierten Image auszugehen. Das offizielle vollständige Bereitstellungsbeispiel von oCIS empfiehlt derzeit das Collabora-CODE-Tag 26.04.3.1.1in seiner Umgebungsvariablendatei. Prüfen Sie die offiziellen Infinite-Scale-Versionen und die offizielle Umgebungsvariablendatei des Bereitstellungsbeispiels, bevor Sie Versionen festlegen.

Zunächst sollten Sie die drei Endpunkte verstehen.

Eine Produktionsintegration umfasst normalerweise drei logische Endpunkte:

Verifiziert: COLLABORATION_APP_ADDR Dies ist die Collabora-URL und COLLABORATION_WOPI_SRCidentifiziert die von der Office-Anwendung verwendete WOPI-Quelle. Umgebungsabhängig: Die WOPI-Quelle muss kein separater öffentlicher Hostname sein, wenn Collabora und der Kollaborationsdienst ein vertrauenswürdiges Containernetzwerk gemeinsam nutzen. Das aktuelle offizielle Compose-Beispiel verwendet http://collaboration:9300intern eine solche Quelle. Eine separate Bereitstellung kann einen gerouteten HTTPS-WOPI-Hostnamen erfordern.

Hilfreiche Maßnahme: Legen Sie Ihre Topologie fest, bevor Sie Konfigurationswerte kopieren. Wenn alle Komponenten in einem offiziellen Compose-Stack laufen, verwenden Sie dieses Beispiel als Ausgangspunkt. Befindet sich Collabora auf einem anderen Host oder Kubernetes-Cluster, dokumentieren Sie, welchen DNS-Namen jede Seite auflösen und erreichen kann.

Phase 1: DNS, HTTPS und Collabora Discovery überprüfen

Bevor Sie die oCIS-Konfiguration ändern, stellen Sie sicher, dass die Namen ownCloud und Collabora korrekt aufgelöst werden und Collabora seinen Discovery-Endpunkt bereitstellt. Collabora veröffentlicht WOPI-Funktionen über [Link einfügen] /hosting/discovery. Eine einfache Überprüfung ist:

dig +short cloud.example.com
dig +short office.example.com

curl -fsS https://office.example.com/hosting/discovery | head

Sie sollten XML vom Discovery-Endpunkt erhalten. Falls die TLS-Verschlüsselung an einem Reverse-Proxy terminiert, überprüfen Sie, ob das vorgelegte Zertifikat office.example.comaus Sicht des oCIS-Hosts oder des Containernetzwerks gültig ist.

Bildunterschrift: Überprüfen Sie die Namensauflösung und den Collabora- /hosting/discoveryEndpunkt, bevor Sie die WOPI-Registrierung in Infinite Scale debuggen.

Häufiges Missverständnis: Das Anzeigen einer Collabora-Startseite im Browser beweist nicht, dass die WOPI-Integration funktioniert. Es beweist lediglich, dass der Web-Endpunkt erreichbar ist. Der Kollaborationsdienst muss Collabora ebenfalls erreichen können, und Collabora muss die WOPI-Quelle erreichen können.

Nützliche Maßnahme: Führen Sie Konnektivitätstests aus demselben Netzwerk-Namespace wie den entsprechenden Dienst durch – zum Beispiel aus dem Kollaborationscontainer heraus, wenn Sie Docker verwenden.

Phase 2: Konfigurieren des Kollaborationsdienstes „Unendlich skalierbar“

Der Kollaborationsdienst wird bei einer allgemeinen ocis serverKonfiguration im überwachten Modus nicht automatisch gestartet. Laut ownCloud-Dokumentation muss er explizit gestartet werden, da Administratoren möglicherweise mehrere Instanzen des Kollaborationsdienstes für verschiedene Office-Produkte ausführen.

Die wichtigsten Einstellungen für Collabora sind:

COLLABORATION_APP_NAME=CollaboraOnline
COLLABORATION_APP_PRODUCT=Collabora
COLLABORATION_APP_ADDR=https://office.example.com
COLLABORATION_WOPI_SRC=http://collaboration:9300
OCIS_URL=https://cloud.example.com

Der oben genannte WOPI-Quellcode entspricht exakt der Topologie des aktuellen offiziellen Compose-Beispiels: Collabora und der Kollaborationsdienst nutzen dasselbe Docker-Netzwerk. Falls Ihr Collabora-Server extern ist, ersetzen Sie die interne URL durch die Adresse, die Collabora erreichen kann.

Der Dienst ist außerdem von der Gateway- und App-Provider-Infrastruktur von Infinite Scale abhängig. In einer Split-Container-Bereitstellung weist die ownCloud-Dokumentation ausdrücklich darauf hin, dass die oCIS-Konfiguration mit dem Kollaborationscontainer geteilt werden muss, da generierte Geheimnisse dienstübergreifend benötigt werden. Siehe die aktuelle offizielle Collabora Compose-Definition .

Bildunterschrift: Ein Kollaborationsprozess sollte mit der vorgesehenen Collabora-Adresse und WOPI-Quelle beginnen; verwenden Sie echte Serviceprotokolle, um die Werte in Ihrer Bereitstellung zu bestätigen.

Nützlicher Tipp: Wenn Sie die Bereitstellung manuell erstellt haben, vergleichen Sie Ihre Umgebung mit der offiziellen, collabora.ymlanstatt Einstellungen aus einem alten cs3org/wopiserver-Tutorial zu kopieren.

Schritt 3: Collabora für den WOPI-Host und die Browsereinbettung konfigurieren

Collabora muss dem WOPI-Host vertrauen und die Berechtigung haben, innerhalb der ownCloud-Webseite gerendert zu werden. Das offizielle oCIS Compose-Beispiel übergibt Collabora Optionen, die TLS am Reverse-Proxy beenden und net.frame_ancestorsauf die oCIS-Domäne setzen. Außerdem wird vor dem Start von Collabora ein WOPI-Proof-Key generiert.

Im offiziellen Beispiel umfassen die relevanten Werte auf Collabora-Seite Folgendes:

DONT_GEN_SSL_CERT=YES

extra_params:
  --o:ssl.enable=...
  --o:ssl.ssl_verification=...
  --o:ssl.termination=true
  --o:welcome.enable=false
  --o:net.frame_ancestors=cloud.example.com

Die genauen SSL-Flags hängen davon ab, wo TLS terminiert. Für Verbindungen mit Internetzugang wird HTTPS mit aktivierter Zertifikatsprüfung empfohlen. Die im Beispiel verwendete INSECURE=trueOption ist für lokale Installationen mit selbstsignierten Zertifikaten vorgesehen; die Bereitstellungsanleitung von ownCloud weist Administratoren ausdrücklich darauf hin, diese Option für öffentliche Server zu entfernen oder zu deaktivieren.

Bildunterschrift: Eine erreichbare Collabora-Endpunkt ist eine Voraussetzung; in Produktionsumgebungen sollte dieser über HTTPS mit einem von den anderen Komponenten als vertrauenswürdig eingestuften Zertifikat bereitgestellt werden.

Hilfreiche Maßnahme: Falls beim Laden des Dokuments ein leerer iFrame oder ein CSP-Fehler auftritt, überprüfen Sie die Entwicklertools Ihres Browsers und die Reverse-Proxy-Header. Deaktivieren Sie die Zertifikatsprüfung oder die Inhaltssicherheitsbeschränkungen nicht pauschal, nur um das Laden der Seite zu ermöglichen.

Phase 4: Dateitypen des Standesamts und Testbearbeitung

Der App-Registry-Dienst von Infinite Scale legt fest, welche Anwendung welchen MIME-Typ öffnen darf. In der Konfiguration lassen sich MIME-Typ, Dateiendung, Symbol, Standardanwendung und die Berechtigung zum Erstellen neuer Dateien dieses Typs definieren. Die offizielle Dokumentation zur App-Registry beschreibt diese Felder.

Wichtig ist, dass der von der Registrierung verwendete App-Name mit dem tatsächlich registrierten Kollaborationsanbieter übereinstimmen muss. Aktuelle offizielle Collabora-Bereitstellungsbeispiele verwenden „ CollaboraOnlineas “ COLLABORATION_APP_NAMEund Collabora„as“ als Produktnamen. Verwenden Sie keine Namen aus älteren Beispielen, ohne die Bereitstellungsversion zu überprüfen.

Nach dem Start melden Sie sich bei ownCloud Web an und öffnen ein unterstütztes Office-Dokument. Ein erfolgreicher Ablauf sieht folgendermaßen aus:

• ownCloud Web wählt die Anwendung des registrierten Büros für den MIME-Typ des Dokuments aus.
• Der Kollaborationsdienst erstellt die WOPI-Startinformationen.
• Collabora wird im Browser geladen und fordert die Datei über WOPI an.
• Änderungen werden über denselben Integrationsprozess zurück in Infinite Scale geschrieben.

Bildunterschrift: Der letzte Test besteht darin, ein echtes Office-Dokument aus ownCloud Web zu öffnen, es in Collabora zu bearbeiten, es zu schließen und zu bestätigen, dass die gespeicherte Version in Infinite Scale wieder sichtbar ist.

Nützliche Vorgehensweise: Nehmen Sie eine kleine Änderung an einem temporären Testdokument vor, schließen Sie den Editor, öffnen Sie die Datei erneut und überprüfen Sie, ob die Änderung erhalten geblieben ist. Eine Seite, die lediglich den Editor lädt, ist kein vollständiger Test des Schreibpfads.

Verwenden Sie das offizielle Compose-Beispiel, wenn Sie keine benutzerdefinierte Topologie benötigen.

Für eine herkömmliche Docker-Bereitstellung bietet das von ownCloud bereitgestellte Beispiel das geringste Risiko ocis_full. Es umfasst Infinite Scale (oCIS), den Kollaborationsdienst Collabora und Traefik. Laut der offiziellen Anleitung benötigt die Bereitstellung Domänen für oCIS und Collabora und dokumentiert die WOPI-Komponente als Teil des Stacks. Die vollständige offizielle Bereitstellungsanleitung finden Sie hier .

Eine typische produktionsorientierte Umgebungsdatei enthält Werte, die konzeptionell wie folgt lauten:

OCIS_DOCKER_IMAGE=owncloud/ocis
OCIS_DOCKER_TAG=<tested-production-version>
OCIS_DOMAIN=cloud.example.com

COLLABORA=:collabora.yml
COLLABORA_DOCKER_TAG=<tested-collabora-version>
COLLABORA_DOMAIN=office.example.com

INSECURE=false

Beginnen Sie den Stack dann mit:

docker compose pull
docker compose up -d
docker compose ps

Bestätigt: Das aktuelle offizielle Reverse-Proxy-Beispiel aktiviert kodierte Schrägstriche, Fragezeichen und Prozentzeichen am HTTPS-Einstiegspunkt, da diese von Collaboration/Collabora benötigt werden. Umgebungsabhängig: Bei Verwendung von Nginx, HAProxy, einem Ingress-Controller oder einem Cloud Load Balancer anstelle von Traefik müssen Sie die erforderliche URL-Verarbeitung, das WebSocket-/Proxy-Verhalten, die Zertifikate und die Timeouts in der jeweiligen Plattform implementieren.

Empfohlene Vorgehensweise: Traefik-Labels sollten nicht wörtlich in andere Proxys übersetzt werden. Nutzen Sie sie stattdessen, um die Routing-Anforderungen zu verstehen und diese anschließend mithilfe der dokumentierten Syntax Ihres Proxys zu implementieren.

Fehlerbehebungsreferenz

Was ist bekannt, was hängt von Ihrem Einsatz ab und welche Annahmen sollten Sie vermeiden?

Bekannt: Infinite Scale unterstützt Collabora über WOPI, der integrierte Kollaborationsdienst dient derzeit als Brücke, und die offizielle vollständige Implementierung bietet eine funktionierende Referenzarchitektur.

Hängt von Ihrer Umgebung ab: ob der WOPI-Endpunkt eine interne Container-URL oder ein öffentlicher Hostname ist, wo TLS terminiert, welchen Proxy Sie verwenden und ob Collabora im selben Netzwerk wie oCIS läuft.

Gehen Sie nicht davon aus, dass die Anweisungen für ownCloud Classic auch für Infinite Scale gelten. Die Dokumentation zu Classic, die die Installation einer Collabora/richdocuments-App oder deren Konfiguration über die Admin-Oberfläche von Classic beschreibt, basiert auf einer anderen Produktarchitektur.

Der zuverlässigste Integrations-Workflow sieht daher so aus: Beginnen Sie mit dem offiziellen Infinite Scale-Bereitstellungsmodell, weisen Sie die Netzwerk- und TLS-Erreichbarkeit nach, konfigurieren Sie den Kollaborationsdienst, bestätigen Sie, dass Collabora dem WOPI-Host vertraut und ihn erreichen kann, registrieren Sie die relevanten MIME-Typen und testen Sie schließlich das Öffnen und Speichern eines echten Dokuments.