Collabora Online: Schwarzer Bildschirm oder leeres Dokument beim Laden beheben

Überprüfen Sie zunächst die WebSocket-Verbindung und die Erreichbarkeit der beiden Server. Wenn ein Collabora Online-Editor einen schwarzen Bildschirm, eine weiße Seite oder eine leere Dokumentansicht anzeigt, funktioniert er oft nicht, bevor die Benutzeroberfläche des Dokuments vollständig geladen ist. Betrifft das Problem alle Dateien, überprüfen Sie zuerst die Verbindung zwischen Browser und Collabora, den Reverse-Proxy und die Verbindung zwischen Nextcloud und Collabora. Wenn nur eine Datei betroffen ist, testen Sie ein anderes Dokument und überprüfen Sie dessen Berechtigungen und Format, bevor Sie die Servereinstellungen ändern.

Gehen Sie folgendermaßen vor: Überprüfen Sie den Browser, testen Sie die Discovery-Endpunkte von Collabora, lesen Sie die Integrations- und Serverprotokolle und korrigieren Sie anschließend nur die Proxy- oder WOPI-Einstellung, auf die die Ergebnisse hinweisen. Das Leeren des Browser-Caches kann veraltete Ressourcen entfernen, behebt aber weder eine fehlerhafte WebSocket-Verbindung noch einen nicht erreichbaren WOPI-Host. Die untenstehenden Abbildungen der Benutzeroberfläche sind schematische Beispiele; die genauen Bezeichnungen und Anfragepfade variieren je nach Browser, Cloud-Plattform, Proxy und Collabora-Version.

Schnelle Diagnose anhand der Symptome

1. Ermitteln Sie, ob das Problem browserseitig oder serverseitig auftritt.

Öffnen Sie zunächst ein zweites Dokument, von dem Sie wissen, dass es lesbar ist, und versuchen Sie, dieselbe Datei in einem anderen Browser oder im privaten Fenster zu öffnen. Falls sich ein Dokument nicht öffnen lässt, andere jedoch schon, prüfen Sie, ob der Benutzer es weiterhin in der Dateiplattform herunterladen oder in der Vorschau anzeigen kann. Eine beschädigte Datei, ein nicht unterstütztes Format, eine abgelaufene Freigabe oder fehlende Berechtigungen können wie ein Problem mit dem Editor aussehen, aber das Ändern des Reverse-Proxys behebt kein dateispezifisches Problem.

Um dies im Browser zu überprüfen, öffnen Sie die Entwicklertools, bevor Sie das leere Dokument neu laden. Drücken Sie in Chromium-basierten Browsern die Strg-Taste F12oder Strg Ctrl+Shift+I+Umschalt+Eingabe, wählen Sie „Netzwerk“ , aktivieren Sie „Protokoll beibehalten “ und laden Sie die Seite neu. Filtern Sie nach „“ ws, cool„“ oder browser„“. Überprüfen Sie außerdem die Registerkarte „Konsole“ auf blockierte Skripte, Zertifikatswarnungen oder Fehler der Inhaltssicherheitsrichtlinie.

Ein fehlgeschlagener Request deutet auf /cool/…/wsein Problem mit dem WebSocket-Handshake oder dem Proxy hin. Ein „false“ 502bedeutet in der Regel, dass der Proxy keine verwertbare Antwort vom Upstream-Server erhalten konnte; ein „false“ 404kann bedeuten, dass der Pfad nicht geroutet wird; und ein „false“ 403kann auf einen abgelehnten Host oder eine ungültige Zugriffsregel hinweisen. Diese Statuscodes grenzen die Suche ein, aber die entsprechenden Proxy- und Collabora-Logs werden benötigt, um die genaue Ursache zu ermitteln. Wenn die fehlgeschlagenen Requests JavaScript- oder CSS-Dateien im Verzeichnis „/var/log/“ betreffen /browser, überprüfen Sie, ob der Proxy diese statischen Assets an den Collabora-Dienst weiterleitet.

Wenn die Netzwerkanfragen in einem privaten Fenster erfolgreich sind, deaktivieren Sie vorübergehend Browsererweiterungen, die Skripte oder seitenübergreifende Anfragen blockieren. Löschen Sie anschließend die Websitedaten nur für die Hostnamen von Cloud und Collabora. Testen Sie erneut, bevor Sie die Serverkonfiguration ändern. Leeren Sie den Cache nicht als Hauptlösung, wenn dieselbe Anfrage im Netzwerk-Tab weiterhin fehlschlägt.

2. Bestätigen Sie die Collabora-URL und die Discovery-Endpunkte.

Überprüfen Sie für eine Nextcloud-Integration die Collabora Online-Server-URL in den Office-Verwaltungseinstellungen. Verwenden Sie die öffentliche URL, die Browser erreichen können, mit dem korrekten Hostnamen und Port. Laut Nextcloud-Richtlinien sollten Collabora und Nextcloud dasselbe Protokoll verwenden; HTTPS wird empfohlen. Eine Diskrepanz, z. B. wenn ein Dienst über HTTPS konfiguriert ist, http://der andere jedoch über HTTPS erreichbar ist, https://kann zu blockierten Anfragen mit gemischten Inhalten oder fehlgeschlagenen Rückrufen führen.

Öffnen Sie auf dem betroffenen Client in einem Browser die URL https://office.example.com/hosting/discoveryund https://office.example.com/hosting/capabilitiesersetzen Sie den Beispiel-Hostnamen durch Ihren eigenen. Der Discovery-Endpunkt sollte eine XML-Beschreibung der unterstützten Dokumentaktionen zurückgeben; die Capabilities-Funktion sollte eine Antwort vom Collabora-Server liefern. Ein Browserfehler, eine Anmeldeseite, ein Proxy-Fehler (404) oder ein Gateway-Fehler bedeutet, dass die öffentliche Route den erwarteten Collabora-Endpunkt nicht erreicht.

Testen Sie anschließend vom Nextcloud-Host aus, denn ein Browsertest allein beweist nicht, dass die Server miteinander kommunizieren können:

curl -sS -o /dev/null -w "%{http_code}\n" https://office.example.com/hosting/discovery
curl -sS -o /dev/null -w "%{http_code}\n" https://office.example.com/hosting/capabilities

Ersetzen Sie dies office.example.comdurch den konfigurierten Collabora-Hostnamen. Eine erfolgreiche HTTP-Antwort dient als hilfreicher Erreichbarkeitstest. Bei einem Timeout, DNS-Fehler, TLS-Fehler oder einer 5xx-Antwort muss die Lösung auf der entsprechenden Netzwerk-, Zertifikats-, DNS- oder Proxy-Ebene erfolgen. Bei Installationen, bei denen der Collabora-Server Nextcloud kontaktieren muss, testen Sie zusätzlich die Nextcloud-Status-URL vom Collabora-Host aus.

curl -fsS https://cloud.example.com/status.php

Verwenden Sie Ihren tatsächlichen Nextcloud-Hostnamen. Bei integrierten CODE-Installationen kann anstelle eines separaten öffentlichen Collabora-Hostnamens eine interne Proxy-URL verwendet werden. Befolgen Sie daher die Anweisungen für diese Bereitstellung, anstatt das Beispiel für einen eigenständigen Server wörtlich anzuwenden.

3. Überprüfen Sie die WebSocket-Route und den Reverse-Proxy.

Collabora stellt Browserressourcen und Dokumentsitzungen über verschiedene Routen bereit. Ein Reverse-Proxy muss die von der installierten Version erwarteten Pfade weiterleiten, einschließlich der Editorressourcen, der Discovery- und Capabilities-Endpunkte sowie der WebSocket-Route für Dokumente. Die aktuelle Collabora-Dokumentation verwendet die alte /cool/…/wsPfadkonfiguration; ältere Installationen können noch Konfigurationen für diese alten /loolPfade enthalten. Die Migrationsdokumentation von Nextcloud beschreibt die historischen Pfadänderungen von der loleafletalten browserzur neuen loolPfadkonfiguration cool.

Prüfen Sie in Ihrer Proxy-Konfiguration, ob der WebSocket-Standort vor den allgemeinen Catch-All-Regeln abgeglichen wird, ob der Proxy die erforderlichen Upgrade-Header für Ihre Proxy-Software weiterleitet und ob der Upstream auf den tatsächlichen Collabora-Dienst und -Port verweist. Stellen Sie außerdem sicher, dass der Proxy die erwarteten Host- und Schema-Informationen beibehält und dauerhafte Verbindungen ermöglicht. Falls TLS am Proxy endet, überprüfen Sie, ob die SSL-Terminierungseinstellungen von Collabora diesem Design entsprechen.

Der obige Codeausschnitt zeigt die Art von WebSocket-Headern, die ein Nginx-Proxy benötigen könnte; es handelt sich nicht um eine vollständige Proxy-Konfiguration. Fügen Sie ihn nicht einfach ein und kombinieren Sie keine Direktiven aus verschiedenen Versionen. Vergleichen Sie Ihre vollständige Konfiguration mit der offiziellen Collabora-Anleitung für Reverse-Proxys für den verwendeten Proxy und die Collabora-Version. Überprüfen Sie nach der Bearbeitung einer Proxy-Datei deren Syntax mit dem Befehl `configuration-test` des Servers, bevor Sie sie neu laden.

4. WOPI-Hostvalidierung und Serverprotokolle prüfen

Collabora verwendet WOPI (Web Application Open Platform Interface), um Dokumente von einem verbundenen Speicherdienst wie Nextcloud anzufordern. Der Collabora-Server muss den WOPI-Host akzeptieren, und der Speicherserver muss den Collabora-Dienst erreichen können. Überprüfen Sie in Nextcloud die Office-Einstellungen und die Liste der zulässigen WOPI-Anfragen. Fügen Sie nur die Adresse des erwarteten Collabora-Servers hinzu; deaktivieren Sie nicht die Host-Validierung und erlauben Sie keine beliebigen Hosts, um einen leeren Bildschirm zu entfernen.

Lesen Sie die Protokolle zu dem Zeitpunkt, an dem das Problem auftritt. Für eine Docker-Bereitstellung beschreibt die Nextcloud-Fehlerbehebungsanleitung die Überprüfung des Containerprotokolls; verwenden Sie den tatsächlichen Containernamen oder die ID:

docker logs --tail 100 collabora

Bei einer paketbasierten Installation hängen Dienstnamen und Protokollspeicherorte vom Betriebssystem und der Paketversion ab. Eine gängige systemd-Prüfung ist:

sudo journalctl -u coolwsd -n 100 --no-pager

Suchen Sie nach übereinstimmenden Zeitstempeln und Fehlermeldungen bezüglich eines nicht autorisierten WOPI-Hosts, einer fehlgeschlagenen CheckFileInfoAnfrage, einer TLS-Verifizierung, nicht verfügbaren Speichers oder eines fehlgeschlagenen WebSockets. Die Meldung „Kein akzeptabler WOPI-Host gefunden“ bedeutet in der Regel, dass der für die Integration konfigurierte Speicherhostname nicht mit den von Collabora zugelassenen Hosts übereinstimmt. Korrigieren Sie den Hostnamen oder den Eintrag in der Zulassungsliste, anstatt nicht zugehörige Domains hinzuzufügen.

Prüfen Sie außerdem das Dateiplattform-Protokoll für denselben Anfragezeitpunkt. Falls Collabora Nextcloud nicht erreichen kann, überprüfen Sie die DNS-Auflösung vom Collabora-Host, Firewall-Regeln, die öffentliche oder interne Route sowie, ob der Dienst versucht, sich selbst über einen Hostnamen zu erreichen, der innerhalb des Containernetzwerks anders aufgelöst wird. Das Nextcloud-Handbuch zur Fehlerbehebung empfiehlt, die Konnektivität in beide Richtungen zu prüfen und die Serverprotokolle zu verwenden, um die fehlerhafte Seite zu identifizieren.

5. Testen Sie das Dokument erneut und nehmen Sie nur gezielte Änderungen vor.

Nachdem Sie eine Route, URL, ein Zertifikat oder einen Eintrag in der Zulassungsliste korrigiert haben, laden Sie den Proxy und die betroffenen Dienste nur dann neu, wenn dies für Ihre Bereitstellung erforderlich ist. Öffnen Sie die Entwicklertools erneut, laden Sie die Datei neu und überprüfen Sie, ob die zuvor fehlgeschlagene Anfrage nun erfolgreich abgeschlossen wurde. Das Dokument sollte seine Seiten oder Tabellenblätter rendern, eine kleine Änderung akzeptieren und diese erfolgreich speichern. Eine leere Seite, die verschwindet, aber nicht gespeichert werden kann, deutet weiterhin auf eine nicht aufgelöste WOPI- oder Speicherverbindung hin.

• Die Erkennung funktioniert, aber WebSocket schlägt fehl: Fokus auf die WebSocket-Route des Proxys, die Upgrade-Verarbeitung, die Upstream-Adresse und das Verbindungs-Timeout.
• Der Browser kann Collabora erreichen, Nextcloud jedoch nicht: Testen Sie DNS, Firewall, TLS-Vertrauensstellung und Routing vom Nextcloud-Host aus.
• Collabora meldet einen nicht autorisierten WOPI-Host: Vergleichen Sie den genauen Speicherhostnamen in den Integrationseinstellungen mit der WOPI-Host-Zulassungsliste.
• Nur ältere Installationen schlagen nach einem Upgrade fehl: Vergleichen Sie die Proxy-Pfade mit der Dokumentation der installierten Version und aktualisieren Sie gegebenenfalls veraltete /loolRouten /loleaflet.
• Nur eine Datei schlägt fehl, nachdem die Verbindungsprüfungen erfolgreich waren: Überprüfen Sie den Dateizugriff und testen Sie eine Kopie oder ein anderes unterstütztes Format, bevor Sie die globalen Einstellungen ändern.

So sieht eine erfolgreiche Reparatur aus

Ein zuverlässiges Ergebnis erfordert mehr als nur das Erscheinen der Editor-Symbolleiste. Der Dokumentinhalt wird korrekt dargestellt, es treten keine anhaltenden Fehler im Editor oder bei WebSocket-Anfragen auf, und eine harmlose Testbearbeitung wird gespeichert und bleibt auch nach dem Aktualisieren erhalten. Sollte das Problem weiterhin bestehen, speichern Sie bitte einen kurzen, anonymisierten Auszug aus der Netzwerk-/Konsolenausgabe Ihres Browsers sowie die entsprechenden Logzeilen von Nextcloud, Proxy und Collabora. Logs können Hostnamen, Benutzernamen, Dateikennungen oder Tokens enthalten. Entfernen Sie daher sensible Daten, bevor Sie die Logs weitergeben.

Für die spezifischen Schritte Ihrer aktuellen Bereitstellung konsultieren Sie bitte den Nextcloud Office-Leitfaden zur Fehlerbehebung , die Nextcloud Office-Konfigurationsreferenz und die Hinweise zur Collabora-Migration . Die genauen Prüfungen für ownCloud, einen anderen WOPI-Host, einen integrierten CODE-Dienst oder eine Containerplattform können von den Nextcloud-Beispielen abweichen.