FTP no n8n: envie e baixe arquivos por SFTP
Conheça as cinco operações do nó FTP, escolha o SFTP, monte a credencial e crie um fluxo com agendamento e Remove Duplicates para buscar só os arquivos novos.
Por Redação Eleven Host · @robson.direitodigital · 16 de novembro de 2026 · 8 min de leitura

Capa da Redação Eleven Host para o guia: FTP no n8n: envie e baixe arquivos por SFTP Arte: Eleven Host
Usar ftp no n8n é enviar, baixar, listar, renomear e apagar arquivos num servidor remoto dentro de um fluxo: o nó FTP faz isso por FTP ou por SFTP, conforme o campo Protocol.
O n8n não tem FTPS. No FTP comum, a senha e os arquivos trafegam sem criptografia, então use SFTP quando o servidor oferecer.
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.
O que é o nó FTP
O nó FTP do n8n transfere arquivos por FTP ou SFTP. No painel, a busca por "SFTP" deve achar este nó também. O campo Protocol traz as opções FTP e SFTP, e o padrão é FTP. A credencial pedida muda conforme a escolha.
O SFTP faz as operações por um canal SSH criptografado, segundo o manual do programa sftp do OpenBSD. O n8n não oferece FTPS (FTP com TLS): nem o nó nem a credencial FTP têm opção de criptografia. Por isso, recomendamos escolher SFTP e deixar o FTP comum só para rede confiável ou para servidor que não oferece SFTP.
Até 16/11/2026, não há alerta de segurança público conhecido ligado ao nó FTP. Isso não é garantia de que o nó esteja livre de falhas.
Para quem serve e onde guardar os arquivos
O nó serve a quem precisa levar arquivos de um fluxo para outro servidor ou buscar arquivos que um parceiro deixa numa pasta: relatórios em CSV, cópias de dados e exportações. O n8n não faz parte do catálogo da Eleven Host.
Para o destino, uma opção é uma VPS com servidor SFTP próprio; quem está começando pode ler o artigo sobre servidor VPS. Outra é o 11Cloud, o armazenamento em nuvem da Eleven Host, com app e acesso por SFTP/WebDAV. O Guia do 11Cloud: por onde começar a usar explica o serviço. Antes de preencher a credencial, confira os dados de acesso do 11Cloud na área do cliente.
Armazenamento em nuvem com app e acesso por SFTP/WebDAV também está no catálogo. 11Cloud a partir de R$ 7,90/mês no plano de 100GB; confira na loja o que cada plano inclui. Ver o 11Cloud
As cinco operações do nó
A operação padrão ao abrir o nó é Download. O nó FTP não é um gatilho: ele só age quando o fluxo chega até ele.
O que cada operação pede
- Delete: apaga um arquivo ou uma pasta. O campo Path é obrigatório e leva o caminho completo. Em Options, Folder permite apagar pasta (começa desligado) e, com ele ligado, Recursive apaga tudo que estiver dentro;
- Download: baixa um arquivo. Pede Path com o caminho completo e Put Output File in Field, o campo binário de saída, que começa como
data; - List: lista o conteúdo de uma pasta. O Path começa em
/e a opção Recursive, desligada por padrão, percorre as subpastas; - Rename: renomeia ou move. Pede Old Path e New Path, e a opção Create Directories cria a pasta de destino quando ela não existe;
- Upload: envia um arquivo. O Path é o arquivo de destino, com o nome, e não só a pasta. Com Binary File ligado (o padrão), o campo Input Binary Field começa como
data. Desligando o Binary File, aparece File Content, para enviar texto puro.
Todas as operações têm a opção Timeout, em milissegundos, com padrão de 10000 (10 segundos). No Download, a opção Enable Concurrent Reads liga leituras em paralelo e vem desligada; se o servidor SFTP não aceitar, o nó pode falhar, e a saída é deixá-la desligada.
Não existe uma operação só para criar pasta. No SFTP, o Upload cria as pastas-pai que faltam, e no Rename vale a opção Create Directories.
Como o arquivo entra e sai do nó
No Upload, o nó lê o arquivo da propriedade binária do item que chega. Por isso, ele precisa de outro nó antes, como Read/Write Files from Disk ou HTTP Request, para entregar o arquivo nessa propriedade. Se o nó anterior usar outro nome para o campo, como attachment_0, ajuste o Input Binary Field, senão o n8n acusa binário ausente.
No Download, o arquivo sai na propriedade binária indicada em Put Output File in Field, com o nome do arquivo remoto. No List, cada entrada vira um item, com campos como type, name, size, modifyTime, rights, owner, group e path.
Em caso de erro, o nó para o fluxo. Com Continue On Fail ligado nas configurações do nó, o item com erro sai com json.error e o fluxo segue.
Credenciais: FTP e SFTP
A credencial FTP pede Host, Port (padrão 21), Username e Password. A credencial SFTP pede Host, Port (padrão 22), Username, Password, Private Key e Passphrase. A Private Key deve estar em formato OpenSSH, e a Passphrase só vale para chave protegida por senha. As duas credenciais têm teste de conexão.
A documentação do n8n sugere gerar a chave com o comando ssh-keygen -o -a 100 -t ed25519. Recomendamos acrescentar -f com um nome de arquivo só para esta chave, para não sobrescrever outra que você já tenha. A credencial SFTP não tem campo para a impressão digital da chave do servidor.
A chave privada e a senha ficam só na credencial do n8n, e fora de nó Code, expressão, nota, print e Git. Host, porta, usuário e senha ou chave vêm do provedor do servidor; a documentação do n8n manda consultá-lo.
Passo a passo para a primeira transferência
Siga esta ordem para achar o erro no passo certo:
- Pegue com o provedor o host, a porta, o usuário e a senha ou a chave, e prefira o SFTP;
- Crie a credencial SFTP, com Port 22, a Private Key em formato OpenSSH e a Passphrase, se houver, e rode o teste de conexão;
- Adicione o nó FTP com Protocol em SFTP e teste a operação List em
/antes das demais; - Faça Upload e Download com o caminho completo, incluindo o nome do arquivo;
- Só então agende o fluxo.
Sem gatilho de arquivo novo
O n8n não tem gatilho nativo para "chegou arquivo novo no FTP ou SFTP". Existe um pedido de recurso no fórum do n8n, de 06/02/2026, para um SFTP Trigger. Por ora, o caminho é montar a verificação no próprio fluxo.
Um exemplo de montagem, a conferir no seu servidor: um Schedule Trigger (por exemplo, a cada 15 minutos) chama o FTP com a operação List na pasta de entrada. Um Filter deixa passar só arquivos (type igual a arquivo) com o nome terminado em .csv. Em seguida, um Remove Duplicates na operação Remove Items Processed in Previous Executions, com Keep Items Where em Value Is New, olha o campo path. O FTP com Download usa {{$json.path}} como Path, e o processamento vem depois.
O Remove Duplicates guarda o histórico na instância do n8n, com History Size padrão de 10000 itens, e a operação Clear Deduplication History zera esse histórico. A alternativa mais simples é mover o arquivo lido para uma pasta /processados/ com o Rename, cujo New Path leva o caminho completo, com o nome do arquivo, e com Create Directories ligado, assim a próxima consulta não o encontra mais na pasta de entrada.
Exemplos para começar
Um exemplo de fluxo, a conferir no seu servidor: backup diário num servidor SFTP. Um Schedule Trigger dispara de madrugada, e um nó gera o arquivo, como Execute Query do banco seguido de Convert to File em CSV, ou Read/Write Files from Disk lendo um arquivo .tar.gz. O FTP com Protocol em SFTP e operação Upload grava em um Path como o abaixo, com Input Binary Field em data.
/backups/{{$now.toFormat('yyyy-MM-dd')}}-backup.csv
Para limpar cópias antigas, dá para listar /backups/, filtrar pelo modifyTime e chamar Delete, depois de testar o filtro só com o List. Para o backup do próprio servidor, veja o artigo Restic na VPS: backup automático do servidor.
Um exemplo de fluxo, a conferir no seu servidor: relatório de parceiro. Um Schedule Trigger de hora em hora chama o FTP em SFTP com List em /saida/. Um Filter pega os nomes que começam com relatorio_ e terminam em .csv, o Remove Duplicates com Value Is New sobre path descarta o que já passou, e o FTP com Download traz o arquivo. Um Extract from File lê o CSV, e os dados seguem para a planilha ou o banco. No fim, um Rename move o arquivo para a pasta /saida/lidos/ (o New Path leva o nome do arquivo), com Create Directories ligado.
Problemas comuns
- O teste da credencial falha: confira host, porta (21 no FTP, 22 no SFTP), usuário e, no SFTP, o formato OpenSSH da Private Key e a Passphrase;
- Erro de binário ausente no Upload: o nó anterior entrega o arquivo com outro nome de campo, e o Input Binary Field precisa acompanhar;
- Upload cai no lugar errado: o Path é o arquivo de destino, e não a pasta;
- Falha por tempo: o Timeout padrão é de 10 segundos, e servidor lento pede aumentá-lo;
- Pasta apagada com tudo dentro: o Recursive do Delete apaga o conteúdo, então teste antes com o List;
- Arquivo processado duas vezes: o fluxo não usa Remove Duplicates nem move o arquivo para a pasta de processados.
Sobre servidores virtuais
VPS é a sigla de servidor virtual privado.
Também há VPS à venda na Eleven Host. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Conferir as VPS
Perguntas frequentes
O n8n faz FTPS, o FTP com TLS?
Não. O nó FTP tem só as opções FTP e SFTP, e a credencial FTP não tem campo de TLS. Quando o servidor oferece SFTP, o caminho é usá-lo.
Existe um gatilho para arquivo novo?
Não existe um gatilho nativo. O caminho é um Schedule Trigger com List, Remove Duplicates ou a movimentação do arquivo lido para uma pasta de processados.
Por que o Upload acusa binário ausente?
O Upload procura o arquivo no campo data. Se o nó anterior usa outro nome, ajuste o Input Binary Field.