Acasă
» ADMIN. REȚEA
»
Remediați eroarea „Eroare necunoscută CSync” din clientul desktop ownCloud în timpul sincronizării
Remediați eroarea „Eroare necunoscută CSync” din clientul desktop ownCloud în timpul sincronizării
Exemplu ilustrativ: Jordan sincronizează un folder de proiect local cu aplicația desktop ownCloud pe Windows. Contul funcționa normal, dar clientul raportează brusc o eroare necunoscută CSync și oprește finalizarea sincronizării. Fișierele există încă local și sunt vizibile în interfața web ownCloud. Acest exemplu este ipotetic; este folosit doar pentru a arăta cum se aplică pașii documentați de depanare.
Vestea bună este că ownCloud documentează o soluție specifică de primă linie pentru acest mesaj: închideți aplicația desktop, ștergeți ._sync_xxxxxxx.dbfișierul ascuns din folderul de sincronizare afectat și reporniți aplicația. Baza de date respectivă este jurnalul de sincronizare local. Reconstruirea acesteia poate elimina o stare de sincronizare deteriorată sau inconsistentă, dar ownCloud avertizează că ștergerea acesteia elimină și unele setări care controlează ce fișiere sunt descărcate.
Începând cu octombrie 2026, documentația actuală a aplicației desktop ownCloud 7.1 listează încă această procedură pentru eroarea necunoscută CSync . De asemenea, rețineți împărțirea actuală a produselor: aplicația desktop 7.x acceptă doar ownCloud Infinite Scale; administratorii care utilizează ownCloud Classic Server 10 sau 11 ar trebui să rămână în seria de aplicații desktop 6. Consultați notele oficiale de lansare a aplicației desktop ownCloud înainte de a face o modificare a versiunii majore.
Ce înseamnă de obicei „Eroare necunoscută CSync”
Mesajul este intenționat general. Nu identifică nicio eroare la nivelul serverului, niciun nume de fișier greșit sau nicio problemă de permisiuni. Documentația actuală de depanare a aplicațiilor desktop de la ownCloud o tratează mai întâi ca pe o problemă de stare de sincronizare și recomandă reconstruirea bazei de date locale de sincronizare înainte de a trece la o diagnosticare mai aprofundată.
Această ordine contează. În cazul ipotetic al lui Jordan, cea mai sigură primă mișcare nu este ștergerea folderului local al proiectului, eliminarea contului sau eliminarea datelor de pe server. Repararea documentată vizează doar baza de date ascunsă de sincronizare utilizată de conexiunea de sincronizare respectivă.
Pasul ilustrativ 1: confirmați că mesajul este specific „Eroare necunoscută CSync” înainte de a aplica repararea sync-database.
Pasul 1: Închideți complet aplicația desktop ownCloud
Închideți aplicația desktop ownCloud înainte de a atinge baza de date de sincronizare. Nu minimizați doar fereastra. Folosiți acțiunea de închidere sau ieșire a aplicației, astfel încât clientul să nu mai scrie în jurnal.
În exemplu, Jordan așteaptă mai întâi ca orice activitate vizibilă să se oprească, iese din ownCloud și confirmă că aplicația nu mai rulează. Acest lucru reduce șansa de a șterge un fișier de bază de date în timp ce clientul îl are încă deschis.
Pasul 2: Afișați fișierele ascunse în folderul de sincronizare afectat
Fișierul pe care ownCloud vă spune să îl eliminați este ascuns. Deschideți rădăcina locală a folderului de sincronizare ownCloud afectat și activați afișarea elementelor ascunse în managerul de fișiere. Pe Windows, File Explorer poate afișa elemente ascunse din controalele sale de vizualizare. Pe macOS sau Linux, utilizați metoda normală de afișare a fișierelor ascunse pentru managerul de fișiere.
Căutați un nume de fișier care să corespundă modelului:
._sync_xxxxxxx.db
Caracterele exacte de după ._sync_variază. Nu ștergeți documente sau foldere obișnuite doar pentru că au un nume similar.
Pasul ilustrativ 2: activați fișierele ascunse și identificați ._sync_….dbjurnalul ascuns în rădăcina de sincronizare afectată.
Pasul 3: Ștergeți doar baza de date de sincronizare ascunsă
Cu ownCloud complet oprit, eliminați ._sync_xxxxxxx.dbfișierul corespunzător. Pagina oficială de depanare recomandă în mod specific ștergerea acestui fișier și apoi repornirea aplicației desktop.
În exemplul lui Jordan, acesta este singurul fișier eliminat. Datele proiectului local rămân intacte. Această distincție este importantă deoarece ștergerea întregului folder de sincronizare local poate crea o problemă inutilă de recuperare, în timp ce ștergerea fișierului jurnal documentat permite ownCloud să reconstruiască starea sa de sincronizare locală.
Înainte de a continua: ownCloud avertizează că această operațiune poate șterge unele setări care determină ce fișiere sunt descărcate. Dacă utilizați sincronizarea selectivă sau ați exclus intenționat foldere mari, notați aceste opțiuni pentru a le putea revizui după repornire.
Pasul ilustrativ 3: eliminați doar baza de date de sincronizare ascunsă cât timp aplicația desktop ownCloud nu rulează.
Pasul 4: Reporniți ownCloud și lăsați-l să reconstruiască starea de sincronizare
Lansați din nou aplicația desktop. Aceasta ar trebui să recreeze baza de date locală de sincronizare și să rescaneze relația dintre folderul local și server. Acordați clientului timp să finalizeze descoperirea înainte de a decide că remedierea a eșuat, mai ales când arborele de sincronizare conține multe fișiere.
Criteriul ipotetic de succes al lui Jordan este simplu: eroarea CSync nu reapare imediat, clientul începe scanarea sau sincronizarea, iar contul ajunge în cele din urmă la o stare actualizată. Dacă opțiunile de sincronizare selectivă s-au modificat, Jordan le verifică înainte de a permite descărcări mari.
Pasul ilustrativ 4: reporniți clientul, permiteți reconstruirea jurnalului de sincronizare și confirmați că sincronizarea poate continua din nou.
Dacă eroarea reapare, verificați condițiile de sincronizare subiacente
Ștergerea bazei de date de sincronizare este soluția documentată pentru eroarea specifică CSync, dar nu poate repara fiecare condiție care poate cauza eșecul sincronizării. Dacă mesajul reapare, utilizați starea reconstruită ca punct de plecare curat și verificați următoarele elemente unul câte unul.
1. Verificați dacă conexiunea la cont și la server funcționează în continuare
Conectați-vă la interfața web ownCloud într-un browser. ownCloud recomandă acest lucru ca prim test de conectivitate de bază. Dacă interfața web nu este disponibilă, acreditările eșuează sau toți clienții desktop eșuează în timp ce site-ul web încă funcționează, solicitați administratorului să verifice instanța, adresa URL de conexiune și setările proxy.
2. Verificați spațiul liber pe disc
Ghidul de depanare ownCloud 7.1 precizează că o descărcare este omisă sau anulată dacă ar reduce spațiul liber pe disc sub 250 MB, iar sincronizarea se oprește complet dacă spațiul liber rămas scade sub 50 MB. Eliberați spațiu confortabil peste aceste praguri înainte de a încerca din nou.
3. Verificați permisiunile folderului Windows când este implicat VFS
Pe Windows cu fișiere virtuale, poate apărea o eroare de metadate de tip acces refuzat dacă utilizatorul proprietar nu mai are permisiunile așteptate asupra folderului sincronizat. ownCloud documentează că utilizatorul proprietar ar trebui să aibă Control total . Dacă jurnalele dvs. conțin WindowsError: ffffffff80070005: Access is denied., verificați permisiunile de securitate ale folderului sau solicitați administratorului să facă acest lucru.
4. Căutați restricții privind numele fișierului și calea
O reconstrucție a jurnalului nu va face un nume de fișier nevalid sincronizabil. Pagina oficială de considerații privind numele de fișiere ownCloud menționează că Windows nu permite caractere precum <, >, :, ", \, , |, ?, și *, iar numele de fișiere nu se pot termina cu spațiu sau punct. Numele Windows rezervate, cum ar fi CON, PRN, AUX, NUL, COM1thru COM9și LPT1through , LPT9pot cauza, de asemenea, probleme.
Pentru Windows VFS, ownCloud documentează și o limitare comună a componentei căii de 260 de caractere, cu excepția cazului în care sistemul de operare este configurat să o relaxeze. Dacă eșuează doar un fișier imbricat profund, scurtați calea sau urmați instrucțiunile de configurare a căii lungi de la Microsoft, disponibile prin link din documentația ownCloud.
5. Nu direcționați două motoare de sincronizare către același director local
ownCloud avertizează în mod explicit împotriva sincronizării aceluiași director local cu un alt instrument de sincronizare, cum ar fi OneDrive, Dropbox, rsync, Unison sau Windows Offline Files. Aplicațiile concurente pot modifica metadatele sau fișierele una sub alta și, în cel mai rău caz, pot cauza pierderi de date. Dacă Jordan ar fi plasat același director și sub un alt produs de sincronizare în cloud, soluția corectă ar fi separarea acelor directori de sincronizare, în loc să se șteargă în mod repetat jurnalul ownCloud.
Colectați jurnale dacă reconstruirea bazei de date nu rezolvă problema
Dacă eroarea CSync reapare după reconstrucția curată, capturați jurnalele în jurul unei încercări de sincronizare reproductibile. ownCloud spune că jurnalul aplicației desktop este adesea cel mai util artefact de diagnosticare.
În aplicația desktop 7.1, jurnalizarea poate fi deschisă prin Setări → Avansat → Setări jurnal . Comenzile rapide de la tastatură documentate sunt F12 pe Windows, Ctrl+L pe Linux și Cmd+L pe macOS. Activați jurnalizarea într-un folder temporar, reproduceți problema, apoi salvați fișierele care acoperă perioada de timp afectată.
De asemenea, puteți porni aplicația cu o înregistrare mai detaliată. De exemplu, pe Windows:
Nu publicați jurnalele rezultate în mod informal. ownCloud avertizează că acestea pot conține nume de fișiere și foldere, metadate, adrese URL ale serverului și alte informații private. Partajați-le în mod privat cu administratorul corespunzător sau cu asistența ownCloud atunci când este necesar.
O cale decizională compactă
Ceea ce vezi
Cea mai bună acțiune următoare
Mesajul exact: Eroare necunoscută CSync
Închideți ownCloud, ștergeți ._sync_xxxxxxx.db, reporniți, apoi verificați setările de selecție a descărcărilor.
Eroarea reapare imediat
Verificați conectarea la browser, adresa URL a serverului, proxy-ul și compatibilitatea versiunii client/server.
Doar anumite fișiere eșuează
Verificați regulile pentru fișierele ignorate, caracterele interzise, numele Windows rezervate și lungimea căii.
Windows VFS afișează acces refuzat
Verificați dacă utilizatorul proprietar are control deplin asupra folderului de sincronizare.
Sincronizarea se oprește pe măsură ce spațiul de stocare se umple
Eliberați spațiu pe disc local și încercați din nou.
Cauza este încă neclară
Capturați un jurnal reproductibil al aplicației desktop și examinați-l în privat.
Notă privind versiunea pentru 2026
Informațiile despre versiunea curentă merită verificate înainte de a „remedia” problema prin actualizare. Aplicația desktop ownCloud 7.1.1 a fost lansată în septembrie 2026, dar linia 7.x este pentru ownCloud Infinite Scale. Notele de lansare ale ownCloud precizează că utilizatorii ownCloud Classic Server 10 sau 11 ar trebui să rămână la linia 6.x Desktop App. O actualizare majoră incompatibilă poate crea o altă problemă de conexiune în loc să rezolve eroarea CSync.
Concluzie
Pentru eroarea exactă CSync necunoscută , începeți cu documentele de reparare restrânse din ownCloud: închideți complet aplicația desktop, dezvăluiți fișierele ascunse, ștergeți ._sync_xxxxxxx.dbjurnalul afectat și reporniți. Tratați acest lucru ca o resetare a stării de sincronizare locală, nu ca o permisiune de a șterge datele utilizatorului. Dacă problema reapare, investigați conectivitatea, spațiul pe disc, permisiunile, regulile pentru numele fișierelor, software-ul de sincronizare concurent și jurnalele în această ordine.