Esempio illustrativo: Jordan sta sincronizzando una cartella di progetto locale con l'app desktop ownCloud su Windows. L'account ha funzionato normalmente, ma improvvisamente il client segnala un errore sconosciuto di CSync e interrompe la sincronizzazione. I file sono ancora presenti in locale e visibili nell'interfaccia web di ownCloud. Questo esempio è ipotetico; viene utilizzato solo per mostrare come applicare i passaggi di risoluzione dei problemi documentati.
La buona notizia è che ownCloud documenta una soluzione specifica di primo livello per questo messaggio: chiudere l'app desktop, eliminare il ._sync_xxxxxxx.dbfile nascosto dalla cartella di sincronizzazione interessata e riavviare l'app. Quel database è il registro di sincronizzazione locale. Ricostruirlo può ripristinare uno stato di sincronizzazione danneggiato o incoerente, ma ownCloud avverte che eliminandolo si rimuovono anche alcune impostazioni che controllano quali file vengono scaricati.
A ottobre 2026, la documentazione di ownCloud Desktop App 7.1 riportava ancora questa procedura per l'errore sconosciuto di CSync . Si noti inoltre l'attuale suddivisione del prodotto: Desktop App 7.x supporta solo ownCloud Infinite Scale; gli amministratori che utilizzano ownCloud Classic Server 10 o 11 dovrebbero rimanere sulla serie Desktop App 6. Consultare le note di rilascio ufficiali di ownCloud Desktop App prima di effettuare un aggiornamento a una versione principale.
Il messaggio è volutamente generico. Non identifica un singolo errore lato server, un nome file errato o un problema di autorizzazioni. La documentazione attuale per la risoluzione dei problemi dell'app desktop di ownCloud lo considera innanzitutto un problema di stato di sincronizzazione e raccomanda di ricostruire il database di sincronizzazione locale prima di procedere a una diagnosi più approfondita.
L'ordine è importante. Nel caso ipotetico di Jordan, la mossa più sicura da fare inizialmente è non eliminare la cartella del progetto locale, rimuovere l'account o cancellare i dati del server. La procedura di riparazione documentata si concentra esclusivamente sul database di sincronizzazione nascosto utilizzato da quella connessione di sincronizzazione.
Chiudi l'app desktop ownCloud prima di accedere al suo database di sincronizzazione. Non limitarti a ridurre a icona la finestra. Utilizza la funzione di chiusura o di uscita dell'applicazione in modo che il client non scriva più nel registro.
Nell'esempio, Jordan attende innanzitutto che qualsiasi attività visibile si interrompa, chiude ownCloud e verifica che l'applicazione non sia più in esecuzione. Questo riduce la possibilità di eliminare un file di database mentre il client lo ha ancora aperto.
Il file che ownCloud ti chiede di rimuovere è nascosto. Apri la directory principale della cartella di sincronizzazione di ownCloud interessata e abilita la visualizzazione degli elementi nascosti nel tuo gestore file. Su Windows, Esplora file può mostrare gli elementi nascosti tramite i controlli di visualizzazione. Su macOS o Linux, utilizza il metodo standard di visualizzazione dei file nascosti del tuo gestore file.
Cerca un nome file che corrisponda al modello:
._sync_xxxxxxx.dbI caratteri esatti che seguono ._sync_possono variare. Non eliminare documenti o cartelle comuni solo perché hanno un nome simile.
._sync_….dbregistro nascosto nella directory di sincronizzazione interessata.Con ownCloud completamente arrestato, elimina il ._sync_xxxxxxx.dbfile corrispondente. La pagina ufficiale di risoluzione dei problemi raccomanda specificamente di eliminare questo file e quindi riavviare l'applicazione desktop.
Nell'esempio di Jordan, questo è l'unico file rimosso. I dati locali del progetto rimangono intatti. Questa distinzione è importante perché l'eliminazione dell'intera cartella di sincronizzazione locale può creare un problema di ripristino non necessario, mentre l'eliminazione del file di registro documentato consente a ownCloud di ricostruire il proprio stato di sincronizzazione locale.
Prima di procedere: ownCloud avverte che questa operazione potrebbe cancellare alcune impostazioni che determinano quali file vengono scaricati. Se utilizzi la sincronizzazione selettiva o hai escluso intenzionalmente cartelle di grandi dimensioni, prendi nota di queste scelte in modo da poterle rivedere dopo il riavvio.
Avvia nuovamente l'app desktop. Dovrebbe ricreare il database di sincronizzazione locale e riesaminare la relazione tra la cartella locale e il server. Concedi al client il tempo necessario per completare la rilevazione prima di concludere che la correzione non ha funzionato, soprattutto se la struttura di sincronizzazione contiene molti file.
Il criterio di successo ipotetico di Jordan è semplice: l'errore CSync non si ripresenta immediatamente, il client avvia la scansione o la sincronizzazione e l'account raggiunge infine uno stato aggiornato. Se le impostazioni di sincronizzazione selettiva sono cambiate, Jordan le esamina prima di consentire download di grandi dimensioni.
L'eliminazione del database di sincronizzazione è la soluzione documentata per lo specifico errore CSync, ma non può risolvere tutte le condizioni che possono causare l'interruzione della sincronizzazione. Se il messaggio si ripresenta, utilizzare lo stato ricostruito come punto di partenza pulito e verificare uno per uno i seguenti elementi.
Accedi all'interfaccia web di ownCloud tramite un browser. ownCloud consiglia di eseguire questo come primo test di connettività di base. Se l'interfaccia web non è disponibile, le credenziali non funzionano o tutti i client desktop non funzionano mentre il sito web è ancora attivo, chiedi all'amministratore di verificare l'istanza, l'URL di connessione e le impostazioni del proxy.
La guida alla risoluzione dei problemi di ownCloud 7.1 afferma che un download viene saltato o interrotto se ridurrebbe lo spazio libero su disco al di sotto di 250 MB e la sincronizzazione si interrompe completamente se lo spazio libero rimanente scende al di sotto di 50 MB. Assicurati di avere spazio libero ben al di sopra di queste soglie prima di riprovare.
Su Windows con file virtuali, può verificarsi un errore di accesso negato ai metadati se l'utente proprietario non dispone più delle autorizzazioni previste sulla cartella sincronizzata. La documentazione di ownCloud indica che l'utente proprietario dovrebbe avere il controllo completo . Se i log contengono questo errore WindowsError: ffffffff80070005: Access is denied., rivedi le autorizzazioni di sicurezza della cartella o chiedi al tuo amministratore di farlo.
La ricostruzione del journal non renderà sincronizzabile un nome file non valido. La pagina ufficiale di ownCloud relativa alle considerazioni sui nomi file indica che Windows non consente caratteri come <, >, :, ", \, |, ?, e *, e che i nomi file non possono terminare con uno spazio o un punto. Anche i nomi riservati di Windows come CON, PRN, AUX, NUL, COM1da a COM9e LPT1da LPT9possono causare problemi.
Per Windows VFS, ownCloud documenta anche una limitazione comune di 260 caratteri per i componenti del percorso, a meno che il sistema operativo non sia configurato per derogare a tale limite. Se il problema riguarda solo un file annidato in profondità, è possibile accorciare il percorso o seguire le linee guida di Microsoft per la configurazione di percorsi lunghi, disponibili tramite il link nella documentazione di ownCloud.
ownCloud sconsiglia esplicitamente di sincronizzare la stessa directory locale con un altro strumento di sincronizzazione come OneDrive, Dropbox, rsync, Unison o File offline di Windows. Applicazioni concorrenti possono modificare metadati o file reciproci e, nel peggiore dei casi, causare la perdita di dati. Se Jordan avesse inserito la stessa directory anche in un altro servizio di sincronizzazione cloud, la soluzione corretta sarebbe stata quella di separare le directory di sincronizzazione anziché eliminare ripetutamente il registro di ownCloud.
Se l'errore CSync si ripresenta dopo la reinstallazione completa, acquisire i log relativi a un tentativo di sincronizzazione riproducibile. ownCloud afferma che il log dell'app desktop è spesso l'elemento diagnostico più utile.
Nell'app desktop 7.1, è possibile attivare la registrazione tramite Impostazioni → Avanzate → Impostazioni di registrazione . Le scorciatoie da tastiera documentate sono F12 su Windows, Ctrl+L su Linux e Cmd+L su macOS. Abilita la registrazione in una cartella temporanea, riproduci il problema, quindi salva i file relativi al periodo di tempo interessato.
È anche possibile avviare l'app con una registrazione più dettagliata. Ad esempio, su Windows:
& 'C:\Program Files\ownCloud\ownCloud.exe' --logfile - --logflush --logdebugNon pubblicare i log risultanti con leggerezza. ownCloud avverte che possono contenere nomi di file e cartelle, metadati, URL del server e altre informazioni private. Condividili privatamente con l'amministratore competente o con l'assistenza di ownCloud quando necessario.
| Ciò che vedi | Migliore azione successiva |
|---|---|
| Messaggio esatto: Errore sconosciuto CSync | Chiudi ownCloud, eliminalo ._sync_xxxxxxx.db, riavvialo e poi rivedi le impostazioni di selezione del download. |
| L'errore si verifica immediatamente | Verificare l'accesso tramite browser, l'URL del server, il proxy e la compatibilità tra le versioni client e server. |
| Solo alcuni file non funzionano | Verifica le regole relative ai file ignorati, i caratteri non consentiti, i nomi riservati di Windows e la lunghezza del percorso. |
| Windows VFS mostra l'accesso negato | Verifica che l'utente proprietario disponga del controllo completo sulla cartella di sincronizzazione. |
| La sincronizzazione si interrompe quando lo spazio di archiviazione si riempie. | Libera spazio sul disco locale e riprova. |
| La causa non è ancora chiara. | Acquisisci un registro riproducibile dell'applicazione desktop e analizzalo in privato. |
Prima di "risolvere" il problema con un aggiornamento, è consigliabile verificare le informazioni sulla versione corrente. L'app desktop ownCloud 7.1.1 è stata rilasciata a settembre 2026, ma la serie 7.x è destinata a ownCloud Infinite Scale. Le note di rilascio di ownCloud indicano che gli utenti di ownCloud Classic Server 10 o 11 dovrebbero rimanere sulla serie 6.x dell'app desktop. Un aggiornamento importante incompatibile potrebbe creare un problema di connessione diverso anziché risolvere l'errore CSync.
Per risolvere l' errore CSync Unknown Error , iniziate seguendo la procedura di riparazione specifica descritta da ownCloud: chiudete completamente l'app desktop, visualizzate i file nascosti, eliminate il ._sync_xxxxxxx.dbregistro interessato e riavviate il programma. Considerate questa operazione come un ripristino dello stato di sincronizzazione locale, non come un'autorizzazione per eliminare i dati utente. Se il problema si ripresenta, verificate, in quest'ordine, la connettività, lo spazio su disco, le autorizzazioni, le regole di denominazione dei file, i software di sincronizzazione concorrenti e i registri.
Risolvi l'avviso di Nextcloud relativo alla mancanza di HSTS configurando il server web HTTPS o il proxy inverso, quindi verifica in modo sicuro l'intestazione Strict-Transport-Security.
Risolvi l'errore "CSync Unknown Error" del client ownCloud Desktop ricostruendo il database di sincronizzazione nascosto, quindi verifica la connettività, le autorizzazioni, i nomi dei file, lo spazio su disco e i log.
Il proxy Matrix Sliding Sync è stato archiviato e sostituito. Abilitare la sincronizzazione Simplified Sliding Sync nativa in Synapse, verificare il supporto del client, aggiornare il routing del proxy e testare la sincronizzazione mobile in modo sicuro.
Diagnostica i rallentamenti nella federazione Matrix Synapse e nell'adesione alle stanze verificando la connettività, lo stato dei tentativi del server remoto, le metriche, il carico del database e i limiti di frequenza di adesione.
Configura la conservazione del cestino e le attività in background di Nextcloud per rimuovere automaticamente i file eliminati, verificare l'avvenuta pulizia ed evitare comandi di eliminazione sicura per tutti gli utenti.
Diagnostica l'eco di BigBlueButton e il ritardo audio di WebRTC separando il feedback del microfono dal ritardo di rete, verificando il test dell'eco, i dispositivi del browser, la connettività UDP e il carico del server.
Configura un repository Restic crittografato e un'attività pianificata (cron job) per Nextcloud, includendo la modalità di manutenzione, un dump di MariaDB, la conservazione dei dati, i log e i controlli di ripristino.
Risolvi i problemi di caricamento su ownCloud bloccati al 99% controllando i log, lo spazio di archiviazione temporaneo, lo spazio dei chunk, i limiti PHP, le sessioni, i proxy e il blocco dei file nell'ordine corretto.
Abilita e applica correttamente l'autenticazione a due fattori (2FA) di Zimbra, registra un account amministratore, scegli la verifica tramite TOTP o e-mail e testa l'accesso alla Console di amministrazione.
Configura Mjolnir per la moderazione di Matrix: crea un account bot dedicato, configura la sua sala di controllo, proteggi le stanze, gestisci le liste di ban e verifica le autorizzazioni in modo sicuro.
