Uma instância do n8n em queue mode não é só uma instância com mais workers. A principal recebe o trigger, grava a execução e entrega o identificador para o Redis. O worker busca o workflow no banco, executa e grava o resultado. Quando a versão 3.0 muda o trabalho do worker, o cálculo de memória, disco e rede muda junto.
A primeira diferença aparece nas execuções manuais: a variável OFFLOAD_MANUAL_EXECUTIONS_TO_WORKERS é removida. Todo teste feito no editor agora roda no worker. Se a sua instância tem workers apertados, o teste manual compete com a produção.
Direto ao ponto
A versão 3.0 mexe em quatro pontos de uma instância em queue mode: execução manual, armazenamento de binários, limites de tarefa e rede. O Migration Report lista os problemas da instância, mas a revisão de memória, storage e SSRF continua sendo sua.
O modo filesystem não é suportado em queue mode. A documentação indica database, S3 ou Azure como alternativas para armazenar os binários. O timeout do task runner cai de 5 minutos para 1 minuto. Os limites de descompressão caem de 2 GiB para 256 MiB.
O que muda na execução manual do n8n 3.0
A variável OFFLOAD_MANUAL_EXECUTIONS_TO_WORKERS sai de cena. No modo queue, as execuções manuais rodam nos workers, inclusive o teste que você dispara pelo editor. A principal apenas enfileira.
Para você que dimensiona a instância, isso significa rever a memória dos workers. Um teste manual grande, que antes ficava na principal, agora compete com as execuções de produção. A documentação recomenda revisar a memória dos workers justamente por isso.
O efeito aparece na concorrência. Cada worker tem um limite de execuções simultâneas, com padrão de 10. Um teste manual ocupa uma vaga enquanto roda. Com concorrência baixa para proteger o banco, o teste pode atrasar uma execução de cliente. Ajuste o número de workers ou a concorrência antes de atualizar.
O que muda no armazenamento de binários
O modo filesystem não é suportado em queue mode, porque cada worker grava e lê o binário do próprio disco. A execução pode cair em outro worker. Nesse caso, a documentação indica database, S3 ou Azure como alternativas. O database funciona, mas carrega o banco principal e tem limite de tamanho por arquivo. S3 e Azure são as opções recomendadas para volume.
Respostas grandes de webhook têm um caminho próprio. O worker executa, mas o cliente continua conectado à principal ou ao webhook processor. A resposta volta dentro de uma mensagem na fila. O Redis guarda o corpo inteiro enquanto a mensagem está em voo. O limite padrão de N8N_WEBHOOK_RESPONSE_RELAY_SIZE_MAX é 64 MiB.
Para passar desse limite, é possível descarregar o corpo para o storage com N8N_WEBHOOK_RESPONSE_RELAY_OFFLOAD_ENABLED=true. Todas as instâncias precisam ler o mesmo storage, com S3 ou Azure como opções recomendadas. O filesystem exigiria o mesmo disco montado em cada instância, o que a documentação não recomenda.
O que muda nos limites de tarefa
O timeout do task runner cai de 300 para 60 segundos. Tarefas de Code node que passam de um minuto falham. A variável N8N_RUNNERS_TASK_TIMEOUT permite voltar ao valor antigo ou definir outro. Eu prefiro ajustar o fluxo antes de aumentar o timeout, porque um script longo no worker compete com as execuções de produção.
Os limites de descompressão também caem. O tamanho descomprimido padrão passa de 2 GiB para 256 MiB. O número de entradas em ZIP passa de 5.000 para 1.000. Arquivos acima disso falham no Node Compression. Se o seu fluxo descomprime pacote grande, defina N8N_COMPRESSION_NODE_MAX_DECOMPRESSED_SIZE_BYTES e N8N_COMPRESSION_NODE_MAX_ZIP_ENTRIES antes de atualizar.
O que muda na rede
Quando a proteção contra SSRF está ativada com a lista default, o n8n recusa quatro faixas novas: ::/128, 100.64.0.0/10, 2002::/16, 64:ff9b::/96. Uma chamada interna entre containers ou dentro do cluster pode cair nessa lista. Se isso acontecer, libere o hostname em N8N_SSRF_ALLOWED_HOSTNAMES ou a faixa em N8N_SSRF_ALLOWED_IP_RANGES. Eu prefiro trabalhar com hostname, porque a faixa muda com mais facilidade.
O teste precisa cobrir os serviços internos que o workflow chama. Serviços internos podem estar em uma faixa recusada. A chamada falha com erro de rede, o que para o workflow no meio. A liberação vale apenas para o destino necessário, com hostname ou faixa. O resto da lista default continua valendo.
Como revisar antes de atualizar
O primeiro passo é atualizar para a última 2.x e abrir Settings > Migration Report. A aba de problemas da instância mostra variáveis e configurações afetadas. Ela fica visível para owners e admins. Resolva o que trava a atualização e o que faz execuções falharem.
Antes de subir os workers, confira a encryption key. A main, os workers e os webhook processors precisam da mesma chave para ler as credenciais no banco. Confira também a conexão com o Redis e o Postgres em cada worker. Um worker que não alcança o banco falha na primeira execução. O erro aparece no log, não no canvas.
Depois faça backup completo e teste em uma instância separada, com a mesma configuração de workers, Redis e storage. Na instância de teste, rode um workflow que use binário, um que dispare execução manual e um que chame serviço interno. Compare a saída e o consumo de memória dos workers. O teste manual agora ocupa o worker, o que muda o cálculo de concorrência.
Ajuste a memória e o número de workers antes de virar a produção. Com webhook de resposta grande, teste o limite de 64 MiB e a configuração de offload. Com compressão, teste o arquivo maior que o novo limite antes da versão estável, prevista para o começo de dezembro.
O que eu levaria para a produção
Queue mode exige atenção extra na 3.0. A versão muda o Node que você vê no canvas e também o trabalho do worker, o storage, o tempo e a rede. Ao administrar uma instância com workers, trate a atualização como uma mudança de infraestrutura, não como uma troca de versão.
Eu vou acompanhar a série até a estável e trazer o que aparecer. Para decidir a data, o artigo sobre quando migrar para o n8n 3.0 detalha o calendário. A lista de breaking changes está no artigo de agosto. O Plano Martech reúne a trilha de automação com n8n e a página do n8n tem o material de apoio.
