Base de Conhecimento

SSH no n8n: rode comandos no servidor pelo fluxo

  • ssh, n8n, automação, vps, linux, segurança
  • Usuários acharam útil: 0

Veja o que o nó SSH faz, como preparar usuário dedicado e chave Ed25519 na ordem certa e por que o code da saída precisa de um IF para o fluxo perceber uma falha.

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: SSH no n8n: rode comandos no servidor pelo fluxo

Capa da Redação Eleven Host para o guia: SSH no n8n: rode comandos no servidor pelo fluxo Arte: Eleven Host

Usar ssh no n8n é mandar um comando para outro servidor a partir de um fluxo: o nó SSH entra no servidor com usuário e senha ou chave, roda o comando e devolve o resultado ao fluxo.

Comando que falha não interrompe o fluxo: o resultado sai nos campos code e stderr, então confira o code com um nó IF antes de seguir.

Atualizado em 16/11/2026. Em 16/11/2026, a versão estável do n8n é a 2.47.7, publicada em 13/11/2026, e o nó SSH não vem bloqueado por padrão nela.

O que é o nó SSH

O nó SSH executa comandos em um servidor remoto. Ele tem dois recursos: Command, com a operação Execute, e File, com as operações Upload e Download. Listar, apagar ou mover arquivo se faz com um comando no recurso Command.

O campo Authentication aceita Password, que é o padrão, ou Private Key. Cada opção usa uma credencial: SSH Password ou SSH Private Key.

Para quem serve

Serve para quem roda o n8n e mantém uma VPS: checar o espaço em disco, reiniciar um serviço, disparar um backup ou buscar um arquivo gerado no servidor. O artigo sobre servidor VPS explica o básico. O n8n não faz parte do catálogo da Eleven Host.

Uma VPS da Eleven Host se contrata pela loja. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS

Preparar o servidor, na ordem

Confira cada comando no seu servidor antes de repetir.

1. Usuário dedicado

Crie um usuário comum só para o n8n, por exemplo n8n-bot, sem permissão de root, com o comando de criação de usuários da sua distribuição.

2. Chave Ed25519 só para o n8n

Gere a chave em uma máquina sua, e não no servidor. Escreva o tipo de chave de forma explícita, porque o padrão do ssh-keygen muda conforme a versão do OpenSSH. Um exemplo:

ssh-keygen -t ed25519 -C "n8n" -f ./n8n_ed25519

O comando cria n8n_ed25519 (privada) e n8n_ed25519.pub (pública) na pasta atual. Se você definir uma senha para a chave, o manual do ssh-keygen informa que não há como recuperar uma senha perdida, e essa senha vai no campo Passphrase da credencial.

3. Chave pública com restrições

No servidor, coloque o conteúdo do arquivo .pub no authorized_keys do usuário dedicado, de preferência com a opção restrict, que desliga encaminhamentos de porta, de agente e de X11 e também a alocação de terminal. Quando der, some from=, para aceitar a chave só do endereço do seu n8n, e command=, para a chave rodar um único comando. Um exemplo de linha:

restrict,from="203.0.113.10" ssh-ed25519 AAAA... n8n

Se o arquivo, a pasta ~/.ssh ou a home puderem ser alterados por outras contas, o sshd recusa a chave com o StrictModes ligado, que é o padrão. Se a pasta ~/.ssh ainda não existir na home do usuário dedicado, crie-a antes de colar a chave.

4. Credencial no n8n

Crie a credencial SSH Private Key e preencha Host (o IP do servidor), Port (22 por padrão, ou a porta que o seu servidor usa), Username (o usuário dedicado), Private Key (o conteúdo inteiro do arquivo da chave privada) e Passphrase (só se você criou uma senha para a chave; sem senha, deixe vazio). Depois de salvar, rode o teste do passo 5.

5. Teste com comando inofensivo

Em um nó SSH com recurso Command e operação Execute, rode whoami ou df -h. Se a saída trouxer o nome do usuário dedicado ou o espaço em disco, a chave funciona. Só então avance para sudo.

6. sudo restrito, sem senha

O nó não abre terminal nem envia entrada ao comando, então um sudo que pede senha não funciona. A saída é o sudo -n, que não pergunta nada e, se precisar de senha, mostra erro e sai, combinado com uma regra NOPASSWD no sudoers só para o comando necessário. Recomendamos editar o arquivo com visudo e confirmar no seu servidor o caminho do programa. Um exemplo de regra:

n8n-bot ALL=(root) NOPASSWD: /usr/bin/systemctl restart nginx

O sudoers pede cuidado com curingas nos argumentos, por isso a regra lista o comando inteiro.

7. Senha desligada, por último

Só depois de testar a chave e o sudo, considere desligar o login por senha no sshd_config, com PasswordAuthentication no; o padrão é yes. Antes do teste, isso pode deixar você sem acesso.

Campos do nó para rodar comandos

Command > Execute

  • Command: o comando a executar no dispositivo remoto;
  • Working Directory: obrigatório, com / como padrão, e é a pasta onde o comando roda.

Um comando com caminho relativo precisa de Working Directory. Para a pasta do usuário, escreva ~/app: o ~ sozinho dá erro.

O que sai do nó

A saída do nó traz o resultado do comando em quatro campos: stdout (o texto de saída), stderr (o texto de erro), code (o código de saída, número ou nulo) e signal (texto ou nulo). Um code diferente de 0 não gera erro no n8n: o item sai normalmente e o fluxo continua. O nó só dá erro quando a conexão ou a chamada falha.

Por isso, depois do SSH, ponha um nó IF com {{ $json.code }} diferente de 0 e mande esse caminho para um aviso.

Nada de terminal ou pergunta

O nó não abre terminal (pty) e não envia entrada (stdin). Editor interativo como o nano, o top sem modo batch e comandos que perguntam "Y/n" não funcionam: quando o programa tiver, use a opção -y ou o modo não interativo. Em saídas longas, filtre com | tail -n 50 ou --no-pager.

Cada item que chega ao nó é um comando novo, com seu próprio Working Directory, e nada passa de um para o outro: um cd ou um export não vale no item seguinte. Se um passo depende do anterior, junte os dois no mesmo campo Command. Um exemplo:

mkdir -p /tmp/teste && cd /tmp/teste && pwd

Arquivos: Upload e Download

No recurso File, o Upload é a operação padrão. Ele usa o Input Binary Field (padrão data) e a pasta de destino em Target Directory; em Options, File Name troca o nome do arquivo. O arquivo precisa chegar antes por outro nó, como o Read/Write Files from Disk ou o HTTP Request.

No Download, o campo Path leva o caminho completo no servidor, com o nome do arquivo, e o File Property (padrão data) recebe o arquivo.

Exemplos de fluxo

Os exemplos abaixo são montagens para adaptar.

Alerta de espaço em disco

Monte um Schedule Trigger diário, seguido de um SSH com o comando abaixo, de um Code ou IF que leia o stdout e de um nó de aviso. Um exemplo:

df -h /

Para acompanhar o servidor, há o artigo sobre Netdata na VPS.

Reiniciar um serviço

Com a regra de sudoers do passo 6, o comando reinicia o serviço e confere se ele voltou. O is-active sai com 0 quando o serviço está ativo e com outro valor quando não está, e o IF do fluxo lê esse code. Um exemplo:

sudo -n systemctl restart nginx && systemctl is-active nginx

Disparar um backup

No authorized_keys, uma chave só para essa tarefa, travada no script. Com command=, o que o nó mandar é ignorado e o script roda. Um exemplo, com um script fictício que você precisa ter criado:

restrict,command="/usr/local/bin/backup.sh" ssh-ed25519 AAAA... n8n-backup

Depois do SSH, um IF no code avisa quando o script falhar. A chave travada em command= roda só o script; se ele gerar um arquivo, a operação File > Download, com o Path completo, pede outra credencial, de uma chave sem command=, e vale conferir no seu servidor. Para backup de arquivos, há o artigo sobre Restic na VPS.

Cuidados ao montar o comando

Quando o comando é montado com dado de fora, como formulário, webhook ou e-mail, existe risco de injeção de comando: quem controla o texto controla o que roda no servidor. Não cole esse texto direto no campo Command; use valores fixos ou valide o dado antes.

Outro ponto é a identidade do servidor: o nó não oferece campo para fixar a impressão digital (host key) dele, e por isso não avisa se alguém se passar pelo servidor no caminho. Quando possível, mantenha o n8n e o servidor na mesma rede privada ou VPN e use as restrições do passo 3. Quem pode editar fluxos no n8n pode usar a credencial, e uma chave só para o n8n permite revogar só ela no authorized_keys.

SSH ou Execute Command

O Execute Command roda comandos na máquina onde o n8n está. Com Docker, roda no contêiner do n8n, e não no servidor hospedeiro; em modo fila, roda no worker. Ele existe só no n8n self-hosted e vem desativado por padrão desde o n8n 2.0. A variável NODES_EXCLUDE controla a lista de nós bloqueados, e o valor NODES_EXCLUDE: "[]" libera os nós bloqueados, inclusive o Local File Trigger.

Há ainda um alerta de segurança público de gravidade alta sobre o Execute Command, sem versão corrigida listada. Para mexer no próprio servidor onde o n8n roda em Docker, o nó SSH apontando para esse servidor, com o usuário dedicado, é o caminho que dispensa liberar o Execute Command.

Problemas comuns

  • Chave recusada: o authorized_keys, a pasta ~/.ssh ou a home podem ser escritos por outros, ou a chave pública foi colada em outro usuário;
  • Falha ao salvar a credencial: Host, Port ou Username errados, ou chave privada incompleta;
  • Erro de caminho com ~: troque por ~/pasta;
  • Comando falhou e o fluxo seguiu: falta o IF no code;
  • sudo falhou: falta a regra NOPASSWD para aquele comando exato, ou falta o -n;
  • Comando parado: o programa quer interação, e o nó não envia entrada.

Sobre servidores virtuais

Um servidor virtual (VPS) é uma máquina virtual hospedada na nuvem.

Quem ainda busca um servidor encontra a linha de VPS da Eleven Host na loja. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Abrir a loja

Perguntas frequentes

O nó SSH do n8n aceita sudo com senha?

Não. O nó não envia entrada ao comando, e o sudo que pede senha não funciona. Use sudo -n com uma regra NOPASSWD restrita ao comando necessário.

O nó avisa quando o comando dá erro?

Não. O erro aparece no code e no stderr da saída, e o fluxo continua. Confira o code com um IF.

Qual a diferença entre o nó SSH e o Execute Command?

O SSH roda em outro computador, com o usuário e as permissões daquele servidor. O Execute Command roda na máquina ou no contêiner do próprio n8n e vem bloqueado por padrão desde o n8n 2.0.

Esta resposta lhe foi útil?

Artigos Relacionados