Redis no n8n: cache e filas nos seus fluxos
Deixe o Redis protegido, crie a credencial e teste uma leitura e uma gravação. Monte cache com validade, contador, fila em lista e aviso entre fluxos com o Redis Trigger.
Por Redação Eleven Host · @robson.direitodigital · 16 de novembro de 2026 · 9 min de leitura

Capa da Redação Eleven Host para o tutorial: Redis no n8n: cache e filas nos seus fluxos Arte: Eleven Host
Usar redis no n8n é combinar o nó Redis, que lê, grava, soma contadores, mexe em listas e publica mensagens, com o Redis Trigger, que inicia um fluxo quando chega uma mensagem num canal; serve para cache, contador, fila e aviso entre fluxos.
O Redis Trigger só recebe mensagens com o fluxo ativo: o que for publicado enquanto ele está desligado se perde, porque o pub/sub do Redis entrega no máximo uma vez.
Atualizado em 16/11/2026. Em 16/11/2026, a versão estável do n8n na página de lançamentos do projeto é a 2.47.7, publicada em 13/11/2026.
O que é o Redis e o que o n8n oferece
Segundo a documentação do n8n, o Redis é um armazenamento de estruturas de dados em memória, de código aberto, usado como banco, cache e intermediário de mensagens. O nó Redis automatiza trabalho nele e integra o Redis a outros aplicativos.
O nó tem o campo Operation, com Info como padrão, e dez operações: Delete, Get, Increment, Info, Keys, List Length, Pop, Publish, Push e Set. A página do nó na documentação lista só sete (Delete, Get, Info, Increment, Keys, Set e Publish). List Length, Pop e Push existem no editor mesmo assim, e são elas que permitem montar uma fila.
O segundo nó é o Redis Trigger, que assina um canal: o fluxo começa a cada mensagem nova. Ele não é um webhook, então não precisa de URL pública. É o próprio n8n que abre a conexão com o Redis e fica escutando, e precisa apenas alcançar o Redis (host e porta).
O n8n também usa o Redis no modo fila (queue mode), com workers. É outro assunto, ligado à escala da instalação, e não é o uso do nó dentro do fluxo.
Para quem serve
Serve para quem já roda o n8n na própria VPS e quer guardar um resultado por alguns minutos, contar eventos, enfileirar tarefas ou avisar outro fluxo de que algo aconteceu. Se a VPS ainda não existe, veja o que é um servidor VPS.
Na área de VPS da loja, o Plano Bronze é o de entrada. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS
Passo 1: deixar o Redis acessível ao n8n e protegido
Antes de configurar os nós, o Redis precisa estar instalado e alcançável pelo n8n. O mais simples é que os dois fiquem na mesma máquina ou na mesma rede Docker. Se o n8n rodar em Docker, localhost dentro do contêiner é o próprio contêiner: com o Redis em outro contêiner, o Host da credencial é o nome do serviço na mesma rede.
Sobre segurança, o redis.io diz que o Redis foi feito para ser acessado por clientes confiáveis em ambientes confiáveis, e que em geral não é boa ideia expor a instância direto à internet. Numa máquina exposta, a porta do Redis deve ser bloqueada no firewall, e os clientes locais usam a interface de loopback. Um único FLUSHALL de quem alcançar a porta apaga todos os dados. Por isso, recomendamos não publicar a porta 6379 para fora: com Docker, deixe o Redis só na rede interna; sem Docker e com o n8n na mesma máquina, um exemplo de linha no redis.conf é bind 127.0.0.1.
Recomendamos também exigir autenticação. O método indicado pelo redis.io são as ACL (Redis 6 ou superior), com usuários e permissões. O método legado é uma senha única no redis.conf. Um exemplo de linha:
requirepass troque-por-uma-senha-longa
Confira a sintaxe no seu Redis e reinicie o serviço depois de editar. A senha é uma camada extra: não substitui o bloqueio da porta.
O redis.io também recomenda rodar o Redis como usuário sem privilégio.
Passo 2: criar a credencial Redis
No n8n, crie a credencial Redis. Os campos são:
- Password: a senha do Redis;
- User: deixe em branco para autenticar só com senha, e preencha só se usar um usuário ACL;
- Host: o padrão é
localhost, e em Docker vale o nome do serviço; - Port: o padrão é
6379. A documentação diz que deve bater com otcp_portmostrado pelo comandoINFO; - Database Number: o padrão é
0; - SSL: desligado por padrão, e só vale ligar se o servidor Redis tiver TLS.
Com SSL ligado, aparece Disable TLS Verification (insecure), indicado para certificado autoassinado. Recomendamos deixá-lo desligado sem necessidade, porque a conexão fica menos segura.
Se o teste da credencial falhar por recusa de conexão, confira primeiro SSL, host e porta.
Passo 3: testar com Info, Set e Get
Crie um workflow com gatilho manual e adicione o nó Redis. Deixe Operation em Info, selecione a credencial e execute o nó. A saída traz informações gerais da instância, com os números convertidos em número.
Depois, adicione outro nó Redis com Set: em Key, teste, e em Value, ok. Por fim, um terceiro com Get, com Key igual a teste. O campo Name do Get, que vem como propertyName, é o nome da propriedade onde o valor lido será gravado na saída. Se o Get devolver ok nessa propriedade, a ligação está certa.
As dez operações do nó Redis
- Delete: apaga uma chave (campo Key);
- Get: lê o valor de uma chave (Name, Key, Key Type e, em Options, Dot Notation);
- Increment: soma 1 de forma atômica e cria a chave se ela não existir (Key, Expire e TTL);
- Info: informações gerais da instância;
- Keys: as chaves que casam com um padrão (Key Pattern e Get Values);
- List Length: o tamanho de uma lista (List);
- Pop: tira um item da lista (List, Tail, Name);
- Publish: publica uma mensagem num canal (Channel e Data);
- Push: põe um item na lista (List, Data e Tail);
- Set: grava o valor de uma chave (Key, Value, Key Type, Value Is JSON, Expire e TTL).
Em Expire, desligado por padrão, o TTL aparece com 60 segundos como padrão e mínimo de 1. Key Type aceita Automatic (o padrão), Hash, List, Sets e String.
O Redis Trigger
No campo Channels, informe um ou mais canais separados por vírgula. O caractere * é aceito, então pedidos.* recebe pedidos.novos, pedidos.cancelados e outros.
Em Options, JSON Parse Body, desligado por padrão, tenta transformar a mensagem em objeto e, se falhar, mantém o texto. Only Message, também desligado, entrega só { message } em vez de { channel, message }.
Duas ressalvas do pub/sub, segundo o redis.io. A entrega é no máximo uma vez: se o assinante não conseguir tratar a mensagem, por erro ou queda de rede, ela se perde para sempre. E o pub/sub não tem relação com as chaves: o Database Number não separa canais, e uma publicação no banco 10 é ouvida por quem assina no banco 1. O redis.io sugere prefixar os canais com o ambiente, como test, staging ou production.
Combinações para começar
Um exemplo, de cache com validade: um nó Get procura a chave. Se ela vier vazia, um nó HTTP Request busca o dado na API e um nó Set grava o resultado com Expire ligado e TTL em segundos, por exemplo 300.
Um exemplo, de contador: o nó Increment numa chave como contador:pedidos soma 1 a cada execução e devolve o novo valor. Com Expire ligado, o contador serve para uma janela de tempo, mas o prazo recomeça a cada incremento.
Um exemplo, de fila: um fluxo usa Push com Tail ligado na lista fila:tarefas. Outro, iniciado por um Schedule Trigger, usa Pop com Tail desligado e processa o item, e List Length mostra quantos itens esperam. Como Push com Tail entra pelo fim e Pop sem Tail sai pelo início, o primeiro a entrar é o primeiro a sair.
Um exemplo, de aviso entre fluxos: o fluxo A faz Publish no Channel pedidos.novos, e o fluxo B começa com um Redis Trigger em pedidos.*, com JSON Parse Body ligado. Veja Slack no n8n: mensagens e alertas automáticos para o fluxo B enviar a mensagem a uma equipe, ou ntfy na VPS: notificações push do seu servidor para receber um aviso no celular.
São exemplos de montagem. Confira o resultado no seu servidor e ajuste chaves, listas e canais ao que o seu n8n mostra.
Cuidados com o Keys, o Set e as listas
A operação Keys usa o comando KEYS, e não o SCAN. O redis.io pede cuidado extremo com ele em produção, porque pode prejudicar o desempenho em bancos grandes, e diz para não usá-lo no código normal da aplicação. Em rotinas de produção com muitas chaves, recomendamos usar nomes de chave conhecidos ou um set. Para acompanhar o consumo da máquina enquanto os fluxos crescem, há o artigo Netdata na VPS: monitore o servidor em tempo real.
Para gravar em lista, use Push. O Set com Key Type List sobrescreve posições da lista, e não acrescenta itens.
Passo 4: ativar o fluxo
Com o fluxo do Redis Trigger montado, ative-o. Só a partir daí ele escuta o canal. Mensagens publicadas antes da ativação não chegam. Recomendamos também manter o n8n atualizado.
Próximos passos
Um começo tranquilo é montar um fluxo de cada vez, como o cache, e só depois partir para a fila e os avisos entre fluxos.
Atendimento em português do Brasil, pela área do cliente e por tickets. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer as VPS
Perguntas frequentes
O Redis Trigger precisa de URL pública?
Não. Ele não é um webhook: o n8n abre a conexão com o Redis e escuta o canal. O n8n só precisa alcançar o host e a porta do Redis.
Publish com Redis Trigger funciona como fila confiável?
Não. O pub/sub entrega no máximo uma vez, e a mensagem publicada com o fluxo desligado se perde. Para enfileirar itens até que outro fluxo os processe, o caminho no nó é uma lista, com Push e Pop.
Posso usar a operação Keys para listar tudo?
Em rotina de produção com muitas chaves, não é recomendado: o Keys usa o comando KEYS, que pode prejudicar o desempenho em bancos grandes.
Preciso preencher o campo User da credencial?
Só se o Redis usar usuário ACL. Para autenticar apenas com senha, deixe o campo em branco.