Tutoriais de VPS
Redis MISCONF no VPS: RDB, permissões e memória do fork (2026)
Preserve dados, diagnostique snapshots com falha, corrija disco ou memória e valide persistência e escritas antes de restaurar a proteção.

O Redis pode aceitar conexões e leituras enquanto SET, filas ou sessões falham com MISCONF Redis is configured to save RDB snapshots. Na variante RDB, salvar snapshots falhou e a configuração bloqueia comandos que modificam dados. Investigue antes de apagar dump.rdb, recriar volumes ou reiniciar.
O guia cobre Redis Open Source auto-hospedado em Linux, systemd e Docker: erro, estado/logs, armazenamento ou memória, e validação do salvamento e da aplicação. Serviços gerenciados exigem os procedimentos da plataforma.
| Erro | O que investigar |
|---|---|
| MISCONF menciona RDB e persistência em disco | Snapshot falhou e stop-writes-on-bgsave-error |
| MISCONF menciona escrita AOF | Caminho, armazenamento e estado AOF; o controle RDB não basta |
OOM command not allowed | Quota como maxmemory e política de remoção |
READONLY | Réplica ou mudança de papel |
NOAUTH, NOPERM | Autenticação ou ACL |
| Recusa/timeout | Endereço, escuta, rede ou serviço |
O foco é salvar RDB; consulte a FAQ MISCONF. Se comandos não chegam ao Redis, comece por conexão e inicialização.
Guarde erro completo, horário e logs. Reduza escritas/repetições não essenciais. A memória pode ter dados posteriores ao último salvamento: reiniciar imediatamente pode perdê-los.
Use conta administrativa existente e substitua conta, endereço e porta de exemplo:
redis-cli --user admin --askpass -h 127.0.0.1 -p 6379
--askpass solicita a senha, evitando argumentos e capturas. Em TLS, use opções corretas e CA confiável. Não exponha 6379 à Internet. Veja Redis CLI.
Blocos redis rodam nessa sessão interativa; bash, no terminal do VPS. Leia primeiro o estado:
INFO server
INFO replication
INFO persistence
INFO memory
CONFIG GET dir
CONFIG GET dbfilename
CONFIG GET save
CONFIG GET appendonly
CONFIG GET stop-writes-on-bgsave-error
Confirme versão, instância, papel e diretório real. A aplicação pode não ter CONFIG ou permissões diagnósticas: use administração existente sem liberar todos os comandos. Registre proteção e persistência originais.
CONFIG GET dir retorna o caminho visto pelo Redis. /data do contêiner não equivale a /data do host: encontre a montagem antes de examinar o sistema de arquivos.
Em INFO persistence, observe:
rdb_last_bgsave_status: resultado do último salvamento RDB.rdb_bgsave_in_progress: salvamento em segundo plano ativo.rdb_last_save_time: horário do último sucesso.rdb_changes_since_last_save: alterações desde o salvamento.- Com AOF,
aof_last_write_status,aof_last_bgrewrite_statuse operações em andamento, separadamente.
Veja campos INFO. Leituras normais, dump.rdb antigo ou AOF ativo não comprovam persistência atual.
No systemd consulte o serviço real:
sudo journalctl -u redis-server --since "30 minutes ago" --no-pager
Substitua redis-server se o nome for outro. No Docker:
docker logs --since 30m redis
Substitua redis. Localize a primeira falha de salvamento próxima ao incidente, não só MISCONF repetido pela aplicação:
| Log | Prioridade |
|---|---|
No space left on device | Espaço, inodes e quotas |
Permission denied | Usuário, permissões, montagem e sandbox |
Read-only file system | Somente leitura, falha de armazenamento ou política |
Mensagens como fork: Cannot allocate memory | Memória, overcommit e limites do contêiner |
| Filho RDB encerrado por sinal/OOM | Picos durante escritas e processo morto |
| Falha ao criar/renomear temporário | Diretório, sistema de arquivos e erro concreto |
Para serviço cujo diretório do host seja /var/lib/redis:
df -h /var/lib/redis
df -i /var/lib/redis
findmnt -T /var/lib/redis
ls -ld /var/lib/redis
Substitua pelo caminho confirmado. Espaço livre em df -h não impede inodes esgotados ou quotas de usuário/armazenamento.
RDB normalmente grava temporário e substitui o snapshot antigo. Reserve espaço para novo arquivo e operação, não só o tamanho antigo. Preserve o único snapshot válido e temporários ativos. Veja persistência Redis.
Se logs/imagens Docker ou outras aplicações lotam o disco, classifique e remova somente arquivos descartáveis confirmados sem relação com Redis; veja disco Docker. Não apague volumes para corrigir persistência.
Investigue o motivo de somente leitura. Em falhas de armazenamento, preserve dados e siga a recuperação do sistema de arquivos; se foi opção de deploy, corrija a montagem dos dados. Não force toda montagem para escrita.
No systemd veja identidade e restrições de escrita:
ps -eo pid,user,group,args | grep '[r]edis-server'
sudo systemctl show redis-server -p User -p Group -p ReadWritePaths -p ProtectSystem
namei -l /var/lib/redis
Use serviço/caminho reais. Salvar exige criar, escrever e substituir: confira dump.rdb, diretório e pais. SELinux/AppArmor, controles do sistema e sandbox systemd também podem bloquear; use os logs.
Corrija apenas diretório/configuração confirmados com usuário ou UID/GID reais. Registre permissões anteriores e confira compartilhamento com outros serviços. Evite alterações recursivas amplas e chmod -R 777.
No Docker veja tipo, origem, destino e escrita da montagem:
docker inspect redis --format '{{json .Mounts}}'
docker inspect redis --format 'ReadonlyRootfs={{.HostConfig.ReadonlyRootfs}}'
docker top redis
Encontre a montagem do diretório Redis. Raiz somente leitura pode ter volume de dados gravável; outros diretórios graváveis não corrigem dados somente leitura.
Confira identidade do processo e mapeamento no host. Não suponha UID 999: o usuário de docker exec ... id pode diferir do serviço. Rootless e namespaces também afetam a identidade no host.
Preserve o volume ao corrigir. Se precisar recriar o contêiner, compare memória com último salvamento e avalie backups/restauração. Recriar contêiner não significa excluir volume.
RDB usa fork e cópia na escrita. Escritas, tamanho, fragmentação e outros processos afetam o pico. maxmemory perto de toda a RAM não deixa margem.
Confira recursos/kernel do host:
free -h
swapon --show
sysctl vm.overcommit_memory
sudo journalctl -k --since "30 minutes ago" --no-pager \
| grep -Ei 'out of memory|oom-kill|killed process'
Veja também uso/limite do contêiner. Compare INFO memory, métricas copy-on-write e logs do filho para diferenciar recusa por política de esgotamento real.
O Redis recomenda vm.overcommit_memory=1 no Linux para reduzir recusas conservadoras de fork; consulte administração e FAQ fork. Se a evidência aponta aí, registre o original, confira política/capacidade e considere mudança temporária no host:
sudo sysctl -w vm.overcommit_memory=1
Muda a política, não cria RAM. Em OOM real, reduza carga, reserve margem ou amplie. Use administração do host/plataforma se o contêiner não tiver permissão; não acrescente privilégios alheios. Persista pelo processo sysctl existente após verificar e reverta ao original registrado.
Confirme instância, recursos e caminho, aguardando outras operações necessárias. Registre o estado e solicite salvamento:
LASTSAVE
INFO persistence
BGSAVE
Background saving started significa início, não conclusão. BGSAVE pode falhar durante outro salvamento ou rewrite AOF; não repita continuamente. Veja BGSAVE.
Verifique em intervalos:
INFO persistence
LASTSAVE
Relacione horário/logs desta operação: rdb_bgsave_in_progress volta a 0, o status é ok, o horário coincide e há snapshot completo no caminho real. Confira AOF separadamente; não confunda sucesso antigo com este.
Depois teste escritas com conta, papel, ACL e banco corretos. Troque a chave por nome diagnóstico único não utilizado:
SET __diag:rdb-check:20261013-check01 ok EX 60 NX
GET __diag:rdb-check:20261013-check01
TTL __diag:rdb-check:20261013-check01
Espere SET retornando OK, leitura correta e TTL curto. NX evita sobrescrever; se existir, escolha outro nome. Não escreva em réplicas nem use chaves de negócio. Valide a aplicação real ao final.
A FAQ oferece um modo temporário de permitir escritas:
CONFIG SET stop-writes-on-bgsave-error no
Remove o bloqueio por falha RDB; não corrige disco, permissões nem snapshots. Dados novos podem ficar sem salvar e se perder na saída/falha do host. Também não corrige AOF.
Só considere depois de avaliar tolerância do negócio, registrar original/recuperação e monitorar persistência. Filas, sessões e estados importantes não são automaticamente cache descartável.
Após corrigir e validar o salvamento, restaure a política original; este exemplo usa:
CONFIG SET stop-writes-on-bgsave-error yes
CONFIG GET stop-writes-on-bgsave-error
Configuração em execução pode não sobreviver ao reinício. Confira redis.conf, argumentos e deploy. Evite tornar permanente a exceção e não use CONFIG REWRITE cegamente sobrescrevendo outros ajustes. Siga o processo existente para arquivos somente leitura ou gerenciados pelo deploy.
Observe escritas normais e ao menos um ciclo previsto de snapshot. Confirme ausência de novos erros e margem de disco, inodes, permissões e memória. Teste filas/sessões, não apenas PING.
Faça backup dos arquivos completos atuais e da configuração; restaure em ambiente isolado. Veja Redis 8, persistência e backups. Reiniciar produção não substitui ensaio de recuperação.