🛠️ Nextcloud Troubleshooting
Corrigindo os principais avisos da aba de Segurança e Configuração
⚠️ Ao acessar a aba Segurança & avisos de configuração, sua instância pode exibir diversas mensagens de alerta. Este guia explica como corrigir os principais erros, diretamente via terminal ou configurações do painel.
🔐 1. HTTPS não configurado
Erro: A instância está acessível via HTTP, o que compromete a segurança.
✅ Solução:
- Acesse o painel Saveincloud > Acesse a página de Add-on
- Instale o Certificado SSL com o Add-on do Let's Encrypt
- No campo Domínios Externos, preencha com o próprio dominio se utilizar um dominio externo, ou com o próprio Hostname da Plataforma, se estiver acessando via URL do Ambiente
⚡ 2. PHP OPcache não configurado
Erro: O OPcache não está habilitado no PHP, impactando desempenho.
✅ Solução:
Edite o php.ini do container Apache e adicione:
opcache.enable=1
opcache.enable_cli=1
opcache.memory_consumption=128
opcache.interned_strings_buffer=8
opcache.max_accelerated_files=10000
opcache.revalidate_freq=1
opcache.validate_timestamps=1
Se essas configurações já estiverem ativas e o aviso persistir, certifique-se que a linha do Zend está descomentada:
🌐 3. Erro em /.well-known/caldav
✅ Solução:
No seu servidor Apache/NGINX, redirecione corretamente:
Redirect 301 /.well-known/caldav /remote.php/dav
Redirect 301 /.well-known/carddav /remote.php/dav
🕑 4. Janela de manutenção não definida
✅ Solução:
Edite o config.php da instância e adicione:
'maintenance_window_start' => 2, // Início às 2h da manhã
📦 5. Migrações de mimetypes pendentes
✅ Solução:
Execute o comando dentro do diretório /var/www/webroot/ROOT:
php occ maintenance:repair --include-expensive
🧯 6. Cabeçalho HSTS ausente
✅ Solução:
Em seu proxy reverso ou servidor Apache, adicione:
<VirtualHost *:443>
ServerName exemplo.dominio.com
<IfModule mod_headers.c>
Header always set Strict-Transport-Security "max-age=15552000; includeSubDomains"
</IfModule>
</VirtualHost>
🧬 7. Índices ausentes no banco de dados
✅ Solução:
Execute o comando dentro do diretório /var/www/webroot/ROOT:
php occ db:add-missing-indices
Isso irá criar todos os índices ausentes listados automaticamente.
📝 8. Uso de banco para lock de arquivos
✅ Solução:
Configure um Memcache local no config.php localizado no diretório ROOT:
'memcache.locking' => '\\OC\\Memcache\\APCu',
E ative o módulo PHP apcu.
🧠 9. Cache de memória não configurado
✅ Solução:
No mesmo config.php, adicione:
'memcache.local' => '\\OC\\Memcache\\APCu',
🌍 10. Região padrão de telefone não definida
✅ Solução:
Edite o config.php e inclua:
'default_phone_region' => 'BR',
📧 11. Servidor de e-mail não configurado
✅ Solução:
Acesse:
Configurações > Configurações Básicas > E-mail
Preencha os campos com servidor SMTP, porta, usuário e senha. Clique em "Enviar e-mail" para testar.
🧪 12. Módulo sodium ausente
Erro: Recomendado para segurança de senhas com Argon2.
✅ Solução:
Adicione as linhas no arquivo de configuração php em /etc/php.ini
[sodium]
extension=/usr/lib64/php/modules/sodium.so
🖼️ 13. Módulo imagick ausente
Erro: Requerido para geração de favicons e temas.
✅ Solução:
Descomente as linhas que se referem ao módulo Imagick em etc/php.ini:
[imagick]
;http://php.net/manual/en/book.imagick.php
extension=imagick.so
imagick.locale_fix = 0 ; Fixes a drawing bug with locales that use ',' as float separators
imagick.progress_monitor = 0 ; Used to enable the image progress monitor
📋 Logs Adicionais
Caso deseje analisar os logs diretamente:
php occ log:tail
Ou navegue até:
Configurações > Logs > Ver registros recentes
🧩 Dica Final
Muitos dos problemas podem ser resolvidos com os comandos do CLI do Nextcloud. Veja a lista completa com:
php occ list
Recomendamos a leitura das documentação oficial do nextcloud para mais informações.
🧠 Verificações recomendadas:
- Verifique permissões de pastas (
data,config,apps) - Mantenha o sistema sempre atualizado
- Faça backups dos arquivos de configuração antes de alterações maiores