Nextcloud-Warnung „Einige Dateien haben die Integritätsprüfung nicht bestanden“ beheben

Nach einem Update oder einer manuellen Änderung kann es vorkommen, dass in der Nextcloud-Admin-Übersicht die Meldung „Einige Dateien haben die Integritätsprüfung nicht bestanden“ angezeigt wird. Diese Warnung kann beunruhigend sein, weist aber nicht auf einen allgemeinen Fehler hin. Nextcloud prüft, ob der installierte Server- und App-Code mit den erwarteten signierten Dateien übereinstimmt. Eine geänderte oder fehlende Datei, eine unerwartete Datei oder ein Problem mit der App-Signatur kann diese Warnung auslösen. Ein erneuter Scan zeigt den aktuellen Status an; er repariert die Dateien jedoch nicht.

Auf der offiziellen Nextcloud-Downloadseite wird Server 35.0.0, veröffentlicht am 16. September 2026, als aktuellste Version (Stand: [Datum einfügen]) aufgeführt. Die aktuelle Administrationsdokumentation empfiehlt Administratoren weiterhin, den Bericht über ungültige Dateien zu prüfen, die Ursache zu beheben und einen erneuten Scan durchzuführen. Die folgenden Schritte folgen diesem bewährten Verfahren; die genaue Menübezeichnung kann je nach Version oder Hosting-Paket variieren.

1. Lesen Sie den Bericht über die ungültige Datei, bevor Sie Änderungen vornehmen.

Melden Sie sich als Administrator an und öffnen Sie die Administrationseinstellungen > Übersicht . Wählen Sie in der Integritätswarnung die Option „Liste ungültiger Dateien…“ (die Bezeichnung kann leicht abweichen). Speichern oder kopieren Sie den Bericht an einem sicheren Ort, um ihn nach einer Reparatur vergleichen zu können. Er identifiziert die Anwendung oder den Kernbereich und listet Bedingungen wie beispielsweise „…“, „…“, INVALID_HASH„ MISSING_FILE… EXTRA_FILE“ und „… “ auf EXCEPTION.

Sichern Sie die Nextcloud-Konfiguration, die Datenbank und jeglichen benutzerdefinierten Anwendungscode, bevor Sie Serverdateien ersetzen. Bearbeiten Sie keine Dateien signature.json, erstellen Sie keine Ersatzsignatur, um die Warnung zu unterdrücken, und entfernen Sie keine Dateien, nur weil deren Namen im Bericht erscheinen. Die Prüfung schützt die Code-Authentizität und kann zudem unerwartete Dateien aufdecken, die einer Untersuchung bedürfen.

2. Ordnen Sie den Fehlertyp der richtigen Reparatur zu.

Diese Kennzeichnungen dienen der Diagnose und sind kein Beweis für einen Angriff oder die Sicherheit der Installation. Lokale Änderungen eines Entwicklers, kopierte Sicherungsdateien, unvollständige Bereitstellungen oder nicht autorisierter Code können zu abweichenden Ergebnissen führen. Sollten Sie eine unerwartete PHP-Datei oder eine geänderte Core-Datei nicht erklären können, speichern Sie den Bericht und untersuchen Sie ihn, bevor Sie ihn löschen oder überschreiben.

3. Stellen Sie die Kerndateien aus der exakten Nextcloud-Version wieder her.

Wenn im Bericht Dateien unter „/usr/bin“ corewie beispielsweise „ index.php/usr/bin version.php“ oder „/usr/bin“ aufgeführt sind, prüfen Sie zunächst, ob ein Upgrade abgebrochen wurde oder der Code im Rahmen eines Bereitstellungsprozesses verändert wurde. Bestätigen Sie die installierte Version in der Administratorübersicht oder anhand Ihrer üblichen Bereitstellungsprotokolle. Kopieren Sie keine Datei aus einer anderen Nextcloud-Version: Deren Hashwert stimmt nicht mit der auf dem Server installierten Version überein.

Verwenden Sie nach Möglichkeit den unterstützten Updater, um ein unterbrochenes Upgrade abzuschließen. Falls Sie Dateien manuell wiederherstellen müssen, laden Sie das passende Serverarchiv von der offiziellen Nextcloud-Downloadseite herunter, verifizieren Sie das Archiv anhand der veröffentlichten Prüfsumme oder PGP-Signatur und ersetzen Sie gemäß den Nextcloud-Upgrade-Anweisungen nur die betroffenen Anwendungsdateien. Sichern Sie config/das Datenverzeichnis sowie alle lokal verwalteten Apps oder Themes. Befolgen Sie die für Ihre Installationsmethode vorgesehenen Backup- und Wartungsmodus-Verfahren. Docker, Snap, Appliances und Managed Hosting benötigen möglicherweise eigene Update-Prozesse.

Nextclouds Integritätsleitfaden beschreibt dasselbe Prinzip für einen ungültigen Core-Hash: Stellen Sie die korrekten Dateien wieder her und führen Sie anschließend einen erneuten Scan durch. Beim Übertragen von Dateien per FTP wird ausdrücklich zur Verwendung des Binärübertragungsmodus geraten. Vermeiden Sie es, ein Update ohne aktivierte Signaturprüfung durchzuführen. Ein manuell installiertes, nicht verifiziertes Archiv kann ein neues Integritäts- und Sicherheitsproblem darstellen.

4. Überprüfen Sie zusätzliche Dateien und benutzerdefinierte Änderungen sorgfältig.

Ein EXTRA_FILEEintrag kann eine übriggebliebene temporäre Datei, eine Editor-Sicherung, ein benutzerdefiniertes Skript oder etwas Unbekanntes sein. Überprüfen Sie den vollständigen Pfad, den Zeitstempel, den Besitzer und den Bereitstellungsverlauf. Handelt es sich um ein legitimes benutzerdefiniertes Tool, verschieben Sie es aus dem bereitgestellten Nextcloud-Codeverzeichnis und stellen Sie es gegebenenfalls über eine unterstützte App oder einen separaten Dienst bereit. Ist es eine veraltete Sicherung, entfernen Sie diese erst, nachdem Sie alle benötigten Daten gesichert haben. Wenn kürzlich eine unerklärliche ausführbare Datei oder PHP-Datei aufgetaucht ist, behandeln Sie dies als Sicherheitsuntersuchung: Sichern Sie Beweise, überprüfen Sie Zugriffs- und Webserver-Protokolle und befolgen Sie Ihren Incident-Response-Prozess, anstatt die Warnung einfach zu löschen.

Bei einem Fehler INVALID_HASHin einer Kerndatei, die Sie absichtlich bearbeitet haben, besteht die nachhaltige Lösung darin, die signierte Kerndatei wiederherzustellen und das benutzerdefinierte Verhalten in eine unterstützte App, ein Theme oder einen dokumentierten Erweiterungspunkt zu verschieben. Ändern Sie weder den erwarteten Hash noch die Release-Metadaten, um die Prüfung zu bestehen. Für benutzerdefinierte Nextcloud-Distributionen gelten in der Dokumentation zur Codesignierung separate Release-Branch-Überlegungen; die Änderung dieser Einstellung ist für die Betreuer einer benutzerdefinierten Distribution vorgesehen und keine routinemäßige Reparatur für eine Standardinstallation.

5. Reparieren einer App-Signatur oder App-Datei

Wenn der Bericht ein App-Verzeichnis nennt, ermitteln Sie dessen App-ID und prüfen Sie, ob die App aktualisiert, manuell kopiert oder lokal modifiziert wurde. Verwenden Sie die Nextcloud-App-Oberfläche oder Ihre Bereitstellungsmethode, um eine kompatible Version aus einer vertrauenswürdigen Quelle zu aktualisieren oder neu zu installieren. Sichern Sie vorher app-spezifische Daten und Konfigurationen und prüfen Sie die Kompatibilität mit Ihrer Nextcloud-Hauptversion. Bei einer benutzerdefinierten oder intern entwickelten App bitten Sie den Entwickler um ein signiertes Paket oder eine korrigierte Version. Nextcloud verlangt für Apps, die über den App Store veröffentlicht werden, eine Codesignatur. Die Anforderungen und deren Durchsetzung können für andere App-Kategorien abweichen. Verwenden Sie daher die entsprechende Entwicklerdokumentation, anstatt eine lokale Signatur zu erstellen.

Überschreiben Sie das App-Verzeichnis nicht mit einem beliebigen Archiv und kopieren Sie es nicht signature.jsonaus einer anderen Version. Die Signatur beschreibt bestimmten Code; das Mischen von Dateien aus verschiedenen Versionen kann zu zusätzlichen Fehlern führen. Wenn Sie eine App entfernen müssen, verwenden Sie den unterstützten App-Verwaltungsprozess und stellen Sie sicher, dass beim Entfernen keine für Ihre Organisation wichtigen Daten verloren gehen.

6. Führen Sie eine erneute Integritätsprüfung durch.

Nachdem Sie die gemeldeten Dateien repariert haben, gehen Sie zurück zu „Administrationseinstellungen“ > „Übersicht“ und wählen Sie „Erneut scannen…“ . Warten Sie, bis der Scan abgeschlossen ist, und öffnen Sie dann die Liste der ungültigen Dateien erneut. Wenn Sie den Server über SSH verwalten, finden Sie die entsprechenden Befehle in Nextcloud 35 im Installationsverzeichnis von Nextcloud.

sudo -E -u www-data php occ integrity:check-core
sudo -E -u www-data php occ integrity:check-app calendar
sudo -E -u www-data php occ integrity:check-app --all

Ersetzen Sie calendar<App-ID> durch die in Ihrem Bericht angegebene App-ID. Das www-dataKonto ist bei Debian- oder Ubuntu-basierten Installationen üblich, Ihr Webserver-Benutzer und die PHP-Ausführungsdatei können jedoch abweichen. Verwenden Sie das korrekte Konto und die korrekte PHP-Umgebung für Ihr System. Führen Sie bei Containerinstallationen den entsprechenden Befehl im jeweiligen Container aus. Laut aktuellem OCC-Handbuch liefert eine erfolgreiche App-Prüfung möglicherweise keine Ausgabe, sofern nicht der ausführliche Modus aktiviert ist. Fehler hingegen listen Details auf.

Wie man erkennt, ob die Warnung behoben wurde

Öffnen Sie die Administratorübersicht erneut und prüfen Sie, ob die Integritätswarnung nach dem neuen Scan verschwunden ist. Falls sie weiterhin besteht, vergleichen Sie den neuen Bericht mit Ihrer gespeicherten Kopie: Derselbe Pfad bedeutet, dass die zugrunde liegende Datei nicht wiederhergestellt oder die falsche Version verwendet wurde; ein anderer Pfad kann auf ein anderes Problem hinweisen. Führen Sie die entsprechende Kern- oder Anwendungsprüfung erneut aus und überprüfen Sie das Nextcloud-Protokoll auf einen Signaturfehler. Stellen Sie außerdem sicher, dass die Instanz die Anmeldung, das Durchsuchen von Dateien sowie Uploads und Downloads normal durchführt.

Wenn die Warnung nach der Bereitstellung erneut auftritt, suchen Sie nach Automatisierungen, Plugins oder manuellen Wartungsskripten, die Dateien im signierten Codebaum überschreiben. Ist der Integritätsbericht fehlerfrei, sehen Benutzer aber weiterhin Fehler, hat das ursprüngliche Problem möglicherweise eine andere Ursache und sollte separat untersucht werden. Bei gehostetem Nextcloud senden Sie dem Anbieter den genauen Bericht und die installierte Version; vermeiden Sie die Angabe von Passwörtern, privaten Schlüsseln oder Benutzerdateien.

Für versionsspezifische Details siehe die Nextcloud-Codesignatur- und Integritätsdokumentation , die OCC-Integritätsprüfungsreferenz , das Nextcloud-Updater-Handbuch und die offizielle Downloadseite .