Naprawa klienta ownCloud Desktop „Nieznany błąd CSync” podczas synchronizacji
Przykład ilustrujący: Jordan synchronizuje lokalny folder projektu z aplikacją ownCloud Desktop w systemie Windows. Konto działało normalnie, ale klient nagle zgłasza nieznany błąd CSync i przerywa synchronizację. Pliki nadal istnieją lokalnie i są widoczne w interfejsie internetowym ownCloud. Ten przykład jest hipotetyczny; służy jedynie do pokazania, jak zastosować udokumentowane kroki rozwiązywania problemów.
Dobra wiadomość jest taka, że ownCloud dokumentuje konkretne rozwiązanie tego problemu: zamknij aplikację na pulpicie, usuń ukryty ._sync_xxxxxxx.dbplik z folderu synchronizacji i uruchom ponownie aplikację. Ta baza danych to lokalny dziennik synchronizacji. Jej odbudowa może naprawić uszkodzony lub niespójny stan synchronizacji, ale ownCloud ostrzega, że jej usunięcie usuwa również niektóre ustawienia kontrolujące pobieranie plików.
Od października 2026 roku aktualna dokumentacja aplikacji desktopowej ownCloud 7.1 nadal zawiera tę procedurę w przypadku nieznanego błędu CSync . Należy również zwrócić uwagę na obecny podział produktów: aplikacja desktopowa 7.x obsługuje tylko ownCloud Infinite Scale; administratorzy korzystający z ownCloud Classic Server 10 lub 11 powinni pozostać przy aplikacji desktopowej serii 6. Przed wprowadzeniem zmiany w wersji głównej zapoznaj się z oficjalnymi informacjami o wydaniu aplikacji desktopowej ownCloud .
Co zazwyczaj oznacza „Nieznany błąd CSync”
Komunikat jest celowo szeroki. Nie identyfikuje on pojedynczej awarii po stronie serwera, błędnej nazwy pliku ani problemu z uprawnieniami. Aktualna dokumentacja rozwiązywania problemów z aplikacją desktopową ownCloud traktuje to najpierw jako problem ze stanem synchronizacji i zaleca odbudowę lokalnej bazy danych synchronizacji przed przejściem do głębszej diagnostyki.
Kolejność ma znaczenie. W hipotetycznym przypadku Jordana najbezpieczniejszym pierwszym krokiem nie jest usuwanie lokalnego folderu projektu, usuwanie konta ani czyszczenie danych z serwera. Udokumentowana naprawa dotyczy tylko ukrytej bazy danych synchronizacji używanej przez to połączenie synchronizacji.
Przykładowy krok 1: przed zastosowaniem naprawy bazy danych synchronizacji sprawdź, czy wyświetlany komunikat to konkretnie „Nieznany błąd CSync”.
Krok 1: Całkowicie zamknij aplikację ownCloud Desktop
Zamknij aplikację ownCloud Desktop przed dotknięciem jej bazy danych synchronizacji. Nie minimalizuj okna. Użyj akcji „Zamknij” lub „Wyjdź” w aplikacji, aby klient nie zapisywał już danych w dzienniku.
W tym przykładzie Jordan najpierw czeka na zakończenie widocznej aktywności, wychodzi z ownCloud i potwierdza, że aplikacja jest już nieaktywna. Zmniejsza to ryzyko usunięcia pliku bazy danych, gdy klient nadal ma go otwartego.
Krok 2: Pokaż ukryte pliki w folderze synchronizacji, którego dotyczy problem
Plik, który ownCloud zaleca usunąć, jest ukryty. Otwórz lokalny katalog główny folderu synchronizacji ownCloud i włącz wyświetlanie ukrytych elementów w menedżerze plików. W systemie Windows Eksplorator plików może wyświetlać ukryte elementy w opcjach widoku. W systemach macOS i Linux należy użyć standardowej metody wyświetlania ukrytych plików w menedżerze plików.
Wyszukaj nazwę pliku pasującą do wzorca:
._sync_xxxxxxx.db
Dokładne znaki po tym ._sync_słowie mogą się różnić. Nie usuwaj zwykłych dokumentów ani folderów tylko dlatego, że mają podobną nazwę.
Przykładowy krok 2: włącz ukryte pliki i zidentyfikuj ukryty ._sync_….dbdziennik w odpowiednim katalogu głównym synchronizacji.
Krok 3: Usuń tylko ukrytą bazę danych synchronizacji
Po całkowitym zatrzymaniu ownCloud usuń pasujący ._sync_xxxxxxx.dbplik. Oficjalna strona rozwiązywania problemów wyraźnie zaleca usunięcie tego pliku, a następnie ponowne uruchomienie aplikacji na komputerze.
W przykładzie Jordana jest to jedyny usunięty plik. Dane lokalnego projektu pozostają nienaruszone. To rozróżnienie jest istotne, ponieważ usunięcie całego lokalnego folderu synchronizacji może spowodować niepotrzebny problem z odzyskiwaniem, podczas gdy usunięcie udokumentowanego pliku dziennika pozwala ownCloud odbudować stan lokalnej synchronizacji.
Zanim przejdziesz dalej: ownCloud ostrzega, że ta operacja może usunąć niektóre ustawienia określające, które pliki są pobierane. Jeśli korzystasz z synchronizacji selektywnej lub celowo wykluczyłeś duże foldery, zanotuj te ustawienia, aby móc je przejrzeć po ponownym uruchomieniu.
Przykładowy krok 3: usuń tylko ukrytą bazę danych synchronizacji, gdy aplikacja ownCloud Desktop nie jest uruchomiona.
Krok 4: Uruchom ponownie ownCloud i pozwól mu na odbudowanie stanu synchronizacji
Uruchom ponownie aplikację na komputerze. Powinna ona ponownie utworzyć lokalną bazę danych synchronizacji i ponownie przeskanować relację między folderem lokalnym a serwerem. Daj klientowi czas na zakończenie wyszukiwania, zanim stwierdzi, że poprawka się nie powiodła, zwłaszcza gdy drzewo synchronizacji zawiera wiele plików.
Hipotetyczne kryterium sukcesu Jordana jest proste: błąd CSync nie pojawia się od razu, klient rozpoczyna skanowanie lub synchronizację, a konto ostatecznie osiąga stan aktualny. Jeśli opcje synchronizacji selektywnej uległy zmianie, Jordan weryfikuje je przed zezwoleniem na duże pobrania.
Przykładowy krok 4: uruchom ponownie klienta, pozwól na odbudowanie dziennika synchronizacji i potwierdź, że synchronizacja może być kontynuowana.
Jeśli błąd powróci, sprawdź podstawowe warunki synchronizacji
Usunięcie bazy danych synchronizacji jest udokumentowanym sposobem rozwiązania konkretnego błędu CSync, ale nie jest w stanie naprawić wszystkich warunków, które mogą powodować niepowodzenie synchronizacji. Jeśli komunikat zostanie zwrócony, należy użyć odbudowanego stanu jako punktu wyjścia i sprawdzić kolejno następujące elementy.
1. Sprawdź, czy konto i połączenie z serwerem nadal działają
Zaloguj się do interfejsu internetowego ownCloud w przeglądarce. Firma ownCloud zaleca to jako pierwszy podstawowy test łączności. Jeśli interfejs internetowy jest niedostępny, dane uwierzytelniające nie działają lub wszystkie aplikacje klienckie na komputerach stacjonarnych przestają działać, a strona internetowa nadal działa, poproś administratora o weryfikację instancji, adresu URL połączenia i ustawień serwera proxy.
2. Sprawdź wolne miejsce na dysku
W poradniku rozwiązywania problemów z ownCloud 7.1 podano, że pobieranie zostanie pominięte lub przerwane, jeśli zmniejszyłoby to ilość wolnego miejsca na dysku poniżej 250 MB, a synchronizacja zostanie całkowicie zatrzymana, jeśli ilość wolnego miejsca spadnie poniżej 50 MB. Przed ponowną próbą zwolnij miejsce, które jest wystarczająco wolne, powyżej tych progów.
3. Sprawdź uprawnienia folderów systemu Windows, jeśli w grę wchodzi VFS
W systemie Windows z plikami wirtualnymi może wystąpić błąd odmowy dostępu do metadanych, jeśli użytkownik będący właścicielem nie ma już oczekiwanych uprawnień do synchronizowanego folderu. W dokumentacji ownCloud użytkownik będący właścicielem powinien mieć pełną kontrolę . Jeśli w dziennikach znajdują się WindowsError: ffffffff80070005: Access is denied., sprawdź uprawnienia zabezpieczeń folderu lub poproś o to administratora.
4. Sprawdź ograniczenia dotyczące nazw plików i ścieżek
Przebudowa dziennika nie sprawi, że nieprawidłowa nazwa pliku będzie synchronizowana. Oficjalna strona poświęcona nazwom plików w usłudze ownCloud informuje, że system Windows nie zezwala na znaki takie jak <, >, :, ", \, |, ?, i *, a nazwy plików nie mogą kończyć się spacją ani kropką. Zastrzeżone nazwy systemu Windows, takie jak CON, PRN, AUX, NUL, COM1through COM9i LPT1through , LPT9również mogą powodować problemy.
W przypadku systemu Windows VFS, ownCloud dokumentuje również powszechne ograniczenie ścieżki do 260 znaków, chyba że system operacyjny jest skonfigurowany tak, aby je znieść. Jeśli błąd dotyczy tylko głęboko zagnieżdżonego pliku, należy skrócić ścieżkę lub postępować zgodnie z instrukcjami firmy Microsoft dotyczącymi konfiguracji długich ścieżek, do których link znajduje się w dokumentacji ownCloud.
5. Nie kieruj dwóch silników synchronizacji do tego samego katalogu lokalnego
ownCloud wyraźnie ostrzega przed synchronizacją tego samego katalogu lokalnego z innym narzędziem do synchronizacji, takim jak OneDrive, Dropbox, rsync, Unison czy Windows Offline Files. Konkurencyjne aplikacje mogą zmieniać metadane lub pliki znajdujące się pod sobą, a w najgorszym przypadku spowodować utratę danych. Gdyby Jordan umieścił ten sam katalog również w innym produkcie do synchronizacji w chmurze, właściwym rozwiązaniem byłoby oddzielenie tych katalogów głównych synchronizacji, zamiast wielokrotnego usuwania dziennika ownCloud.
Zbierz logi, jeśli odbudowa bazy danych nie rozwiąże problemu
Jeśli po czystej odbudowie wystąpi błąd CSync, przechwyć logi z około jednej powtarzalnej próby synchronizacji. ownCloud twierdzi, że logi aplikacji komputerowej są często najbardziej przydatnym artefaktem diagnostycznym.
W aplikacji Desktop App 7.1 rejestrowanie można uruchomić w Ustawieniach → Zaawansowane → Ustawienia rejestrowania . Udokumentowane skróty klawiaturowe to F12 w systemie Windows, Ctrl+L w systemie Linux i Cmd+L w systemie macOS. Włącz rejestrowanie w folderze tymczasowym, odtwórz problem, a następnie zapisz pliki obejmujące okres, którego dotyczy problem.
Możesz również uruchomić aplikację z bardziej szczegółowym rejestrowaniem. Na przykład w systemie Windows:
Nie publikuj logów pochopnie. ownCloud ostrzega, że mogą one zawierać nazwy plików i folderów, metadane, adresy URL serwerów i inne prywatne informacje. W razie potrzeby udostępnij je prywatnie odpowiedniemu administratorowi lub działowi pomocy technicznej ownCloud.
Kompaktowa ścieżka decyzyjna
Co widzisz
Najlepsza następna akcja
Dokładna wiadomość: Nieznany błąd CSync
Zamknij ownCloud, usuń ._sync_xxxxxxx.db, uruchom ponownie, a następnie sprawdź ustawienia wyboru pobierania.
Błąd powraca natychmiast
Sprawdź kompatybilność przeglądarki z serwerem, adresem URL serwera, serwerem proxy i wersją klienta/serwera.
Tylko niektóre pliki ulegają awarii
Sprawdź reguły ignorowanych plików, niedozwolone znaki, zarezerwowane nazwy okien i długość ścieżki.
System Windows VFS wyświetla komunikat o odmowie dostępu
Sprawdź, czy użytkownik będący właścicielem ma pełną kontrolę nad folderem synchronizacji.
Synchronizacja zostaje zatrzymana po zapełnieniu pamięci masowej
Zwolnij miejsce na dysku lokalnym i spróbuj ponownie.
Przyczyna jest nadal niejasna
Przechwyć możliwy do odtworzenia dziennik aplikacji na pulpicie i przejrzyj go prywatnie.
Notatka dotycząca wersji na rok 2026
Warto sprawdzić aktualne informacje o wersji przed „naprawieniem” problemu poprzez aktualizację. Aplikacja desktopowa ownCloud 7.1.1 została wydana we wrześniu 2026 roku, ale wersja 7.x jest przeznaczona dla ownCloud Infinite Scale. W informacjach o wersji ownCloud podano, że użytkownicy ownCloud Classic Server 10 lub 11 powinni pozostać przy aplikacji desktopowej 6.x. Niezgodna, główna aktualizacja może spowodować inny problem z połączeniem, zamiast rozwiązać błąd CSync.
Podsumowanie
W przypadku dokładnego błędu CSync Unknown Error , zacznij od dokumentacji naprawy ownCloud: zamknij aplikację na pulpicie, odszukaj ukryte pliki, usuń ._sync_xxxxxxx.dbdziennik, którego dotyczy problem, i uruchom ponownie. Potraktuj to jako lokalne resetowanie stanu synchronizacji, a nie jako zgodę na usunięcie danych użytkownika. Jeśli problem powróci, sprawdź łączność, miejsce na dysku, uprawnienia, reguły nazw plików, konkurencyjne oprogramowanie do synchronizacji i dzienniki (w tej kolejności).