Was Sie überprüfen sollten, wenn ownCloud Web eine leere Seite anzeigt

Wenn ownCloud Web eine weiße Seite anzeigt, versuchen Sie zunächst, dieselbe URL in einem privaten Fenster und mit einem aktuell unterstützten Browser aufzurufen. Falls das Problem weiterhin besteht, öffnen Sie die Entwicklertools Ihres Browsers und überprüfen Sie die Bereiche „Konsole“ und „Netzwerk“. Anhand der fehlgeschlagenen Anfrage können Sie entscheiden, ob Sie Browserdaten löschen, eine fehlende Webressource reparieren oder die Dienste „Unendliche Skalierung“ und „Reverse-Proxy“ überprüfen möchten. Löschen Sie vor dieser Überprüfung keine Serverdaten und installieren Sie die Instanz nicht neu.

ownCloud Web ist die mit Infinite Scale ausgelieferte Weboberfläche. Administratoren können die vorkompilierten Ressourcen jedoch durch eine benutzerdefinierte Version ersetzen. Eine leere Seite kann daher durch den Browser, eine fehlende oder nicht passende JavaScript-Datei oder eine Server-/Proxy-Antwort verursacht werden, die das Laden der Oberfläche verhindert. Die folgenden Schritte unterscheiden diese Fälle. Die Oberflächenbereiche dienen als Beispiele; vergleichen Sie sie mit der tatsächlichen Browser- und Bereitstellungsausgabe.

1. Ermitteln Sie, ob das Problem lokal oder serverweit auftritt.

Bitten Sie einen anderen Benutzer, dieselbe öffentliche URL zu öffnen, und testen Sie es selbst in einem privaten Fenster. Wenn beispielsweise ein Mitarbeiter eine leere Seite sieht, während ein Kollege Dateien durchsuchen kann, prüfen Sie zunächst browserspezifische Ursachen. Sehen alle dieselbe Seite, überprüfen Sie direkt das Netzwerk und den Server.

  1. Verwenden Sie einen von ownCloud Web unterstützten Desktop-Browser. Auf der Seite mit den aktuellen Systemanforderungen finden Sie die neuesten Versionen von Chrome, Firefox und Edge sowie Safari 16 oder höher für unterstützte Desktop-Betriebssysteme.
  2. Öffnen Sie die Instanz in einem privaten Fenster. Falls die Benutzeroberfläche dort geladen wird, deaktivieren Sie die Erweiterungen im normalen Profil nacheinander und löschen Sie anschließend die Websitedaten nur für den ownCloud-Hostnamen. Durch das Löschen der Websitedaten werden Sie abgemeldet; die auf dem Server gespeicherten Dateien bleiben jedoch erhalten.
  3. Aktualisieren Sie die leere Seite bei deaktiviertem Browser-Cache und geöffneten Entwicklertools. Tritt der Fehler weiterhin in mehreren unterstützten Browsern und bei mehreren Benutzern auf, liegt wahrscheinlich ein serverseitiges Problem oder ein Problem mit der Bereitstellung vor.

Beispielhaftes Browserfenster mit einer vollständig leeren weißen Seite unter dem Beispiel-Cloud-Hostnamen

Veranschaulichung des Symptoms: Ein Browser hat den Cloud-Host erreicht, aber der Seiteninhaltsbereich bleibt leer.

2. Verwenden Sie die fehlgeschlagene Anfrage, um eine Lösung auszuwählen.

Öffnen Sie die Entwicklertools (normalerweise F12 oder Strg+Umschalt+I unter Windows/Linux bzw. Option+Befehl+I unter macOS). Wählen Sie „Konsole“ , um JavaScript-Fehler anzuzeigen, anschließend „Netzwerk“ , laden Sie die Seite neu und suchen Sie nach fehlgeschlagenen Anfragen. Der Statuscode und der Anfragetyp sind aussagekräftiger als ein weißer Bildschirm allein.

  • Eine JavaScript- oder CSS-Anfrage liefert den Fehlercode 404: Der Browser hat eine Ressource angefordert, die unter der angegebenen URL nicht gefunden wurde. Tritt dieses Problem nur bei einem Browserprofil auf, löschen Sie den Cache dieser Website und laden Sie sie neu. Wenn die gleiche Ressource bei allen Benutzern nicht gefunden wird, überprüfen Sie den Pfad der Ressource, das Reverse-Proxy-Routing und alle benutzerdefinierten Web-Builds.
  • Eine Anfrage liefert den Statuscode 502, 503 oder einen Verbindungsfehler zurück: Der Proxy konnte keine verwertbare Antwort von einem Upstream-Dienst erhalten, oder der Dienst war nicht verfügbar. Überprüfen Sie den Bereitstellungsstatus und die Protokolle, bevor Sie die Browsereinstellungen ändern.
  • Die Konsole meldet eine blockierte Anfrage, einen Zertifikatsfehler oder eine Warnung wegen gemischter Inhalte: Vergleichen Sie den öffentlichen Hostnamen und das vom Browser verwendete HTTPS-Schema mit der URL und der Proxy-Konfiguration. Wenn Sie kürzlich die Domain, die TLS-Terminierung oder die Proxy-Regeln geändert haben, testen Sie diese Änderung zuerst.
  • Die Seite lädt die Assets mit einem 200-Statuscode, aber JavaScript schlägt weiterhin fehl: Notieren Sie den ersten Konsolenfehler und die ownCloud Web-/Infinite Scale-Versionen. Ein Syntax- oder Laufzeitfehler kann auf eine inkompatible benutzerdefinierte Version oder Erweiterung hinweisen; schließen Sie dies nicht allein aus einem 200-Statuscode.

Beispiel einer 404-Fehlermeldung für eine JavaScript-Datei in der Entwicklerkonsole des Browsers (Beispielausgabe einer JavaScript-Datei).

Beispielhafte Veranschaulichung der Diagnose: Ein 404-Fehler für eine JavaScript-Datei ist ein Hinweis darauf, die URL der Datei und den Bereitstellungspfad zu überprüfen, aber kein Beweis für eine bestimmte Ursache.

3. Überprüfen Sie die Webressourcen und den Zustand der Dienste.

Wenn die fehlgeschlagene Anfrage eine Ressource betrifft, prüfen Sie zunächst, ob Ihre Instanz die mitgelieferten ownCloud-Webdateien oder benutzerdefinierte, kompilierte Dateien verwendet. Laut ownCloud 8.2-Administratorhandbuch verweist WEB_ASSET_PATHdie Variable auf benutzerdefinierte, kompilierte Webclient-Ressourcen. Falls Sie diese Variable festgelegt haben, überprüfen Sie, ob der Pfad innerhalb der laufenden Bereitstellung existiert, den vollständigen Build enthält und vom Prozess, der die Weboberfläche bereitstellt, lesbar ist. Wenn Sie keine benutzerdefinierten Ressourcen verwenden, fügen Sie diese Variable nicht als spekulative Lösung hinzu.

Führen Sie für eine Docker Compose-Bereitstellung diese Befehle im Verzeichnis aus, das die Compose-Datei enthält:

docker compose ps
docker compose logs --tail=100 ocis

Der erste Befehl zeigt an, ob Dienste ausgeführt werden; der zweite gibt die aktuellen Protokolle des Dienstes mit dem angegebenen Namen aus ocis. Falls Ihre Compose-Datei einen anderen Dienstnamen verwendet oder das Frontend separat ausführt, ersetzen Sie den angegebenen Dienstnamen durch den tatsächlichen Dienstnamen und überprüfen Sie auch die Proxy-/Frontend-Protokolle. Verwenden Sie bei einer manuell installierten oder orchestrierten Bereitstellung stattdessen die entsprechenden Dienst- und Protokollierungsbefehle der Plattform. Suchen Sie nach Startfehlern, Fehlern im Asset-Pfad oder Upstream-Verbindungsfehlern zum Zeitpunkt des fehlgeschlagenen Seitenaufrufs.

Beispielhafte Terminalausgabe mit den Befehlen `docker compose ps` und `docker compose logs` ohne Beispielausgabe

Abbildung der beiden Compose-Prüfungen; die tatsächlichen Dienstnamen und Protokollmeldungen variieren je nach Bereitstellung.

4. Überprüfen Sie die öffentliche URL und die Proxy-Route.

Wenn Anfragen auf einen alten Hostnamen, ein falsches Schema oder einen vom Proxy nicht bedienten Pfad verweisen, überprüfen Sie die Konfiguration der öffentlichen URL und die Proxy-Regeln. ownCloud dokumentiert OCIS_URLdie URL, die den Zugriff auf Infinite Scale definiert. Stellen Sie bei einer Bereitstellung mit einem Reverse-Proxy sicher, dass die HTTPS-Adresse für den Browser, der DNS-Name und die Routing-Regeln mit der konfigurierten öffentlichen URL übereinstimmen. Wurde der Proxy oder die Domain kürzlich geändert, vergleichen Sie die aktuelle Konfiguration mit der letzten funktionierenden Version und korrigieren Sie nur die abweichenden Werte.

Prüfen Sie WEB_ASSET_PATHnur, ob benutzerdefinierte Assets konfiguriert sind. Überprüfen Sie OCIS_URLdie Proxy-/TLS-Einstellungen, wenn der Browser auf einen unerwarteten Host umgeleitet wird oder Assets von der falschen Quelle anfordert. Diese Einstellungen variieren je nach Bereitstellung. Verwenden Sie daher keine generischen Beispielwerte in der Produktionsumgebung. Die offizielle ownCloud Web-Anleitung für benutzerdefinierte Assets , die Dokumentation zum Proxy-Dienst und die TLS-Anleitung beschreiben diese Konfigurationsbereiche.

Illustrativer Konfigurationseditor, der WEB_ASSET_PATH und OCIS_URL für Bereitstellungsprüfungen hervorhebt

Abbildung der zu prüfenden Konfigurationswerte; die korrekten Werte hängen von der öffentlichen URL und der Verwendung benutzerdefinierter Assets ab.

Überprüfen Sie die Korrektur

Laden Sie die Website in einem normalen Browserfenster neu und prüfen Sie, ob die Benutzeroberfläche korrekt angezeigt wird, die Konsole keine blockierenden JavaScript-Fehler mehr meldet und erforderliche JavaScript-/CSS-Anfragen keine 404- oder 5xx-Fehler mehr zurückgeben. Bitten Sie einen zweiten Benutzer, dieselbe öffentliche Adresse zu testen. Falls die Seite trotz erfolgreichem Laden der Inhalte weiterhin leer bleibt, speichern Sie den ersten Konsolenfehler, die Details der fehlgeschlagenen Anfrage, die Infinite Scale-Version und die relevanten Serviceprotokolle für Ihren Administrator oder den ownCloud-Support. Schwärzen Sie Cookies, Autorisierungsheader und Tokens, bevor Sie die Browseraufzeichnungen weitergeben.

Einen Kommentar hinterlassen

Mit dem richtigen Backend können Sie ownCloud-Dateisperr-Timeouts verhindern.

Unterscheiden Sie Datenbank-Sperrkonflikte von abgelaufenen WebDAV-Sperren und wählen und konfigurieren Sie dann die richtige ownCloud 10-Lösung.

Was Sie überprüfen sollten, wenn ownCloud Web eine leere Seite anzeigt

Was Sie überprüfen sollten, wenn ownCloud Web eine leere Seite anzeigt

Verfolgen Sie mithilfe gezielter Prüfungen, ob ein leerer ownCloud-Webbildschirm auf den Browser-Cache, fehlende Webressourcen, Dienstfehler oder Reverse-Proxy-URL-Einstellungen zurückzuführen ist.

Beheben Sie die ownCloud PHP-Speicherwarnung in der richtigen Laufzeitumgebung.

Legen Sie das Web-PHP-Speicherlimit von ownCloud fest, starten Sie den entsprechenden Dienst neu und überprüfen Sie den aktiven Wert, ohne ihn mit CLI-Einstellungen oder Upload-Limits zu verwechseln.

Behebung von Verbindungsfehlern bei ownCloud 10 MySQL

Prüfen Sie, ob MySQL, PHP, Socket-Einstellungen oder Datenbankberechtigungen ownCloud 10 blockieren, und überprüfen Sie anschließend eine sichere Lösung.

Legen Sie ein festes Ablaufdatum für ownCloud Public Links fest

Legen Sie ein festes Ablaufdatum für ownCloud Public Links fest

Machen Sie das Ablaufdatum öffentlicher Links in ownCloud Classic obligatorisch, legen Sie eine maximale Lebensdauer fest und prüfen Sie vorhandene Freigaben, die möglicherweise separat bereinigt werden müssen.

Fügen Sie die TOTP-Zwei-Faktor-Anmeldung mit Keycloak zu ownCloud Infinite Scale hinzu.

Fügen Sie die TOTP-Zwei-Faktor-Anmeldung mit Keycloak zu ownCloud Infinite Scale hinzu.

Aktivieren Sie TOTP über Keycloak, registrieren Sie Benutzer sicher und verstehen Sie, wann die MFA-Einstellungen auf Routenebene von Infinite Scale Anwendung finden.

Stellen Sie ownCloud Sync wieder her, indem Sie den Client mit Ihrem Server abgleichen.

Prüfen Sie, ob es sich um einen Kompatibilitätsfehler zwischen OC10 und 7.x oder um ein beschädigtes CSync-Journal handelt, und wenden Sie dann die richtige Lösung an, ohne synchronisierte Dateien zu löschen.

ownCloud mit Let's Encrypt und Nginx über HTTPS schützen

ownCloud mit Let's Encrypt und Nginx über HTTPS schützen

Wählen Sie HTTP-01 oder DNS-01, konfigurieren Sie einen ownCloud Reverse-Proxy und vergewissern Sie sich, dass Certbot HTTPS-Zertifikate automatisch erneuert.

Verbinden Sie ownCloud Infinite Scale mit LDAP für die Benutzeranmeldung.

Konfigurieren Sie die oCIS LDAP-Anmeldung, gleichen Sie Benutzer- und Gruppenabfragen ab und überprüfen Sie die TLS- und Schemaeinstellungen vor der Einführung.

Verbinden Sie einen S3-Bucket mit ownCloud 10 als externen Speicher

Verbinden Sie einen S3-Bucket mit ownCloud 10 als externen Speicher

Fügen Sie ownCloud 10 einen Amazon S3-Bucket hinzu, bereiten Sie kompatible Anmeldeinformationen und Endpunkte vor und prüfen Sie den Zugriff, ohne eine Einbindung mit dem primären Speicher zu verwechseln.