Base de Conhecimento

Redis no n8n: cache e filas nos seus fluxos

  • redis, n8n, cache, fila, automação, workflow
  • Usuários acharam útil: 0

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

Arte da Eleven Host: janela de terminal com o título: Redis no n8n: cache e filas nos seus fluxos

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 o tcp_port mostrado pelo comando INFO;
  • 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.

Esta resposta lhe foi útil?

Artigos Relacionados