Nextcloud-Integritätswarnungen durch Wiederherstellung der richtigen Dateien beseitigen

Um die Nextcloud-Warnung „Einige Dateien haben die Integritätsprüfung nicht bestanden“ zu beheben, öffnen Sie zunächst die Administrationseinstellungen → Übersicht → Liste ungültiger Dateien… und stellen Sie anschließend nur die im Bericht aufgeführten Dateien wieder her oder entfernen Sie sie. Bearbeiten oder unterdrücken Sie die Prüfung nicht signature.json: Integritätsfehler können auf ein unvollständiges Update, eine versehentliche Anpassung oder eine unerwartete Datei hinweisen, die untersucht werden muss.

Lesen Sie den Bericht, bevor Sie Dateien ändern.

Die Warnung erscheint auf der Übersichtsseite für Administratoren. Die Dokumentation zur Codesignierung von Nextcloud beschreibt dort zwei nützliche Aktionen: die Liste der ungültigen Dateien anzeigen und einen erneuten Scan auslösen. Der Bericht gruppiert Probleme nach Komponenten, z. B. nach coreAnwendungen, und gibt Fehlertyp und Dateipfad an. Das aktuelle Administrationshandbuch für Nextcloud 35 beschreibt dieselben Aktionen sowie die occIntegritätsbefehle.

• INVALID_HASHEine Datei weicht vom in ihrer Signatur gespeicherten Hashwert ab. Mögliche Ursachen sind lokale Bearbeitungen, unvollständige Aktualisierungen oder unerwartete Änderungen.
• MISSING_FILEEine signierte Datei fehlt. Sie wurde möglicherweise versehentlich gelöscht oder bei einem Update vergessen.
• EXTRA_FILEEine Datei ist zwar im Installationsverzeichnis vorhanden, gehört aber nicht zum signierten Satz. Es könnte sich um eine lokale Datei, einen Überrest einer älteren Version oder eine Datei handeln, die einer Sicherheitsprüfung bedarf.
• EXCEPTIONDer Prüfer konnte eine Signatur nicht validieren, beispielsweise weil erforderliche Signaturdaten fehlen oder ungültig sind. Überprüfen Sie die genannte App und deren Quellcode.

Diese Bezeichnungen beschreiben das Prüfergebnis, nicht die Ursache. Eine zusätzliche Datei ist nicht automatisch schädlich, und ein abweichender Hashwert beweist keine Kompromittierung. Notieren Sie die Komponente, den Pfad und den Fehler und vergleichen Sie diese mit Ihrer Bereitstellungsmethode und den letzten Änderungen.

Führen Sie eine gezielte Überprüfung durch.

Wenn Sie Shell-Zugriff haben, führen Sie occden Befehl als Benutzer des Webservers aus dem Nextcloud-Installationsverzeichnis aus. Das korrekte Konto und der PHP-Befehl können je nach Betriebssystem, Container-Image, Snap oder Hosting-Anbieter variieren. Bei einer gängigen Debian- oder Ubuntu-Apache-Installation mit Nextcloud unter `/usr/bin` /var/www/nextcloudund dem Webbenutzer ` / www-datausr/bin` verwenden Sie:

cd /var/www/nextcloud
sudo -E -u www-data php occ integrity:check-core
sudo -E -u www-data php occ integrity:check-app calendar

Ersetzen Sie calendar<app-id> durch die in Ihrem Bericht angegebene App-ID. Die Kernprüfung verifiziert die Nextcloud-Serverdateien; die App-Prüfung verifiziert eine benannte App. Das Nextcloud-35-Handbuch beschreibt außerdem occ integrity:check-app --alldie Prüfung installierter Apps. Eine erfolgreiche Prüfung erzeugt möglicherweise keine Ausgabe; verwenden Sie diese Funktion, -vwenn Sie eine Bestätigung benötigen. Wenn Ihre Installation in einem Container ausgeführt oder von einem Paket verwaltet wird, verwenden Sie die dokumentierte Methode zum Aufrufen der Kernprüfung occund den zugehörigen Webbenutzer, anstatt diese Pfade einfach zu kopieren.

Dateien aus einer vertrauenswürdigen Quelle wiederherstellen

Für Kerndateien

Verwenden Sie für INVALID_HASHVersionen MISSING_FILEunter 1000 coredie exakt aktuell installierte Nextcloud-Version. Laden Sie ein sauberes Archiv von der offiziellen Downloadquelle herunter oder stellen Sie die passenden Dateien aus einem funktionierenden Backup oder Bereitstellungsartefakt wieder her. Vergleichen Sie die installierte Version, bevor Sie Dateien ersetzen, und achten Sie darauf, dass die standortspezifische Konfiguration und das Datenverzeichnis erhalten bleiben. Falls nach einem abgebrochenen Upgrade mehrere Kerndateien beschädigt sind, reparieren Sie die Bereitstellung oder führen Sie den unterstützten Upgrade-Prozess für diesen Installationstyp erneut aus, anstatt einzelne Dateien wahllos zu ersetzen.

Überprüfen Sie EXTRA_FILEden Pfad und ermitteln Sie, wer die Datei erstellt hat. Verschieben Sie bekannte lokale Dateien aus dem Nextcloud-Codeverzeichnis, sofern sie nicht zur Installation gehören. Erstellen Sie vorher eine Kopie, falls die Datei wichtige Anpassungen enthält. Wenn Ihnen die Datei unbekannt oder verdächtig vorkommt, bewahren Sie sie zur Untersuchung auf und prüfen Sie Zugriffsprotokolle und den Bereitstellungsverlauf, bevor Sie sie löschen. Löschen Sie keine beliebigen Dateien, nur um die Warnung zu beseitigen.

Für App-Dateien

Bei einer signierten App mit geänderten oder fehlenden Dateien installieren Sie bitte dieselbe kompatible App-Version aus dem offiziellen Nextcloud App Store oder dem vertrauenswürdigen Release-Kanal des App-Entwicklers. Sichern Sie zuvor das App-Verzeichnis, falls es lokale Änderungen enthält. Bei einer benutzerdefinierten oder unsignierten App kann eine Integritätsmeldung den Signaturstatus oder die Implementierung widerspiegeln. Wenden Sie sich in diesem Fall an den Entwickler, anstatt Signaturdaten zu erstellen. Die Nextcloud-Dokumentation weist darauf hin, die App-Signatur nicht zu verändern signature.json. Die Codesignierung von Core und Apps ermöglicht die Erkennung von Änderungen und unvollständigen Aktualisierungen. Das Ändern der gespeicherten Hashwerte widerspricht diesem Zweck.

Beim Übertragen von Ersatzdateien per FTP empfiehlt Nextcloud ausdrücklich den Binärübertragungsmodus. Die Konvertierung im Textmodus kann Bytes verändern und zu einem neuen Hash-Fehler führen.

Erneut scannen und Ergebnis bestätigen

1. Führen Sie den entsprechenden Core- oder App-Integritätsbefehl erneut aus oder kehren Sie zu Administrationseinstellungen → Übersicht zurück und wählen Sie erneut scannen… .
2. Prüfen Sie, ob die betroffene Komponente nicht mehr in der Liste der ungültigen Dateien aufgeführt ist. Bei Verwendung der Befehlszeilenschnittstelle (CLI) erzeugt eine erfolgreiche Anwendungsprüfung keine Ausgabe; eine ausführliche Prüfung bestätigt das Ergebnis.
3. Laden Sie die Übersichtsseite neu und prüfen Sie, ob die Warnung verschwunden ist. Falls sie weiterhin besteht, öffnen Sie den aktualisierten Bericht; dieser kann eine andere Datei oder eine andere Komponente identifizieren.

Tritt derselbe Fehler sofort wieder auf, prüfen Sie, ob Ihr Bereitstellungsprozess, eine Anpassung oder ein eingebundenes Volume die geänderte Datei wiederherstellt. Bei Signaturausnahmen prüfen Sie die unterstützte Version der Anwendung und wenden Sie sich an den zuständigen Entwickler. Wird im Bericht eine Kerndatei identifiziert, deren Herkunft Sie nicht nachvollziehen können, behandeln Sie dies als Sicherheits- und Bereitstellungsproblem und überprüfen Sie vertrauenswürdige Backups und Serverprotokolle, bevor Sie fortfahren.

Siehe die offizielle Nextcloud-Codesignatur- und Integritätsdokumentation , die Nextcloud 35 Integritätsbefehlsreferenz und das offizielle Nextcloud-Server-Release-Archiv .