Queue mode no n8n: escalando para milhares de execuções
O que é o Queue mode do n8n, como a arquitetura de Main, Workers e Redis funciona, e quando vale a pena migrar para esse modo de escala.
Resumo por IA
Resumo gerado por IA, revisado pela redação.
Queue mode é a configuração que permite ao n8n escalar para milhares de execuções simultâneas, distribuindo o trabalho entre vários processos "worker" em vez de rodar tudo numa única instância. É o que separa uma automação pessoal de uma infraestrutura de produção de verdade.
Adicione ao Google NotíciasComo funciona o modo padrão (sem fila)
Por padrão, o n8n roda tudo numa única instância: a mesma que serve a interface, recebe webhooks e executa os fluxos. Funciona bem até um certo volume — mas em uso intenso, execuções concorrentes competem pelos mesmos recursos, e a interface pode ficar lenta enquanto fluxos pesados rodam.
Como o Queue mode resolve isso
O modo de fila separa as responsabilidades em papéis distintos:
Main — recebe os gatilhos (webhooks, agendamentos) e distribui o trabalho.
Workers — processos separados, que efetivamente executam os fluxos. Você pode rodar de 1 a dezenas deles, conforme o volume.
Redis — a fila em si, que coordena qual worker pega qual execução.
O Queue mode exige PostgreSQL como banco de dados — o SQLite padrão não sustenta múltiplos processos acessando o mesmo banco simultaneamente. Migrar para Postgres é pré-requisito antes de sequer considerar o modo de fila.
Quando vale a pena migrar
| Cenário | Modo padrão basta? |
|---|---|
| Poucos fluxos, uso pessoal | Sim |
| Execuções ocasionais, baixo volume | Sim |
| Muitas execuções simultâneas, picos de uso | Não — considere Queue mode |
| Fluxos pesados travando a interface para outros usuários | Não — considere Queue mode |
Configuração básica
No docker-compose, além dos serviços já vistos (n8n, Postgres), somam-se o serviço Redis e um ou mais serviços worker, rodando a mesma imagem do n8n mas com a variável EXECUTIONS_MODE=queue e apontando para o mesmo Redis e Postgres da instância principal.
Comece com poucos workers — um ou dois — e aumente conforme o volume real de execuções exigir. É mais fácil escalar workers depois do que superdimensionar desde o início sem saber a necessidade real.
Queue mode separa recebimento de gatilhos e execução de fluxos em processos distintos, coordenados por Redis, sobre um banco Postgres — a arquitetura que sustenta volume alto sem travar a interface.
Perguntas frequentes
O que é o Queue mode do n8n?
Uma configuração que distribui a execução de fluxos entre vários processos "worker" separados, coordenados por uma fila Redis, permitindo escalar para volumes muito maiores que a instância única padrão.
O Queue mode funciona com SQLite?
Não. Ele exige PostgreSQL, já que o SQLite não sustenta múltiplos processos acessando o mesmo banco de dados ao mesmo tempo.
Quando vale a pena migrar para Queue mode?
Quando o volume de execuções simultâneas é alto o suficiente para travar a interface ou atrasar fluxos, ou quando picos de uso exigem mais capacidade de processamento do que uma instância única sustenta.
Este tutorial faz parte do guia Curso de n8n do zero ao avançado: o guia completo em português. Veja também: Node, trigger e workflow: o vocabulário do n8n em 10 minutos · A estrutura de dados do n8n: por que tudo é um array com json · Item linking no n8n: como ele decide qual item vai pra saída · Execuções passo a passo: como achar onde o fluxo do n8n quebrou · A Canvas UI do n8n 2.0: o que mudou e como se orientar · n8n Cloud ou self-hosted: a decisão que define seu custo e sua liberdade
Este tutorial faz parte do guia Curso de n8n do zero ao avançado: o guia completo em português. Veja também: Node, trigger e workflow: o vocabulário do n8n em 10 minutos · A estrutura de dados do n8n: por que tudo é um array com json · Item linking no n8n: como ele decide qual item vai pra saída · Execuções passo a passo: como achar onde o fluxo do n8n quebrou · A Canvas UI do n8n 2.0: o que mudou e como se orientar · n8n Cloud ou self-hosted: a decisão que define seu custo e sua liberdade
