Prüfen Sie zunächst, ob Browser, Nextcloud und Collabora die korrekten Server-URLs über dasselbe HTTP- oder HTTPS-Protokoll erreichen können. Testen Sie in Nextcloud die Endpunkte von Collabora /hosting/capabilities. /hosting/discoveryFalls diese antworten, Dokumente aber weiterhin nicht geladen werden können, überprüfen Sie die WebSocket-Route des Reverse-Proxys und die WOPI-Zulassungsliste.
Die Fehlermeldung „Das ist peinlich“ ist ein allgemeiner Fehler beim Öffnen eines Dokuments und keine eigenständige Diagnose. Mögliche Ursachen sind eine nicht erreichbare URL, ein TLS- oder DNS-Problem, ein Proxy, der WebSocket-Aktualisierungen blockiert, oder ein WOPI-Host, dem Collabora oder Nextcloud nicht vertrauen. Die folgenden Prüfungen verwenden ein typisches Beispiel mit Nextcloud unter [URL] https://cloud.example.comund Collabora unter [URL] https://office.example.com. Ersetzen Sie beide Namen durch Ihre tatsächlichen Hostnamen.
Öffnen Sie diese URLs in einem Browser im selben Netzwerk wie der Benutzer und ändern Sie dabei den Collabora-Hostnamen:
https://office.example.com/hosting/capabilitieshttps://office.example.com/hosting/discoverySie sollten Daten vom Collabora-Endpunkt zurückgeben und keine Browserzertifikatswarnung, keine 404-Seite oder keinen Reverse-Proxy-Fehler anzeigen. Der Discovery-Endpunkt gibt normalerweise XML zurück. Sie können dies auch vom Nextcloud-Host oder dessen Anwendungscontainer aus testen:
curl -fsS https://office.example.com/hosting/capabilities
curl -fsS https://office.example.com/hosting/discoveryEin Fehler im Browser deutet auf ein Problem mit dem öffentlichen oder LAN-DNS-Server, der Firewall, dem Zertifikat oder dem Proxy-Routing hin. Wenn der Browser erfolgreich ist, Nextcloud aber über die Kommandozeile nicht zugreift, bedeutet dies, dass die serverseitige Route unterschiedlich ist; sowohl der Browser des Benutzers als auch der Nextcloud-Server benötigen jeweils einen eigenen funktionierenden Pfad zu Collabora. Das aktuelle Administrationshandbuch von Nextcloud empfiehlt, beide Endpunkte von beiden Standorten aus zu testen und zu bestätigen, dass Collabora Nextcloud auch über HTTP(S) erreichen kann.
Öffnen Sie in Nextcloud Einstellungen → Administration → Office und prüfen Sie, ob das Feld „Collabora Online-Server“ die öffentliche oder anderweitig erreichbare Collabora-URL enthält. Verwenden Sie diese URL, https://wenn der Dienst für HTTPS konfiguriert ist. Laut Nextcloud-Dokumentation sollte die konfigurierte URL dasselbe Protokoll wie die Collabora-Installation verwenden und empfiehlt HTTPS.
Überprüfen Sie nun den Rückpfad. Fordern Sie vom Collabora-Host oder -Container aus den Status-Endpunkt von Nextcloud an:
curl -fsS https://cloud.example.com/status.phpDie Antwort sollte von Collabora aus erreichbar sein, nicht nur von Ihrem Laptop. Falls einer der Server in Docker läuft, testen Sie ihn vom entsprechenden Container oder Netzwerk-Namespace aus: Ein Hostname, der auf dem Host aufgelöst wird, kann innerhalb eines Containers möglicherweise nicht aufgelöst werden. Bei einem integrierten CODE-Server muss Nextcloud sich selbst über denselben Hostnamen erreichen können, den Benutzer im Browser verwenden. Falls Split-DNS oder lokale Namensauflösung dies verhindern, korrigieren Sie die DNS-Einstellungen oder die Hostzuordnung, anstatt localhosteinen Remote-Dienst einzugeben.
Wenn die Discovery-URL geladen wird, der Editor jedoch leer bleibt, sich dreht oder die Verbindung abbricht, überprüfen Sie den vorgeschalteten Proxy von Collabora. Die Bearbeitung erfolgt über eine persistente WebSocket-Verbindung: Der Proxy muss den aktuellen /cool/…/wsEndpunkt von Collabora an den Collabora-Dienst weiterleiten und die HTTP/1.1-Upgrade-Header übermitteln. Prüfen Sie das aktuelle Collabora-Proxy-Beispiel für Ihre Proxy-Software und -Version; verwenden Sie keine unveränderte alte Konfiguration.
Ältere Installationen verwenden möglicherweise noch Pfade wie `/example.com` /lool. Die Migrationsanleitung von Collabora beschreibt die Umstellung von `/example.com` loolauf `/example.com` und coolvon ` /example.com` auf `/example.com`. Ein Proxy, der weiterhin die alten Routen verwendet, kann 404-Fehler zurückgeben, selbst wenn die Basisdomäne erreichbar ist. Überprüfen Sie nach der Bearbeitung einer Proxy-Datei deren Syntax mit dem Testbefehl des Servers, laden Sie ihn neu und testen Sie anschließend die Discovery-URL erneut und öffnen Sie ein Dokument.loleafletbrowser
Prüfen Sie die Zugriffs- und Fehlerprotokolle zum gleichen Zeitpunkt wie den fehlgeschlagenen Zugriffsversuch. Ein 404-Fehler /browserdeutet auf eine /coolfehlerhafte Pfadumleitung hin; ein fehlgeschlagenes WebSocket-Upgrade lässt auf eine fehlende Upgrade-Verarbeitung oder ein Timeout schließen; ein 502-Fehler bedeutet in der Regel, dass der Proxy den Collabora-Upstream nicht erreichen kann. Dies sind Hinweise, keine endgültigen Diagnosen. Vergleichen Sie sie daher mit dem Collabora-Protokoll.
WOPI (Web Application Open Platform Interface) ist das Protokoll, das Nextcloud und Collabora für den Austausch von Dokumentenzugriffsanfragen verwenden. Falls im Collabora-Log „Keine akzeptablen WOPI-Hosts gefunden“ oder ein nicht autorisierter WOPI-Host gemeldet wird, überprüfen Sie, ob Collabora so konfiguriert ist, dass es dem Nextcloud-Hostnamen vertraut – und nicht dem eigenen Collabora-Hostnamen. Untersuchen Sie mithilfe des Docker-Images die Startkonfiguration und die Logs des Containers.
docker ps
docker logs --tail=100 CONTAINER_NAMEErsetzen Sie dies CONTAINER_NAMEdurch den tatsächlichen Namen des Collabora-Containers. Überprüfen Sie bei einer nativen Paketinstallation das Service-Log mit dem Befehl `docker log` sudo journalctl -u coolwsd --since "15 minutes ago". Befolgen Sie die WOPI-Hostkonfigurationsanweisungen für Ihre Installationsmethode; vermeiden Sie weit gefasste Wildcard-Regeln.
In Nextcloud Office gibt es außerdem eine separate WOPI-Zulassungsliste. Diese beschränkt die IP-Adressen der Collabora-Server, die Dateien von Nextcloud anfordern dürfen. Tragen Sie die Quell-IP-Adresse ein, die Nextcloud tatsächlich für Collabora sieht. Diese kann abweichen, wenn Docker-Netzwerke oder ein Reverse-Proxy verwendet werden. Aktivieren 0.0.0.0oder deaktivieren Sie die Beschränkung nicht nur, um eine Fehlermeldung zu unterdrücken: Nextcloud empfiehlt, WOPI-Anfragen auf die erwarteten Collabora-Serveradressen zu beschränken.
Führen Sie einen erneuten Test vom Browser eines Benutzers und vom Nextcloud-Server aus durch: Die Discovery- und Capabilities-Endpunkte sollten antworten, Nextcloud sollte die konfigurierte Collabora-URL erreichen und Collabora sollte den Status-Endpunkt von Nextcloud erreichen. Öffnen Sie anschließend ein kleines Testdokument. Falls der Fehler weiterhin besteht, notieren Sie den Zeitstempel, die betroffene Dokumentaktion, den HTTP- oder WebSocket-Status im Proxy-Log sowie die entsprechenden Logeinträge von Nextcloud und Collabora. Diese Informationen helfen, einen Netzwerkfehler von einem WOPI-Autorisierungsproblem zu unterscheiden.
Sichern Sie die Datei coolwsd.xml und ihre Bereitstellungsquellen, stellen Sie sie sicher wieder her und überprüfen Sie den CODE, bevor die Benutzer die Bearbeitung wieder aufnehmen.
Erlauben Sie den genauen Ursprung von Nextcloud oder einer anderen WOPI-Instanz im CODE, überprüfen Sie dann die aktive Host-Zulassungsliste und unterscheiden Sie diese von der Quell-IP-Beschränkung von Nextcloud.
Analysieren Sie die Browser-, WOPI- und WebSocket-Verbindungen von Collabora, um herauszufinden, warum sich ein Dokument nicht öffnen lässt, und wenden Sie dann die Lösung an, die zu Ihrer Nextcloud-Konfiguration passt.
Mit Helm können Collabora CODE-Replikate bereitgestellt werden, wobei jedes Dokument über WOPI-Affinität auf einem Pod verbleibt, und Ingress, Knotenplatzierung und Nextcloud-Bearbeitung können überprüft werden.
Verfolgen Sie einen fehlgeschlagenen Socket-Handshake vom Browser zu coolwsd und gleichen Sie dann die Reverse-Proxy-Route mit Ihrer Collabora-Version ab, einschließlich der Apache-Änderung CODE 26.04.
Verfolgen Sie Collabora WOPI-Beweisfehler auf nicht übereinstimmende Schlüssel, veraltete Erkennungsdaten, Zeitabweichungen oder Änderungen der Proxy-URL – ohne die Validierung zu schwächen.
Browserzoom zurücksetzen, eine saubere Sitzung testen und feststellen, wann ein fehlerhaftes Größenmenü ein Collabora-Server-Update erfordert.
Setzen Sie Collabora CODE mit Docker ein, verbinden Sie es sicher mit Nextcloud Office und überprüfen Sie die Dokumentbearbeitung mit praktischen WOPI- und Proxy-Prüfungen.
Aktivieren Sie vorübergehend coolwsd für den Debug-Modus, erfassen Sie einen fehlgeschlagenen Öffnungsvorgang und verwenden Sie die Protokollsequenz, um WebSocket-, WOPI-, Proxy- und Containerprobleme zu unterscheiden.
Konfigurieren Sie den Collabora Online-Admin-Login für Docker oder Linux, starten Sie den richtigen Dienst neu und überprüfen Sie das neue Passwort, ohne es preiszugeben.
