Obtenha a sincronização do Nextcloud Desktop e supere a fase de "Processando arquivos".

Se o cliente Nextcloud Desktop permanecer em "Processando arquivos", abra o histórico de sincronização da conta e verifique se algum arquivo apresenta erro repetidamente ou se o cliente ainda está escaneando uma árvore de pastas grande. Verifique esse item primeiro e, em seguida, revise as regras de arquivos ignorados e a conexão com o servidor. Reiniciar o serviço pode resolver uma paralisação temporária, mas excluir o banco de dados de sincronização ou recriar a conexão de sincronização deve ser uma medida posterior, pois pode redefinir as opções de sincronização seletiva ou acionar uma nova verificação completa.

Descubra o que realmente está travado

Abra o menu do Nextcloud na bandeja do sistema no Windows ou Linux, ou na barra de menus no macOS, e acesse o status da conta. Procure por nomes de arquivos repetidos, erros visíveis ou filas que mudam. O cliente distingue os estados de sincronização, pausado, offline, aviso e erro; um ícone de atividade azul, por si só, não comprova que os dados estão sendo enviados. No modo de sincronização clássico, as sobreposições do gerenciador de arquivos podem ajudar: azul indica uma sincronização em espera ou ativa, uma marca de seleção verde significa que está em andamento e um X vermelho indica um erro. O modo Arquivos Virtuais/Provedor de Arquivos usa indicadores de status diferentes do sistema operacional; portanto, verifique a janela do cliente e os detalhes no Finder ou no Explorador de Arquivos em vez de presumir que os ícones do modo clássico se aplicam.

Se o número de itens pendentes estiver diminuindo, deixe o cliente em execução e permita que a verificação termine, especialmente após adicionar uma pasta grande ou reconectar um dispositivo. Se o mesmo item permanecer no topo, abra os detalhes do erro. Anote o caminho local e a mensagem exata antes de mover, renomear ou editar qualquer coisa. Evite pausar e retomar repetidamente enquanto a fila estiver sendo alterada; isso não revela a causa e pode dificultar a avaliação do progresso.

Verifique as regras de arquivo e arquivo ignorado.

Quando um arquivo estiver bloqueando o progresso, compare seu nome, caminho e estado local com a cópia no servidor na interface web do Nextcloud. Confirme se o arquivo não está aberto em um editor, sendo editado por uma câmera ou programa de backup, ou bloqueado por outro processo. Se um aplicativo estiver alterando o arquivo ativamente, feche-o completamente e deixe o cliente tentar novamente. Não exclua nenhuma das cópias apenas para limpar o status.

Alguns arquivos são ignorados deliberadamente. O Nextcloud exclui certos arquivos de sistema e nomes que não podem ser representados em outros sistemas de arquivos. Nas configurações do cliente, abra Avançado → Editar Arquivos Ignorados (os rótulos podem variar de acordo com a versão do cliente) e revise os padrões personalizados para o nome afetado ou sua pasta pai. Um caractere curinga, como \, *corresponde a vários caracteres; ?\ corresponde a um caractere; uma barra invertida no final limita um padrão a diretórios. Remova ou restrinja uma regra personalizada somente se o arquivo precisar ser sincronizado. Não edite o arquivo global sync-exclude.lstfornecido com o aplicativo como primeira solução; o Nextcloud alerta que alterar esse arquivo pode causar comportamentos inesperados.

Verifique também o status das pastas ignoradas ou não sincronizadas do cliente e as opções de sincronização seletiva. Uma pasta excluída intencionalmente não será sincronizada apenas porque o cliente foi reiniciado. Se o problema afetar apenas um caminho específico, testar temporariamente uma cópia em uma pasta simples pode ajudar a distinguir uma regra específica do caminho de um problema geral de conexão, mas não use um segundo serviço de sincronização em nuvem no mesmo diretório de sincronização ativo.

Separe um problema do cliente de um problema de conexão com o servidor.

Faça login na mesma conta do Nextcloud em um navegador e confirme se os arquivos e pastas carregam. Se a interface web funcionar, mas todos os dispositivos desktop apresentarem problemas, o endpoint WebDAV do servidor ou sua configuração podem estar envolvidos. O cliente Nextcloud usa WebDAV para acessar os arquivos do servidor. Para um servidor instalado em `/var/www/nextcloud` https://cloud.example.com, seu endpoint DAV geralmente é `/ var/www/nextcloud` https://cloud.example.com/remote.php/dav; use o caminho de instalação real do seu servidor. Abrir esse endereço em um navegador deve, no mínimo, solicitar autenticação ou exibir uma resposta do endpoint. Falhas de autenticação, avisos de certificado ou erros do servidor indicam que você deve entrar em contato com o administrador ou verificar os logs do servidor, em vez de reiniciar o cliente local.

Verifique se outro programa de sincronização, utilitário de backup ou recurso de arquivos offline também está gerenciando o mesmo diretório. O manual de solução de problemas do Nextcloud afirma que a sincronização de um diretório com vários aplicativos de sincronização não é suportada e pode resultar em perda de dados. Remova a sobreposição somente após identificar qual aplicativo é o proprietário da pasta e preservar as alterações locais. Se apenas um computador for afetado, verifique o espaço em disco local, as permissões da pasta, o antivírus ou a verificação em tempo real e se o cliente pode ler e renomear arquivos no diretório de sincronização.

Reinicie e, em seguida, colete um diagnóstico útil.

1. Aguarde até que qualquer operação de arquivo ativa seja concluída e, em seguida, feche o cliente de desktop pela bandeja do sistema ou pela barra de menus. Inicie-o novamente e observe se a contagem de operações pendentes muda.
2. Se o cliente ainda apresentar problemas, abra as configurações e selecione Avançado → Criar arquivo de depuração… para salvar um arquivo de diagnóstico. A localização exata dessa opção pode variar de acordo com a versão e a plataforma.
3. Analise o registro de eventos no período em que o status parou de mudar. Procure pelo caminho afetado e por erros repetidos, como acesso negado, falha de conexão ou restrição de nome de arquivo.

Os arquivos de depuração incluem registros e informações do banco de dados e podem conter nomes de arquivos confidenciais, detalhes da conta ou endereços do servidor. Revise e oculte essas informações antes de compartilhá-las com o suporte. A documentação de solução de problemas do Nextcloud descreve o arquivo de depuração e outras maneiras de capturar registros do cliente.

Use a redefinição do banco de dados somente para erros correspondentes.

Não exclua rotineiramente o banco de dados de sincronização do cliente para corrigir um status genérico de "Processando arquivos". O Nextcloud documenta uma solução mais específica para o erro "CSync desconhecido" : pare o cliente, localize o .sync_xxxxxxx.dbarquivo oculto dentro da pasta da conta configurada pelo cliente e remova esse banco de dados antes de reiniciar. A documentação alerta que isso também apaga algumas configurações sobre quais arquivos baixar. Faça backup da pasta de sincronização local e anote as configurações de sincronização seletiva primeiro; nunca remova um banco de dados enquanto o cliente estiver em execução. Se o erro exato não estiver presente, inspecione o arquivo de depuração ou entre em contato com o suporte antes de tentar essa recuperação.

Confirme se a sincronização foi restabelecida.

Após a alteração, verifique mais do que apenas o desaparecimento do indicador de carregamento. A fila de pendências deve ser esvaziada, o cliente deve exibir um estado atualizado e conectado, e um pequeno arquivo de teste deve aparecer no local esperado, tanto localmente quanto na interface web. Confirme se o arquivo originalmente afetado contém o conteúdo pretendido e se as pastas de sincronização seletiva permanecem como configuradas. Se o mesmo arquivo falhar novamente, preserve o erro exato e um arquivo de depuração com informações confidenciais ocultadas; um problema recorrente de permissão, nome de arquivo, WebDAV ou versão do cliente requer uma correção específica.

Para obter informações sobre os controles atuais do cliente e as etapas de solução de problemas, consulte o manual do usuário do Nextcloud Desktop Client e a documentação de solução de problemas do Nextcloud Desktop . O manual do usuário online atual é para o Nextcloud 36; os rótulos do cliente e os recursos de Arquivos Virtuais disponíveis podem variar de acordo com a versão do cliente desktop e o sistema operacional.