Persistência no Redis: RDB e AOF
A persistência do Redis é a cópia em disco das chaves que ficam na memória, gravada por RDB, por AOF ou pelos dois. O servidor lê essa cópia na partida para recuperar as chaves depois de um reinício, por isso um Redis sem persistência volta vazio e perde as tarefas que ainda esperavam na fila.
Ficha e sumário da página
- Referência técnica
- Redis 8.10.3
- Revisão
- 13 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
Quatro formas de guardar as chaves
A documentação oficial lista quatro configurações. O RDB tira snapshots do conjunto de chaves em intervalos definidos. O AOF registra cada operação de escrita que o servidor recebe, no mesmo formato do protocolo do Redis. Na partida, o servidor repete esse log para reconstruir as chaves. A terceira forma desliga a persistência, escolha que a documentação cita como usada às vezes em cache. A quarta combina RDB e AOF na mesma instância.
A escolha depende do que o Redis guarda na sua stack. Um Redis só de cache pode perder tudo num reinício, porque o app refaz as consultas e grava as chaves de novo. Um Redis com filas guarda tarefas que ainda não rodaram, como um e-mail de notificação do Chatwoot, que não reaparece na fila depois de perdido.
RDB: a fotografia periódica
O RDB grava o conjunto inteiro de chaves num arquivo binário, o dump.rdb. O redis.conf da versão 8.10.3 registra três pontos de gravação padrão: depois de uma hora, quando houve ao menos uma alteração, depois de cinco minutos, quando houve ao menos cem, ou depois de um minuto, quando houve ao menos dez mil. A diretiva save troca esses pontos, enquanto save "" desliga o RDB.
Para gravar sem parar de atender, o Redis cria com fork() um processo filho, que escreve o arquivo enquanto o processo principal continua respondendo aos apps. A documentação aponta o preço desse desenho: com muitas chaves e uma CPU fraca, o fork() pode deixar o Redis sem responder por alguns milissegundos, ou até um segundo. O RDB também perde tudo o que mudou depois da última fotografia, tirada em geral a cada cinco minutos ou mais, segundo a própria documentação.
O arquivo compacto tem vantagens claras. Ele serve de backup, porque você copia um único arquivo para outro servidor ou para um armazenamento externo. A partida com um RDB também é mais rápida que a reconstrução por um AOF longo.
AOF: o log de cada escrita
Com appendonly yes, o Redis acrescenta ao log cada comando que altera alguma chave. A diretiva appendfsync define com que frequência o sistema operacional descarrega esse log no disco:
alwaysA cada lote de comandos, antes de responder aos clientes.Quase nada, ao custo de um Redis muito mais lento.everysecUma vez por segundo, numa thread separada. É o padrão do redis.conf.No máximo cerca de um segundo de escrita.noQuando o sistema operacional descarregar o buffer, em geral a cada 30 segundos no Linux.As escritas desde a última descarga do sistema.O log cresce a cada comando: um contador incrementado cem vezes deixa cem comandos no arquivo. Para conter esse crescimento, o Redis reescreve o AOF em segundo plano: monta um arquivo novo com o mínimo de comandos para chegar ao estado atual e troca os arquivos quando o novo fica pronto. Se o log terminar com um comando gravado pela metade, como numa queda de energia, a configuração padrão (aof-load-truncated yes) carrega o arquivo assim mesmo e ignora o último comando incompleto.
Desde o Redis 7.0, o AOF é dividido em vários arquivos dentro de uma pasta, controlados por um manifesto:
/dataPasta de trabalho do Redis, montada como volume no container.dump.rdbSnapshot RDB, refeito a cada ponto de gravação.appendonlydir/Pasta do AOF, nome definido pela diretiva appenddirname.appendonly.aof.1.base.rdbBase do AOF: o estado das chaves na última reescrita, em formato RDB.appendonly.aof.1.incr.aofComandos de escrita recebidos desde a última reescrita.appendonly.aof.manifestManifesto que diz ao Redis quais arquivos formam o AOF atual.
Na reescrita, o Redis abre um arquivo incremental novo para continuar gravando, gera a base nova num processo filho e troca o manifesto de uma vez quando tudo fica pronto. O manifesto é o arquivo que o Redis lê na partida, por isso a pasta appendonlydir precisa ser copiada inteira num backup.
O que as filas dos apps precisam
O redis.conf padrão traz appendonly no, de modo que um Redis instalado sem ajuste guarda as chaves só com o RDB. Para filas, essa configuração deixa uma janela de até uma hora, nos períodos de pouco movimento, com tarefas que existem só na memória. A documentação recomenda combinar RDB e AOF quando você quer uma segurança comparável à do PostgreSQL. As stacks dos portais ligam o AOF com --appendonly yes no comando do container do Redis.
O volume também faz parte da persistência. A página da imagem oficial no Docker Hub informa que, com a persistência ligada, os arquivos ficam no volume /data. Sem um volume nomeado ou uma pasta da VPS montada em /data, os arquivos ficam no volume anônimo do container. Um container novo, criado do zero, recebe outro volume anônimo e começa vazio, com RDB e AOF ligados ou não. Num Redis só de cache, faz sentido desligar as duas formas e economizar disco e o custo do fork().
A persistência recupera as chaves depois de um reinício. Um comando como FLUSHALL vindo de um cliente indevido, porém, entra no AOF como qualquer outra escrita e se repete na partida. A página Senha, ACL e rede explica como limitar quais clientes alcançam o Redis e quais comandos cada um pode enviar.