Corrigir aviso do Nextcloud: "Alguns arquivos não passaram na verificação de integridade"

Após uma atualização ou alteração manual, você pode abrir a Visão Geral do administrador do Nextcloud e ver a mensagem “Alguns arquivos não passaram na verificação de integridade”. O aviso pode ser alarmante, mas não identifica uma falha universal. O Nextcloud verifica se o código do servidor e do aplicativo instalados corresponde aos arquivos assinados esperados. Um arquivo alterado ou ausente, um arquivo inesperado ou um problema com a assinatura do aplicativo podem acionar o alerta. Uma nova verificação relata o estado atual; ela não corrige os arquivos.

A página oficial de downloads do Nextcloud lista o Server 35.0.0, lançado em 16 de setembro de 2026, como a versão mais recente no momento da redação deste texto. A documentação de administração atual ainda orienta os administradores a inspecionarem o relatório de arquivos inválidos, corrigirem a causa específica e realizarem uma nova verificação. Os passos abaixo seguem esse processo consistente; a redação exata do menu pode variar de acordo com a versão ou o pacote de hospedagem.

1. Leia o relatório de arquivos inválidos antes de fazer qualquer alteração.

Inicie sessão como administrador e abra Definições de administração > Visão geral . No aviso de integridade, selecione Lista de ficheiros inválidos… (o rótulo pode ser ligeiramente diferente). Guarde ou copie o relatório para um local privado para poder compará-lo após a reparação. Ele identifica a aplicação ou área principal e lista condições como INVALID_HASH, MISSING_FILE, EXTRA_FILE, e EXCEPTION.

Faça backup da configuração do Nextcloud, do banco de dados e de qualquer código personalizado do aplicativo antes de substituir arquivos do servidor. Não edite arquivos signature.json, não gere uma assinatura substituta para silenciar o aviso e não remova arquivos apenas porque seus nomes aparecem no relatório. A verificação protege a autenticidade do código e também pode revelar um arquivo inesperado que merece investigação.

2. Associe o tipo de erro ao reparo correto.

Essas etiquetas são pistas diagnósticas, não provas de um ataque ou de que a instalação é segura. Uma edição local feita por um desenvolvedor, um arquivo de backup copiado, uma implantação incompleta e código não autorizado podem produzir resultados diferentes. Se você não conseguir explicar um arquivo PHP inesperado ou um arquivo principal alterado, preserve o relatório e investigue antes de excluí-lo ou sobrescrevê-lo.

3. Restaure os arquivos principais da versão exata do Nextcloud.

Se o relatório mencionar arquivos em core, como index.phpou version.php, verifique primeiro se uma atualização foi interrompida ou se um processo de implantação alterou o código. Confirme a versão instalada na Visão Geral do administrador ou com seus registros de implantação normais. Não copie um arquivo de uma versão diferente do Nextcloud: seu hash não corresponderá à versão instalada no servidor.

Use o atualizador compatível para concluir uma atualização interrompida, quando possível. Se precisar restaurar arquivos manualmente, baixe o arquivo de servidor correspondente na página oficial de downloads do Nextcloud, verifique o arquivo usando o checksum ou a assinatura PGP publicada e substitua apenas os arquivos de código do aplicativo afetados, seguindo as instruções de atualização do Nextcloud. Preserve config/o diretório de dados e quaisquer aplicativos ou temas mantidos localmente. Siga o procedimento de backup e modo de manutenção para o seu método de instalação; Docker, Snap, appliances e hospedagem gerenciada podem exigir seus próprios processos de atualização.

O guia de integridade do Nextcloud apresenta o mesmo princípio para um hash de núcleo inválido: restaure os arquivos corretos e, em seguida, faça uma nova verificação. Ao transferir arquivos via FTP, o guia recomenda especificamente o uso do modo de transferência binária. Evite executar uma atualização com a verificação de assinatura desativada como atalho. Um arquivo instalado manualmente que não foi verificado pode introduzir um novo problema de integridade e segurança.

4. Analise cuidadosamente os arquivos adicionais e as alterações personalizadas.

Uma EXTRA_FILEentrada pode ser um arquivo temporário remanescente, um backup do editor, um script personalizado ou algo que você não reconhece. Verifique o caminho completo, o carimbo de data/hora, o proprietário e o histórico de implantação. Se for uma ferramenta personalizada legítima, mova-a para fora do diretório de código do Nextcloud e exponha-a por meio de um aplicativo compatível ou serviço separado, conforme apropriado. Se for um backup obsoleto, remova-o somente depois de preservar tudo o que for necessário. Se um executável ou arquivo PHP inexplicável apareceu recentemente, trate isso como uma investigação de segurança: preserve as evidências, revise os logs de acesso e do servidor web e siga seu processo de resposta a incidentes em vez de simplesmente excluir o aviso.

Para um erro INVALID_HASHem um arquivo core que você editou intencionalmente, a solução definitiva é restaurar o arquivo core assinado e mover o comportamento personalizado para um aplicativo, tema ou ponto de extensão documentado e compatível. Não altere o hash esperado nem os metadados da versão para que a verificação seja aprovada. Distribuições personalizadas do Nextcloud têm considerações específicas sobre a ramificação de lançamento na documentação de assinatura de código; alterar essa configuração é para os mantenedores de uma distribuição personalizada, não sendo uma correção de rotina para uma instalação padrão.

5. Reparar a assinatura ou o arquivo do aplicativo

Se o relatório mencionar um diretório de aplicativos, identifique o ID do aplicativo e determine se ele foi atualizado, copiado manualmente ou modificado localmente. Use a interface de Aplicativos do Nextcloud ou seu método de implantação para atualizar ou reinstalar uma versão compatível de uma fonte confiável. Faça backup dos dados e da configuração específicos do aplicativo primeiro e verifique a compatibilidade com a sua versão principal do Nextcloud. Para um aplicativo personalizado ou desenvolvido internamente, solicite ao responsável pela manutenção um pacote assinado ou uma versão corrigida. O Nextcloud exige assinatura de código para aplicativos publicados em sua loja de aplicativos; os requisitos e a aplicação da assinatura podem variar para outras categorias de aplicativos, portanto, use a documentação relevante para desenvolvedores em vez de criar uma assinatura local.

Não sobrescreva o diretório de um aplicativo com um arquivo aleatório nem copie-o signature.jsonde outra versão. A assinatura descreve um código específico; misturar arquivos de versões diferentes pode gerar erros adicionais. Se precisar remover um aplicativo, use o processo de gerenciamento de aplicativos compatível e certifique-se de que a remoção não descartará dados importantes para sua organização.

6. Execute uma nova verificação de integridade.

Após reparar os arquivos relatados, retorne às configurações de Administração > Visão geral e selecione Verificar novamente… . Aguarde a conclusão da verificação e, em seguida, abra novamente a lista de arquivos inválidos. Se você administra o servidor via SSH, o Nextcloud 35 documenta esses comandos a partir do diretório de instalação do Nextcloud:

sudo -E -u www-data php occ integrity:check-core
sudo -E -u www-data php occ integrity:check-app calendar
sudo -E -u www-data php occ integrity:check-app --all

Substitua calendarpelo ID do aplicativo exibido no seu relatório. A www-dataconta é comum em instalações baseadas em Debian ou Ubuntu, mas o usuário do seu servidor web e o executável do PHP podem ser diferentes. Use a conta e o ambiente PHP corretos para o seu sistema; para instalações em contêineres, execute o comando equivalente dentro do contêiner apropriado. O manual atual do OCC afirma que uma verificação de aplicativo bem-sucedida pode não produzir nenhuma saída, a menos que o modo detalhado seja solicitado, enquanto as falhas listam detalhes.

Como saber se o aviso foi corrigido?

Reabra a Visão Geral do administrador e confirme se o aviso de integridade desapareceu após a nova verificação. Se ele persistir, compare o novo relatório com sua cópia salva: o mesmo caminho significa que o arquivo subjacente não foi restaurado ou que a versão usada está incorreta; um caminho diferente pode revelar um segundo problema. Execute novamente a verificação do núcleo ou do aplicativo relevante e revise o log do Nextcloud em busca de erros de assinatura. Confirme também se a instância realiza login, navegação de arquivos, uploads e downloads normalmente.

Se o aviso persistir após uma implantação, verifique se há automação, plugins ou scripts de manutenção manual que reescrevam arquivos dentro da árvore de código assinada. Se o relatório de integridade estiver limpo, mas os usuários ainda virem erros, o problema original pode ter uma causa diferente e deve ser solucionado separadamente. Para Nextcloud hospedado, envie ao provedor o relatório exato e a versão instalada; evite incluir senhas, chaves privadas ou conteúdo de arquivos do usuário.

Para obter detalhes específicos da versão, consulte a documentação de assinatura de código e integridade do Nextcloud , a referência de verificação de integridade do OCC , o manual do atualizador do Nextcloud e a página oficial de downloads .