Se Nextcloud Desktop rimane bloccato su "Elaborazione file" , non iniziare eliminando il database di sincronizzazione o la cartella locale. La prima cosa da fare è verificare se il client sta ancora eseguendo la scansione, se un file continua a non essere elaborato correttamente o se il client ha effettivamente smesso di procedere. In molti casi la soluzione è molto più semplice: metti in pausa e riprendi la sincronizzazione, chiudi un'applicazione che blocca un file, rinomina un file con un nome incompatibile, rimuovi un altro strumento di sincronizzazione dalla stessa cartella o aggiorna il client desktop.
Al 6 ottobre 2026, l'ultima versione stabile disponibile sul sito ufficiale del progetto Nextcloud Desktop è la 34.0.4 ; le build RC 35.0.0 sono versioni preliminari. La documentazione di Nextcloud avverte inoltre che l'utilizzo della stessa directory con un altro sistema di sincronizzazione non è supportato e può portare a risultati inaffidabili o addirittura alla perdita di dati. Iniziate con i controlli meno invasivi descritti di seguito e ricostruite la connessione di sincronizzazione solo dopo esservi assicurati che i file sul server e sul computer siano al sicuro.
"Elaborazione" può significare che il client sta rilevando modifiche alle cartelle, confrontando metadati, preparando caricamenti o lavorando su una struttura ad albero complessa. Se il file corrente, l'elenco delle attività, l'utilizzo del disco o l'output del registro sono in fase di modifica, il client potrebbe essere ancora in fase di elaborazione. Una cartella molto grande, una prima sincronizzazione o una cartella contenente molti file di piccole dimensioni possono richiedere molto più tempo nella fase di rilevamento rispetto a una semplice cartella di documenti.
Apri la finestra principale di Nextcloud e controlla l'attività recente. Quindi apri la cartella di sincronizzazione locale e ordina i file per data di modifica oppure controlla le sovrapposizioni dello stato dei file. Se vengono modificati file diversi nel tempo, attendi che il ciclo corrente termini prima di modificare la configurazione. Se lo stesso percorso o messaggio si ripete e non cambia nient'altro, passa al passaggio successivo.
Nextcloud documenta le icone di stato del desktop e la finestra delle attività nella sua guida ufficiale all'utilizzo del client desktop .
Se un client ha smesso di avanzare, usa il menu della cartella per mettere in pausa la sincronizzazione, attendi che lo stato cambi e riprendila. Se questo non risolve il problema, chiudi completamente Nextcloud e riavvialo. In questo modo il processo bloccato viene ripristinato senza modificare la relazione di sincronizzazione o eliminare alcun file.
Questa procedura è particolarmente indicata dopo che un laptop si riattiva dalla modalità di sospensione, una VPN cambia rete, un'unità montata si riconnette o un'applicazione che aveva aperto un file sincronizzato è stata appena chiusa. Riavviare l'intero computer è consigliabile se si sospetta un file bloccato, ma non dovrebbe essere l'unico passaggio diagnostico: se lo stesso file causa nuovamente il blocco, i log forniranno maggiori informazioni.
Una sincronizzazione può sembrare bloccata a livello globale, mentre il problema reale è localizzato in un singolo percorso. Cerca un'icona di errore rossa, una voce di avviso, la ripetizione del nome del file nell'elenco delle attività o un messaggio di registro che menziona ripetutamente lo stesso file.
Tra le cause più comuni a livello di file si annoverano un file ancora aperto in modalità di scrittura esclusiva, un percorso a cui l'utente corrente non può accedere in lettura o scrittura, un file che continua a cambiare mentre Nextcloud tenta di elaborarlo, oppure un nome file non rappresentabile dal filesystem di destinazione. Windows rappresenta un caso particolarmente importante, poiché un nome file valido su un server Nextcloud ospitato su Linux potrebbe non esserlo su Windows. Nextcloud Server può essere configurato per imporre nomi file compatibili con Windows; la documentazione ufficiale illustra la restrizione e fornisce esempi, come nomi riservati e caratteri proibiti, nella guida ai nomi file compatibili con Windows .
Se un file risulta essere la causa del problema, chiudete il programma che lo utilizza, rinominatelo con un nome semplice e compatibile con diverse piattaforme, se necessario, e assicuratevi che il vostro account disponga dei permessi di lettura/scrittura per la cartella locale. Dopodiché, riprendete la sincronizzazione e verificate se la coda avanza.
Nextcloud include un editor per i file ignorati e un elenco di esclusione integrato. Il client esclude anche i file con caratteri che non possono essere sincronizzati con un altro file system. Se una determinata directory non si sincronizza mai, rivedi i tuoi modelli di esclusione personalizzati e assicurati che un carattere jolly generico non corrisponda a più elementi del previsto.
Non modificare casualmente il sync-exclude.lstfile globale. Il manuale di Nextcloud avverte specificamente che la modifica della definizione globale di esclusione può rendere il client inutilizzabile o causare comportamenti indesiderati. Utilizza l'editor per le regole personalizzate, a meno che tu non abbia un motivo valido per modificare l'elenco predefinito.
Assicurati inoltre che la cartella Nextcloud non sia gestita contemporaneamente da OneDrive, Dropbox, Syncthing, rsync, File offline di Windows o altri prodotti di sincronizzazione. La pagina ufficiale di risoluzione dei problemi di Nextcloud afferma che la sincronizzazione della stessa directory con Nextcloud e un altro sistema di sincronizzazione non è supportata. Se due strumenti monitorano la stessa struttura di cartelle, sposta uno di essi in una cartella separata anziché tentare di farli coesistere.
Se il client rileva correttamente i file ma i trasferimenti non procedono, controlla la scheda Rete. Un proxy manuale obsoleto, un proxy solo VPN o limiti di larghezza di banda molto bassi possono far sembrare bloccata una sincronizzazione che in realtà funziona correttamente. Se le tue policy lo consentono, prova temporaneamente con una connessione diretta e affidabile.
Nextcloud segnala inoltre che la scansione antivirus in tempo reale può rallentare le prestazioni di caricamento e download sia sul server che sul client. Ciò non significa che si debba disabilitare la protezione degli endpoint come soluzione predefinita. Piuttosto, verificate se il software di sicurezza sta eseguendo ripetutamente la scansione dello stesso file di grandi dimensioni o che cambia rapidamente e, se necessario, consultate l'amministratore per stabilire un'esclusione per il vostro ambiente.
Verifica anche lo spazio libero su disco del computer e la quota disponibile sul server Nextcloud. Un client non può completare i download se il disco locale è pieno e gli upload possono fallire se l'account del server o il backend di archiviazione non hanno spazio disponibile.
Prima di dedicare tempo a modifiche al database, confronta il client installato con la versione stabile più recente. Il 6 ottobre 2026, il progetto ufficiale ha indicato la versione 34.0.4 come l'ultima versione stabile, mentre le build RC 35.0.0 sono versioni preliminari. La versione 34.0.x include diverse correzioni relative al rilevamento, a Windows, macOS e al file provider, quindi un aggiornamento è consigliabile se si utilizza una versione precedente supportata.
Utilizza l'aggiornamento del client oppure scarica il programma di installazione dai canali di distribuzione ufficiali di Nextcloud. La cronologia ufficiale delle versioni è disponibile nella pagina delle release di Nextcloud Desktop . Evita di installare una release candidate su una workstation di produzione solo per risolvere un problema di sincronizzazione, a meno che tu non la stia testando intenzionalmente e possa ripristinare la versione precedente.
Se il problema persiste anche dopo un riavvio e un aggiornamento, il log del client è il passo successivo più utile. Nextcloud offre due metodi ufficiali: creare un archivio di debug dalle impostazioni oppure aprire la finestra del log tramite la scorciatoia da tastiera documentata. L'archivio di debug contiene i log e il database del client, quindi trattatelo come dati sensibili e oscurate o limitate le informazioni che condividete.
Cerca messaggi ripetuti che coinvolgono lo stesso percorso, errori di autenticazione, errori di autorizzazione, messaggi del tipo "impossibile aprire", errori di connessione, errori HTTP del server o errori del registro di sincronizzazione. Un errore ripetibile è più utile di un'etichetta generica "Elaborazione file".
La documentazione ufficiale di Nextcloud per la risoluzione dei problemi spiega come creare l'archivio di debug e avverte che i log del desktop potrebbero contenere informazioni sensibili.
Se i log indicano uno stato di sincronizzazione danneggiato o se la relazione tra le cartelle rimane inutilizzabile dopo i controlli precedenti, come ultima risorsa ricostruisci la connessione di sincronizzazione delle cartelle. Crea prima un archivio di debug, quindi verifica nell'interfaccia web che la copia sul server contenga quanto previsto. Esegui un backup separato di tutti i file presenti solo localmente che non sono stati caricati.
Dopodiché, rimuovi la connessione di sincronizzazione delle cartelle dal client desktop e aggiungila nuovamente, scegliendo le cartelle locali e del server corrette. Non interpretare "rimuovi connessione di sincronizzazione delle cartelle" come un'autorizzazione a eliminare i dati locali o la directory dei dati del server. La directory dei dati di un server Nextcloud self-hosted è gestita da Nextcloud e non deve essere modificata manualmente.
Gli utenti esperti a volte riscontrano messaggi relativi a .sync_*.dbfile obsoleti o duplicati. Il codice sorgente del client Nextcloud include indicazioni per la gestione di database di sincronizzazione obsoleti e inutilizzati in specifiche situazioni multi-account, ma l'eliminazione di un registro di sincronizzazione non è una soluzione universale da adottare immediatamente. Se non si riscontra un errore chiaramente correlato al registro, ricreare la connessione di sincronizzazione utilizzando i backup è più semplice da gestire e meno probabile che nasconda la causa originale.
| Ciò che vedi | Migliore azione successiva |
|---|---|
| L'attività o i nomi dei file continuano a cambiare | Lasciamo che l'attuale ciclo di scoperta/sincronizzazione continui. |
| Lo stesso file si ripete | Chiudi l'applicazione, controlla i permessi, rinomina il file se il nome non è compatibile, quindi riprova. |
| I trasferimenti non iniziano | Verifica proxy, VPN, limiti di banda, raggiungibilità del server, quota e spazio su disco. |
| Vengono saltati solo alcuni percorsi | Esamina i modelli dei file ignorati e la compatibilità dei nomi dei file. |
| La cartella di sincronizzazione viene utilizzata anche da un altro strumento cloud/di sincronizzazione | Separate le cartelle; non eseguite entrambi i motori di sincronizzazione sulla stessa directory. |
| Stai utilizzando un client desktop meno recente. | Aggiorna alla versione stabile più recente prima di procedere con riparazioni più approfondite. |
| Il client rimane bloccato dopo il riavvio e l'aggiornamento. | Crea un archivio di debug e analizza l'errore ripetuto. |
| Lo stato di sincronizzazione è chiaramente danneggiato | Esegui il backup dei file presenti solo in locale, verifica la copia sul server, quindi ricrea la connessione di sincronizzazione delle cartelle. |
Il modo più affidabile per risolvere il problema di Nextcloud Desktop bloccato su "Elaborazione file" è procedere per tentativi, anziché ripristinare tutto in una volta. Innanzitutto, verifica se il processo sta effettivamente procedendo. Quindi, metti in pausa e riprendi l'elaborazione, isola il file problematico, controlla le esclusioni e i software di sincronizzazione concorrenti, escludi eventuali problemi di rete o di archiviazione, aggiorna il client e analizza i log. La ricostruzione della connessione di sincronizzazione va eseguita solo alla fine del processo, dopo aver protetto entrambe le copie, quella locale e quella sul server.
Se il log indica un bug riproducibile sul client, prima di segnalarlo, è necessario acquisire la versione del client, il sistema operativo, la versione del server, l'errore esatto e un archivio di debug anonimizzato. Questo fornisce ai manutentori informazioni sufficienti per distinguere un problema di file locale da un difetto del client desktop o da un errore lato server.
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.
