Execute Command no n8n: como rodar comandos de shell
Veja como usar o Execute Command no n8n: por que o nó vem desabilitado desde o n8n 2.0, como liberar, os campos Execute Once e Command e os riscos de segurança.
Por Redação Eleven Host · @robson.direitodigital · 4 de novembro de 2026 · 8 min de leitura

Capa da Redação Eleven Host para o guia: Execute Command no n8n: como rodar comandos de shell Arte: Eleven Host
O Execute Command no n8n é o nó que roda comandos de shell na máquina onde o n8n está instalado. Desde o n8n 2.0 ele vem desabilitado por padrão, e não existe no n8n Cloud. Veja como liberar, os campos da tela, a saída e os cuidados de segurança.
Atualizado em 04/11/2026, para o n8n 2.x. A versão 2.46.6 é a mais recente no GitHub em 04/11/2026.
O nó vem desabilitado desde o n8n 2.0
Se você seguiu um tutorial antigo e não acha o nó na busca, o motivo pode ser este. A documentação do n8n diz que o Execute Command pode trazer riscos de segurança significativos em ambientes com usuários não confiáveis e que, por isso, o nó é desabilitado por padrão a partir do n8n 2.0. A página de mudanças da versão 2.0 diz que o n8n desabilita os nós ExecuteCommand e LocalFileTrigger por padrão porque eles representam riscos de segurança.
Quem precisa deles deve removê-los da lista de nós desabilitados, atualizando a variável de ambiente NODES_EXCLUDE. Segundo a documentação, essa variável é uma lista de textos, descrita como "Specify which nodes not to load", e o valor padrão é:
["n8n-nodes-base.executeCommand", "n8n-nodes-base.localFileTrigger"]
A documentação também diz que, para habilitar os nós de uma vez, defina NODES_EXCLUDE: "[]". Recomendamos não fazer isso, porque libera de uma vez os nós bloqueados. Um exemplo de configuração que libera só o Execute Command e mantém o Local File Trigger bloqueado:
NODES_EXCLUDE=["n8n-nodes-base.localFileTrigger"]
Num docker compose, a linha entra em environment:, e o contêiner precisa ser reiniciado para ler a variável. O formato das aspas pode mudar conforme o arquivo, então teste e confira se o nó aparece na lista.
O Execute Command não existe no n8n Cloud. Ele está disponível só no n8n instalado por você, e vem bloqueado desde a versão 2.0.
O que o nó faz e onde o comando roda
A documentação descreve o nó assim: ele executa comandos de shell na máquina que roda o n8n, no shell padrão dessa máquina. Se o n8n roda em Docker, a documentação avisa que o comando roda dentro do contêiner do n8n, e não no servidor que hospeda o Docker.
Essa diferença muda o que você consegue fazer. Um comando como df -h / mostra o disco visto de dentro do contêiner, e não o disco do servidor. Por isso, confira se o programa que você quer usar existe dentro do contêiner, como explica a seção sobre comando não encontrado.
Os campos da tela: Execute Once e Command
O nó tem dois parâmetros principais:
- Execute Once: decide se o nó executa só uma vez (ligado) ou uma vez para cada item que recebe na entrada (desligado). Na versão observada, o padrão é ligado;
- Command: o comando a executar na máquina.
Para rodar mais de um comando, a documentação oferece duas formas: escrever cada comando numa linha, separados por &&, como em cd bin && ls, ou colocar cada comando em uma linha separada.
Pelo comportamento observado do nó, com o Execute Once ligado ele usa só o primeiro item que chega e roda o comando uma vez. Com ele desligado, o comando roda uma vez por item, e o campo Command pode usar expressões com os dados de cada item. Para formatar uma data que entra no comando, o guia Date & Time no n8n: como formatar e calcular datas mostra o nó apropriado.
O que o nó devolve
Cada execução entrega um item com três campos: exitCode, stderr e stdout. O stdout traz o texto que o comando imprimiu, o stderr traz as mensagens de erro e o exitCode traz o código de saída. Esses nomes vêm do comportamento observado do nó e podem mudar entre versões, então confira na aba de saída do seu n8n.
Quando o código de saída é diferente de zero, o nó dá erro, com o texto do stderr ou a mensagem "Command failed with exit code" seguida do código. Se a opção de continuar em caso de falha estiver ligada nas configurações do nó, o item sai com o campo error e o fluxo segue. Nos nós seguintes, você acessa o texto com a expressão {{ $json.stdout }}.
Já escolheu o seu próximo servidor? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS
Exemplo inofensivo: o disco todo dia às 8h
Um exemplo de fluxo para treinar, que só lê informação. Para um primeiro teste ainda mais simples, use apenas o comando date. O fluxo do exemplo tem três passos:
- um nó Schedule Trigger, configurado para rodar todo dia às 08:00;
- um nó Execute Command, com o Execute Once ligado e o campo Command com
df -h /; - um nó que usa o resultado, por exemplo enviando o
{{ $json.stdout }}por e-mail ou por um app de mensagens. Se o comando terminar com erro, o nó acusa a falha, como descrito acima.
Se o n8n estiver em Docker, lembre que o resultado do df -h / descreve o disco dentro do contêiner.
Comando não encontrado e programas que faltam no Docker
Um erro que a documentação lista é "Command failed: <command> /bin/sh: <command>: not found". Ele acontece quando o shell não encontra um dos comandos escritos no campo Command. Com Docker, a documentação orienta a conferir se o comando existe dentro do contêiner, tentando rodá-lo manualmente nele, por exemplo com docker container exec.
A documentação diz que o gerenciador de pacotes apk foi removido da imagem oficial do n8n, então não dá para rodar apk add dentro do contêiner. O caminho é construir uma imagem própria, baseada na imagem existente do n8n. O Dockerfile que a documentação mostra para incluir o curl inclui estas linhas:
FROM n8nio/n8n
USER root
COPY --from=alpine:3.22 /sbin/apk /sbin/apk
RUN apk add --no-cache curl
USER node
Depois, a documentação manda construir a imagem, com o comando docker build -t n8n-curl ., e trocar a imagem usada antes pela nova. Para usar o curl como teste de sites e APIs, veja o guia Comando curl: como testar sites e APIs pela VPS.
A documentação lista mais dois erros. O primeiro é "Error: stdout maxBuffer length exceeded", que acontece quando o comando devolve mais saída do que o nó consegue processar de uma vez, e a saída é reduzir o que o comando imprime. O segundo vale para PowerShell: se o comando tem quebras de linha, o shell executa só a primeira linha e ignora o resto, então escreva o comando numa linha só.
Checklist antes de usar o Execute Command
- Confirme que o n8n é instalado por você, porque o nó não existe no n8n Cloud.
- Libere o nó pela variável
NODES_EXCLUDEe reinicie o n8n. - Saiba onde o comando roda: no servidor ou dentro do contêiner.
- Teste primeiro um comando inofensivo, como
date. - Confira se o nó terminou sem erro e veja o
exitCodena saída. - Não monte o comando com texto que vem de fora.
Segurança ao liberar o nó
A documentação liga o risco do nó aos ambientes com usuários não confiáveis, e foi por isso que o n8n passou a desabilitá-lo. O comando roda no shell da máquina onde o n8n está (ou dentro do contêiner, se for Docker).
Recomendamos liberar o nó só se as pessoas com acesso ao n8n forem de confiança. Recomendamos também não montar o comando com texto recebido de um webhook ou de um formulário, porque quem controla o texto passa a controlar o comando. Quando precisar de algo simples, como chamar uma API, avalie se outro nó do n8n resolve sem abrir um shell.
A página da documentação sobre bloquear nós mostra o caminho inverso: para impedir que usuários acessem certos nós, coloque-os na lista de NODES_EXCLUDE. O exemplo dela bloqueia o n8n-nodes-base.executeCommand e o n8n-nodes-base.readWriteFile.
Resumo
O Execute Command roda comandos de shell na máquina do n8n, e não existe no n8n Cloud. Desde o n8n 2.0 ele precisa ser liberado em NODES_EXCLUDE. Em Docker, o comando roda dentro do contêiner e a imagem oficial não tem o apk. Quem ainda está decidindo onde instalar o n8n pode começar pelo guia O que é servidor VPS.
Está comparando servidores neste momento? VPS a partir de R$ 17,00/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer as VPS
Perguntas frequentes
Por que não encontro o nó Execute Command no n8n?
Desde o n8n 2.0, o nó vem desabilitado por padrão. Para usá-lo, remova o n8n-nodes-base.executeCommand da lista da variável NODES_EXCLUDE. No n8n Cloud, o nó não existe.
O Execute Command roda no servidor ou no contêiner?
Roda na máquina onde o n8n está. Com o n8n em Docker, o comando roda dentro do contêiner do n8n e não no servidor que hospeda o Docker.
Como instalar um programa que falta no contêiner do n8n?
O apk foi removido da imagem oficial. A documentação manda construir uma imagem própria baseada na do n8n e usá-la no lugar da anterior.
O que significa o Execute Once?
Ligado, o nó roda o comando uma vez. Desligado, roda uma vez para cada item recebido.