Nextcloud Desktop Sync: Schritte nach dem Vorgang „Dateien werden verarbeitet“

Wenn der Nextcloud Desktop Client bei „Dateien werden verarbeitet“ hängen bleibt, öffnen Sie die Synchronisierungsaktivitäten des Kontos und prüfen Sie, ob eine bestimmte Datei wiederholt einen Fehler anzeigt oder der Client noch immer eine große Ordnerstruktur durchsucht. Überprüfen Sie dies zuerst und anschließend die Regeln für ignorierte Dateien sowie die Serververbindung. Ein Neustart kann ein vorübergehendes Problem beheben. Das Löschen der Synchronisierungsdatenbank oder das Neuerstellen der Synchronisierungsverbindung sollte jedoch erst später erfolgen, da dies die Einstellungen für die selektive Synchronisierung zurücksetzen oder eine erneute umfassende Überprüfung auslösen kann.

Finden Sie heraus, was tatsächlich feststeckt.

Öffnen Sie das Nextcloud-Menü über die Taskleiste (Windows oder Linux) bzw. die Menüleiste (macOS) und rufen Sie den Kontostatus auf. Achten Sie auf wiederkehrende Dateinamen, sichtbare Fehler oder eine sich ändernde Warteschlange. Der Client unterscheidet zwischen den Status „Synchronisierung läuft“, „Pausiert“, „Offline“, „Warnung“ und „Fehler“. Ein blaues Aktivitätssymbol allein beweist nicht, dass Daten hochgeladen werden. Im klassischen Synchronisierungsmodus können Dateimanager-Overlays hilfreich sein: Blau bedeutet „Warten“ oder „Aktive Synchronisierung“, ein grünes Häkchen „Aktuell“ und ein rotes X „Fehler“. Der Modus „Virtuelle Dateien/Dateianbieter“ verwendet andere Statusanzeigen des Betriebssystems. Überprüfen Sie daher die Client-Fenster und die Details im Finder oder Explorer, anstatt anzunehmen, dass die Symbole des klassischen Modus gelten.

Sinkt die Anzahl der ausstehenden Elemente, lassen Sie den Client weiterlaufen und warten Sie, bis der Scan abgeschlossen ist, insbesondere nach dem Hinzufügen eines großen Ordners oder dem erneuten Anschließen eines Geräts. Bleibt dasselbe Element an erster Stelle, öffnen Sie dessen Fehlerdetails. Notieren Sie sich den lokalen Pfad und die genaue Fehlermeldung, bevor Sie etwas verschieben, umbenennen oder bearbeiten. Vermeiden Sie es, den Scan während der Änderung der Warteschlange wiederholt anzuhalten und fortzusetzen; dies hilft nicht, die Ursache zu ermitteln und erschwert die Fortschrittsanalyse.

Überprüfen Sie die Regeln für Dateien und ignorierte Dateien.

Wenn eine Datei den Fortschritt blockiert, vergleichen Sie deren Namen, Pfad und lokalen Status mit der Serverkopie in der Nextcloud-Weboberfläche. Stellen Sie sicher, dass die Datei nicht noch in einem Editor geöffnet ist, von einer Kamera oder einem Sicherungsprogramm beschrieben wird oder von einem anderen Prozess gesperrt ist. Falls eine Anwendung die Datei gerade ändert, schließen Sie diese ordnungsgemäß und lassen Sie den Client es erneut versuchen. Löschen Sie keine der Kopien, nur um den Status zurückzusetzen.

Manche Dateien werden absichtlich ignoriert. Nextcloud schließt bestimmte Systemdateien und Dateinamen aus, die auf anderen Dateisystemen nicht dargestellt werden können. Öffnen Sie in den Client-Einstellungen „ Erweitert“ → „Ignorierte Dateien bearbeiten “ (die Bezeichnungen können je nach Client-Version variieren) und überprüfen Sie die benutzerdefinierten Muster für den betroffenen Namen oder dessen übergeordneten Ordner. Ein Platzhalter wie z. B. *„\“ steht für mehrere Zeichen; „ ?\“ steht für ein Zeichen; ein abschließender Schrägstrich beschränkt ein Muster auf Verzeichnisse. Entfernen oder schränken Sie eine benutzerdefinierte Regel nur dann ein, wenn die Datei synchronisiert werden soll. Bearbeiten Sie nicht sync-exclude.lstals erste Maßnahme die mit der Anwendung ausgelieferte globale Datei. Nextcloud warnt davor, dass Änderungen an dieser Datei zu unerwünschtem Verhalten führen können.

Überprüfen Sie außerdem den Status ignorierter oder nicht synchronisierter Ordner des Clients sowie die Einstellungen für die selektive Synchronisierung. Ein absichtlich ausgeschlossener Ordner wird nicht automatisch synchronisiert, nur weil der Client neu gestartet wurde. Wenn das Problem nur einen bestimmten Pfad betrifft, kann ein temporärer Test mit einer Kopie in einem einfachen Ordner helfen, eine pfadspezifische Regel von einem allgemeinen Verbindungsproblem zu unterscheiden. Verwenden Sie jedoch keinen zweiten Cloud-Synchronisierungsdienst für dasselbe Live-Synchronisierungsverzeichnis.

Trennen Sie ein Clientproblem von einem Serververbindungsproblem.

Melden Sie sich in einem Browser mit demselben Nextcloud-Konto an und prüfen Sie, ob Dateien und Ordner geladen werden. Funktioniert die Weboberfläche, aber alle Desktop-Geräte reagieren nicht, liegt das Problem möglicherweise am WebDAV-Endpunkt des Servers oder dessen Konfiguration. Der Nextcloud-Client verwendet WebDAV für den Zugriff auf Serverdateien. Bei einem Server, der unter `/etc/nextcloud` installiert ist https://cloud.example.com, lautet der DAV-Endpunkt üblicherweise `/etc/nextcloud` https://cloud.example.com/remote.php/dav; verwenden Sie hierfür Ihren tatsächlichen Installationspfad. Beim Öffnen dieser Adresse im Browser sollte mindestens eine Authentifizierungsabfrage erfolgen oder eine Antwort vom Endpunkt angezeigt werden. Authentifizierungsfehler, Zertifikatswarnungen oder Serverfehler deuten darauf hin, dass Sie sich an den Administrator wenden oder die Serverprotokolle überprüfen sollten, anstatt den lokalen Client zurückzusetzen.

Prüfen Sie, ob ein anderes Synchronisierungsprogramm, ein Backup-Tool oder eine Offline-Datei-Funktion dasselbe Verzeichnis verwaltet. Laut Nextcloud-Handbuch zur Fehlerbehebung wird die Synchronisierung eines Verzeichnisses mit mehreren Synchronisierungsanwendungen nicht unterstützt und kann zu Datenverlust führen. Entfernen Sie die Überschneidung erst, nachdem Sie die Anwendung identifiziert haben, der der Ordner gehört, und lokale Änderungen beibehalten haben. Wenn nur ein Computer betroffen ist, prüfen Sie den lokalen Festplattenspeicher, die Ordnerberechtigungen, Virenscanner oder On-Access-Scans sowie ob der Client Dateien im Synchronisierungsverzeichnis lesen und umbenennen kann.

Starten Sie das System neu und sammeln Sie anschließend nützliche Diagnosedaten.

1. Warten Sie, bis alle laufenden Dateivorgänge abgeschlossen sind, und beenden Sie dann den Desktop-Client über das Taskleistenmenü oder die Menüleiste. Starten Sie ihn anschließend neu und prüfen Sie, ob sich die Anzahl der ausstehenden Vorgänge ändert.
2. Falls der Client weiterhin nicht reagiert, öffnen Sie die Einstellungen und wählen Sie „Erweitert“ → „Debug-Archiv erstellen…“ , um ein Diagnosearchiv zu speichern. Der genaue Speicherort dieser Option kann je nach Version und Plattform variieren.
3. Überprüfen Sie das Protokoll um den Zeitpunkt herum, als sich der Status nicht mehr änderte. Suchen Sie nach dem betroffenen Pfad und einem wiederholten Fehler, wie z. B. Zugriff verweigert, Verbindungsfehler oder Dateinamensbeschränkung.

Debug-Archive enthalten Protokolle und Datenbankinformationen und können sensible Dateinamen, Kontodaten oder Serveradressen enthalten. Überprüfen und schwärzen Sie diese, bevor Sie sie an den Support weitergeben. Die Nextcloud-Dokumentation zur Fehlerbehebung beschreibt das Debug-Archiv und andere Möglichkeiten zum Erfassen von Client-Protokollen.

Verwenden Sie einen Datenbank-Reset nur für den übereinstimmenden Fehler.

Löschen Sie die Synchronisierungsdatenbank des Clients nicht routinemäßig, um den allgemeinen Status „Dateien werden verarbeitet“ zu beheben. Nextcloud beschreibt eine spezifischere Lösung für den Fehler „Unbekannter CSync-Fehler“ : Stoppen Sie den Client, suchen Sie die versteckte .sync_xxxxxxx.dbDatei im vom Client konfigurierten Kontoordner und löschen Sie die Datenbank, bevor Sie ihn neu starten. Beachten Sie, dass dadurch auch Einstellungen zu den herunterzuladenden Dateien gelöscht werden. Sichern Sie daher vorher den lokalen Synchronisierungsordner und notieren Sie sich die Einstellungen für die selektive Synchronisierung. Löschen Sie niemals eine Datenbank, während der Client ausgeführt wird. Falls der genaue Fehler nicht auftritt, überprüfen Sie das Debug-Archiv oder wenden Sie sich an den Support, bevor Sie diese Wiederherstellungsmethode anwenden.

Bestätigen Sie, dass die Synchronisierung wiederhergestellt wurde.

Überprüfen Sie nach der Änderung nicht nur das Verschwinden des Ladekreises. Die Warteschlange sollte geleert werden, der Client sollte einen aktuellen und verbundenen Status anzeigen, und eine kleine Testdatei sollte sowohl lokal als auch in der Weboberfläche am erwarteten Speicherort erscheinen. Stellen Sie sicher, dass die ursprünglich betroffene Datei den gewünschten Inhalt hat und die Ordner für die selektive Synchronisierung weiterhin wie konfiguriert sind. Falls dieselbe Datei erneut einen Fehler verursacht, speichern Sie die genaue Fehlermeldung und ein anonymisiertes Debug-Archiv. Ein wiederkehrendes Problem mit Berechtigungen, Dateinamen, WebDAV oder der Clientversion erfordert eine gezielte Behebung.

Aktuelle Informationen zu Client-Steuerelementen und Schritten zur Fehlerbehebung finden Sie im Benutzerhandbuch des Nextcloud Desktop-Clients und in der Dokumentation zur Fehlerbehebung für Nextcloud Desktop . Das aktuelle Online-Benutzerhandbuch bezieht sich auf Nextcloud 36; Client-Bezeichnungen und verfügbare Funktionen für virtuelle Dateien können je nach Desktop-Client-Version und Betriebssystem variieren.