Verbinden Sie Collabora Online mit ownCloud Infinite Scale

Nutzen Sie den Collaboration-Dienst von ownCloud Infinite Scale als WOPI-Brücke zwischen der Web-Oberfläche und Collabora Online. Für eine Neuinstallation empfiehlt sich die Verwendung des offiziellen modularen ocis_fullDocker-Compose-Beispiels von ownCloud, das Infinite Scale, Collaboration, Collabora und Traefik enthält. Legen Sie die öffentlichen URLs für Infinite Scale, Collabora und WOPI fest, verwenden Sie gültige TLS-Zertifikate und achten Sie auf die Konsistenz aller Dienstgeheimnisse. Konfigurieren Sie Infinite Scale nicht wie einen klassischen ownCloud Server.

Diese Unterscheidung wird in der aktuellen ownCloud-Dokumentation bestätigt: Infinite Scale integriert Office-Suiten über WOPI und den zugehörigen Collaboration-Service. Dieser Service ersetzt cs3org/wopiin neueren Versionen den älteren externen Server. Administratoren, die eine ältere Installation aktualisieren, müssen daher die Migrationsanweisungen für ihre installierte Version befolgen.

1. Überprüfen Sie die Release- und Netzwerkvoraussetzungen.

Prüfen Sie vor der Installation die genaue Infinite Scale-Version. Die aktuelle ownCloud-Dokumentation führt den Collaboration-Dienst in der Entwicklungsdokumentation 9.0 auf und gibt an, dass dieser separat gestartet werden muss, wenn Infinite Scale im überwachten Modus ausgeführt wird. Das ownCloud-Full-Stack-Beispiel weist ebenfalls darauf hin, dass die Einrichtung von Versionen mit dem Collaboration-Dienst abhängt und nicht mit Produktionsversionen der Version 5.x kompatibel ist. Verwenden Sie Dokumentation und Compose-Dateien, die zu Ihrer installierten Version passen. Kopieren Sie kein Beispiel aus einem laufenden Projekt in ein älteres Produktionssystem, ohne die Kompatibilität zu prüfen.

Für eine öffentliche Bereitstellung sollten Sie separate Hostnamen wie z . B. cloud.example.com` <cloud-name>`, `<collabora-name>` und `<collabora-name>` verwenden . Der Browser muss die Cloud- und Collabora-URLs erreichen können, und Collabora muss den von Infinite Scale bereitgestellten WOPI-Endpunkt erreichen können. DNS, Firewalls und TLS-Vertrauensstellung müssen in beide Richtungen funktionieren. Ein Host, der von Ihrem Laptop aus, aber nicht vom Collabora-Container aus erreichbar ist, reicht nicht aus.office.example.comwopi.example.com

Das Bereitstellungsbeispiel von ownCloud verwendet Traefik als Reverse-Proxy und setzt ein gültiges SSL-Zertifikat für die Serverkonfiguration voraus. Die lokale Testumgebung kann selbstsignierte Zertifikate verwenden, öffentliche Installationen sollten die Zertifikatsprüfung jedoch nicht stillschweigend deaktivieren. Legen Sie die zu verwendenden Hostnamen und Zertifikate fest, bevor Sie den Stack konfigurieren.

2. Beginnen Sie mit dem passenden Compose-Beispiel von ownCloud.

1. Öffnen Sie ownClouds offiziellen Bereitstellungsleitfaden für das vollständige modulare oCIS mit WebOffice und das zugehörige Beispielverzeichnis ocis_full . Verwenden Sie für den Produktivbetrieb eine Version oder einen Tag, der Ihrer Infinite Scale-Version entspricht, anstatt sich auf den Rolling Branch des Repositorys zu verlassen.
2. Sehen Sie sich die Beispieldatei an .env. Setzen Sie OCIS_DOMAIN, COLLABORA_DOMAIN, und WOPISERVER_DOMAINauf die Hostnamen, die zu Ihrem Server aufgelöst werden. Im Beispiel wird Collabora mit aktiviert COLLABORA=:collabora.yml; behalten Sie diese Einstellung bei, wenn Sie Collabora als Office-Editor verwenden möchten.
3. Verwenden Sie sichere, private Administrator-Anmeldeinformationen und befolgen Sie die TLS-Richtlinien für den Produktivbetrieb im Beispiel. Verwenden Sie keine Beispielpasswörter. Falls sich die Umgebungsvariablennamen oder das Dateilayout in der Repository-Version geändert haben, verwenden Sie die Dateien aus derselben Version mit dem entsprechenden Tag, anstatt Anweisungen aus verschiedenen Versionen zu vermischen.
4. Überprüfen Sie die Compose-Konfiguration vor dem Start. Stellen Sie sicher, dass die Dienste Collabora, Collaboration, Infinite Scale und Proxy das vorgesehene Netzwerk und die Konfiguration gemeinsam nutzen. Im ownCloud-Leitfaden wird darauf hingewiesen, dass die entsprechende Infinite Scale-Konfiguration und die generierten Geheimnisse mit den anderen Diensten geteilt werden müssen, wenn Collaboration in einem separaten Container ausgeführt wird.

Das Bereitstellungsbeispiel ist ein integrierter Stack, keine universelle Konfiguration für jede bestehende Installation. Wenn Sie Infinite Scale bereits mit systemd, Kubernetes oder einem benutzerdefinierten Reverse-Proxy verwenden, behalten Sie dieses Bereitstellungsmodell bei und konfigurieren Sie den Collaboration-Dienst und die App Registry anhand der Dokumentation dieser Version, anstatt einen zweiten vollständigen Stack zu starten.

3. Verbinden Sie Collaboration mit Collabora mithilfe von WOPI

Die Kerneinstellungen legen die Editor-URL und die extern erreichbare WOPI-Quelle fest. In der aktuellen Servicedokumentation COLLABORATION_APP_NAMEist der Anzeigename der App, COLLABORATION_APP_PRODUCTidentifiziert das Produkt, COLLABORATION_APP_ADDRverweist auf Collabora und COLLABORATION_WOPI_SRCist die URL, die Collabora zum Lesen und Schreiben von Dateien über Infinite Scale verwendet. Eine beispielhafte Konfiguration sieht folgendermaßen aus:

COLLABORATION_APP_NAME=CollaboraOnline
COLLABORATION_APP_PRODUCT=Collabora
COLLABORATION_APP_ADDR=https://office.example.com
COLLABORATION_WOPI_SRC=https://wopi.example.com

Verwenden Sie die tatsächlichen öffentlichen URLs und das für Ihre Bereitstellung erforderliche Variablenformat. Wenn die Dienste in einem internen Containernetzwerk kommunizieren, kann die interne Adresse für eine Konfiguration geeignet sein, während die Browser-URL für eine andere Konfiguration gilt. Ersetzen Sie keinen Hostnamen, der nur im Container gültig ist, durch einen Wert, den Collabora extern auflösen muss.

Der Collaboration-Dienst benötigt außerdem die Infinite Scale-Laufzeitwerte OCIS_URL, OCIS_JWT_SECRET, OCIS_REVA_GATEWAY, und MICRO_REGISTRY_ADDRESS. Diese müssen mit der laufenden Instanz übereinstimmen; das offizielle Full-Stack-Beispiel stellt Dienstbeziehungen für sein eigenes Compose-Netzwerk bereit. Erstellen Sie keine neuen Geheimnisse nur für einen Dienst und deaktivieren Sie keine WOPI-Prüfschlüsselprüfungen, um eine Diskrepanz zu umgehen. Lassen Sie die Zertifikatsprüfung für vertrauenswürdige öffentliche Zertifikate aktiviert; COLLABORATION_APP_INSECUREdies ist nur als Option für ein selbstsigniertes WOPI-App-Zertifikat dokumentiert, nicht als allgemeine Produktionslösung.

Die Anwendungsregistrierung steuert, welche Office-Anwendung für welchen MIME-Typ angezeigt wird und welche Anwendung standardmäßig geöffnet wird. Wenn Collabora ausgeführt wird, Dokumente aber keine Option zum Öffnen mit anzeigen, überprüfen Sie die MIME-Typ-Konfiguration in der Registrierung und deren default_appWert. Der dort verwendete Name muss mit dem konfigurierten Namen der Office-Anwendung übereinstimmen. ownCloud dokumentiert dies als YAML-Konfiguration; Umgebungsvariablen ersetzen die MIME-Typ-Zuordnung nicht.

4. Integration starten, testen und diagnostizieren

Validieren Sie anhand des offiziellen Compose-Beispiels die gerenderte Konfiguration und starten Sie dann den Stack aus seinem Bereitstellungsverzeichnis:

docker compose config
docker compose up -d

Wenn Sie nicht das Compose-Beispiel verwenden, starten Sie zuerst das Gateway, den App-Provider und die Collabora-Dienste. Im überwachten Modus müssen ownCloud-Dokumente die Kollaboration explizit starten ocis collaboration server; sie startet nicht automatisch. Stellen Sie sicher, dass die erforderlichen Umgebungsvariablen im Kollaborationsprozess vor dem Start gesetzt sind.

1. Öffnen Sie die https://office.example.com/hosting/discoverySeite in einem Browser. Ein erreichbarer Endpunkt sollte die Discovery-XML-Datei von Collabora zurückgeben und nicht einen DNS-, TLS- oder Proxy-Fehler.
2. Melden Sie sich bei Infinite Scale an, öffnen Sie ein unterstütztes Dokument und wählen Sie Collabora aus, falls die Benutzeroberfläche mehrere Office-Anwendungen anbietet. Testen Sie sowohl eine vorhandene Datei als auch, falls in der Anwendungsregistrierung aktiviert, das Erstellen eines neuen Dokuments.
3. Nehmen Sie eine kleine Änderung vor, warten Sie, bis die Speicheranzeige sich beruhigt hat, schließen Sie den Editor und öffnen Sie die Datei erneut, um zu überprüfen, ob die Änderung übernommen wurde.
4. Wenn sich der Editor nicht öffnen lässt, überprüfen Sie die Protokolle von Infinite Scale Collaboration und App Provider, Collabora und Reverse-Proxy zum gleichen Zeitpunkt. Die Meldung „Nicht autorisierter WOPI-Host“ deutet auf ein Problem mit der WOPI-Vertrauenskonfiguration von Collabora hin; ein fehlgeschlagener Callback oder ein TLS-Fehler deutet auf Probleme mit der URL-Erreichbarkeit oder dem Zertifikatvertrauen hin; eine fehlende App-Option deutet auf ein Problem mit der App-Registry hin.

Eine erfolgreiche Integration bedeutet, dass der Browser den Editor lädt, die WOPI-Verbindung Infinite Scale erreicht und die Änderungen nach dem erneuten Öffnen erhalten bleiben. Genaue Containernamen, URL-Verknüpfungen und Speicherorte der Konfigurationsdateien hängen von der Infinite Scale-Version und der Bereitstellungsmethode ab. Verwenden Sie die zur jeweiligen Version passende ownCloud-Dokumentation für diese Details, insbesondere bei der Migration vom alten externen WOPI-Server.

Referenzen: ownCloud Collaboration Servicekonfiguration , ownCloud App Registry-Konfiguration sowie Versionshinweise und Migrationshinweise zu Infinite Scale .