Ir para o conteúdo
Promovaweb

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
  1. Quatro formas de guardar as chaves
  2. RDB: a fotografia periódica
  3. AOF: o log de cada escrita
  4. O que as filas dos apps precisam

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:

appendfsyncQuando grava no discoO que se perde numa queda
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.
Os arquivos de persistência na pasta de trabalho do Redis, com RDB e AOF ligados. Na imagem oficial do Docker, essa pasta é o volume /data.

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.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.