Ressources · Intégration n8n

Nœud FTP n8nConfigurer FTP dans n8n.

Le nœud FTP n8n fait circuler des fichiers entre un workflow et un serveur distant. Un seul nœud, 5 opérations, du simple envoi au listing récursif d'un dossier, en FTP ou en SFTP. Tu choisis le protocole, tu donnes un chemin, le fichier arrive là où la suite du workflow l'attend.

Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth

Pourquoi automatiser

À quoi sert le nœud FTP n8n ?

Le nœud FTP relie un workflow à un serveur de fichiers et fait une chose par exécution : supprimer, télécharger, lister, renommer ou envoyer. C'est un nœud core, livré avec n8n : rien à installer, aucun coût en plus, aussi bien sur n8n Cloud que sur une instance que tu héberges toi-même. Le champ Protocol décide si l'échange passe en FTP ou en SFTP, la variante chiffrée qui circule dans un tunnel SSH.

Premier cas typique, la paie et la compta. Le client dépose chaque mois ses justificatifs sur un espace SFTP, un Schedule Trigger réveille le workflow, un nœud FTP en List parcourt /public/folder avec Recursive activé, un second récupère chaque pièce. Le reste du traitement peut ensuite prévenir l'équipe par Gmail.

Deuxième cas, le sens inverse. Un workflow fabrique un export, puis le pousse chez un partenaire. L'opération Upload accepte soit un fichier binaire produit par un nœud précédent, soit du texte saisi dans File Content, largement suffisant pour un petit manifeste. Quand le dossier de destination dépend du contenu, un nœud Switch aiguille vers le bon chemin, et un nœud Merge recolle les branches avant le rapport final.

Troisième cas, le ménage. Rename déplace un fichier traité vers un dossier d'archive, Delete efface ce qui ne sert plus. Deux opérations discrètes, mais qui méritent un chemin vérifié : le nœud agit sur le chemin complet qu'on lui donne, sans se poser de question.

Ce nœud n'est pas un client HTTP. Le nœud HTTP Request appelle n'importe quel endpoint HTTP et sert de recours quand un nœud dédié rate une opération d'API, jamais pour un protocole qui n'est pas HTTP. FTP et SFTP sortent de son terrain, et c'est toute la raison d'être du nœud FTP.

Restent les limites, à connaître avant de construire. Aucun trigger FTP n'existe : un Schedule Trigger ou un Webhook ouvre le workflow à sa place. Les lectures concurrentes n'accélèrent que le téléchargement en SFTP, et tous les serveurs ne les acceptent pas. Le nœud est en version 1, donc un workflow ancien affiche les mêmes champs. Pour monter en compétence sur l'outil, la Formation n8n couvre ces automatisations de bout en bout.

Connexion

Quel credential faut-il pour le nœud FTP ?

  1. 01

    Créer le compte sur le serveur

    Le credential s'authentifie sur un serveur File Transfer Protocol existant : ce compte vient donc en premier. JSCAPE, OpenSSH ou FileZilla Server font l'affaire, et c'est la documentation du fournisseur qui donne les informations de connexion. n8n propose deux types de credential : FTP account, pour un serveur sans tunnel SSH ni connexion chiffrée, et SFTP account, pour un serveur qui gère les deux.

  2. 02

    Remplir les champs de connexion

    Les deux types démarrent pareil. Tu saisis le Host, c'est-à-dire le nom ou l'adresse IP du serveur, puis le Port que la connexion doit utiliser, le Username sous lequel le credential se connecte et le Password de cet utilisateur. Un credential se crée une fois dans le menu Credentials, et tous les workflows qui parlent à ce serveur le réutilisent.

  3. 03

    Ajouter la clé pour le SFTP

    Un compte SFTP demande deux champs de plus. Private Key reçoit une chaîne pour une authentification par clé ou par hôte, au format OpenSSH, le plus souvent générée avec le paramètre -o de ssh-keygen, par exemple ssh-keygen -o -a 100 -t ed25519. Si cette clé est chiffrée, Passphrase la déchiffre. Sans passphrase, le champ reste vide.

Actions

Que sait faire le nœud FTP sur un serveur ?

Le nœud FTP expose 5 opérations. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.

01

Delete a file or folder

delete

Ce que tu vois dans n8n

Notes & cas d'usage

Efface un fichier du serveur, ou un répertoire entier dès que l'option dédiée est activée. En sortie, rien d'autre que la confirmation que l'entrée a disparu.

Paramètres clés

  • Path : le chemin complet de l'entrée à supprimer, du type /public/documents/file-to-delete.txt, souvent {{ $json.path }} récupéré d'un listing.
  • Folder : activé, le nœud supprime aussi bien les dossiers que les fichiers, et une option de plus apparaît.
  • Recursive : activé sur un dossier, tous les fichiers et répertoires contenus dans le répertoire cible partent avec lui.
Cas d'usage
vider le dossier de dépôt une fois les pièces archivées, ou retirer un répertoire temporaire à la fin d'un lot.
02

Download a file

download

Ce que tu vois dans n8n

Notes & cas d'usage

Récupère un fichier du serveur et l'attache à l'item en binaire, prêt pour tout nœud qui lit des fichiers.

Paramètres clés

  • Path : le chemin complet du fichier à télécharger, par exemple /public/documents/file-to-download.txt.
  • Put Output File in Field : le nom du champ binaire de sortie où atterrit le fichier, celui que lira le nœud suivant.
  • Enable Concurrent Reads : en SFTP, accélère les téléchargements, avec Max Concurrent Reads pour borner le nombre de lectures simultanées. Certains serveurs SFTP refusent.
  • Chunk Size : la taille en Ko de chaque morceau, que tous les serveurs ne gèrent pas.
Cas d'usage
aller chercher le tarif fournisseur de la nuit avant de le parser, ou rapatrier un gros fichier média qui traînerait sur un serveur lent.
03

List folder content

list

Ce que tu vois dans n8n

Notes & cas d'usage

Renvoie le contenu d'un répertoire, un item par entrée : de quoi transformer un dossier distant en liste que la suite du workflow peut parcourir.

Paramètres clés

  • Path : le répertoire dont on liste le contenu, par exemple /public/folder.
  • Recursive : requis ici, et activé il renvoie un objet représentant tous les répertoires et objets trouvés récursivement sur le serveur, au lieu du seul premier niveau.
  • Timeout : le délai de connexion en millisecondes, pratique quand une arborescence profonde occupe le serveur.
Cas d'usage
vérifier qu'un partenaire a bien déposé le fichier du jour avant d'aller plus loin, ou construire la liste des chemins que l'étape de téléchargement va traiter.
04

Rename / move a file or folder

rename

Ce que tu vois dans n8n

Notes & cas d'usage

Change l'endroit où vit une entrée sur le serveur. Renommer et déplacer sont la même chose ici, puisque tout revient à écrire un autre chemin.

Paramètres clés

  • Old Path : le chemin existant, par exemple /public/documents/old-file.txt.
  • New Path : la destination, du genre /public/documents/new-file.txt, souvent construite par une expression pour glisser la date dans le nom.
  • Create Directories : activé, le nœud crée récursivement le répertoire de destination, ce qui sauve l'exécution quand le dossier d'archive n'existe pas encore.
Cas d'usage
ranger chaque facture traitée dans un dossier par année, ou horodater un nom de fichier avant qu'un autre système le reprenne.
05

Upload a file

upload

Ce que tu vois dans n8n

Notes & cas d'usage

Écrit un fichier sur le serveur, à partir d'une donnée binaire produite plus haut ou d'un texte saisi directement dans le nœud.

Paramètres clés

  • Path : le chemin complet de destination, par exemple /public/documents/file-to-upload.txt.
  • Binary File : activé pour envoyer un fichier binaire, désactivé pour taper le contenu. Les champs qui suivent dépendent de ce choix.
  • Input Binary Field : affiché quand Binary File est activé, il nomme le champ binaire d'entrée qui contient le fichier à écrire.
  • File Content : affiché quand Binary File est désactivé, il reçoit le contenu texte du fichier à envoyer.
Cas d'usage
déposer un export CSV sur le serveur d'un client, ou écrire un court fichier d'état qu'un autre système vient relire.
Besoin d'aide

Besoin d'aide pour automatiser FTP avec n8n ?

L'équipe te répond directement.

Chaque message est lu par une personne.

FAQ

FTP et n8n : les questions fréquentes

01Le nœud FTP est-il inclus dans n8n, sur Cloud comme en auto-hébergé ?
Oui. FTP est un nœud core, livré avec n8n : rien à installer, aucun surcoût côté n8n. Il se comporte pareil sur n8n Cloud, l'offre hébergée par n8n, et sur une instance auto-hébergée installée avec Docker ou npm, en Community Edition sous licence Sustainable Use. Un workflow monté d'un côté fonctionne de l'autre. Ce que le nœud touche, en revanche, vit en dehors de n8n : le serveur de fichiers lui-même, ce qu'il coûte et qui l'héberge, ça reste une question à part.
02Que faut-il pour faire fonctionner le nœud FTP n8n ?
Un credential, c'est-à-dire un jeu d'identifiants enregistré dans n8n, et un compte sur un serveur de fichiers. Deux méthodes d'authentification existent. Le type FTP account convient à un serveur sans tunnel SSH ni connexion chiffrée : Host, Port, Username et Password suffisent. Le type SFTP account s'adresse à un serveur qui gère le tunnel SSH et le chiffrement, et ajoute Private Key au format OpenSSH, plus la Passphrase qui la déchiffre quand la clé est protégée. Le credential se crée une fois et se réutilise partout.
03Quelles sont les limites du nœud FTP ?
Le nœud couvre 5 opérations sur une ressource unique : supprimer, télécharger, lister, renommer, envoyer. Tout le reste de ce qu'un serveur sait faire sort du périmètre. Il est en version 1, donc les workflows anciens affichent le même panneau. Les lectures concurrentes ne concernent que le téléchargement en SFTP, et certains serveurs les refusent, comme ils peuvent refuser une taille de morceau personnalisée. Un envoi suppose que le fichier arrive en binaire depuis un autre nœud, d'où l'étape Read/Write Files from Disk ou HTTP Request juste avant. Un champ requis laissé vide bloque l'exécution.
04Quand choisir le nœud FTP plutôt que HTTP Request ?
Dès que le transfert passe en FTP ou en SFTP. Le nœud HTTP Request appelle n'importe quel endpoint HTTP et rattrape ce qu'un nœud dédié ne couvre pas sur une API HTTP, mais il s'arrête là : il n'est pas un recours pour un protocole qui n'est pas HTTP. Un partenaire qui expose une API REST passe donc par HTTP Request, et le même partenaire qui dépose des fichiers passe par le nœud FTP. Les deux se combinent très bien : le template 663 télécharge un fichier en HTTP avant de l'envoyer sur un serveur FTP.
05n8n ou Make pour déplacer des fichiers en FTP ?
Ça dépend surtout de l'endroit où doivent vivre les fichiers et la plateforme. Make est hébergé, sans option d'auto-hébergement, et facturé à l'opération : un workflow qui liste un dossier et télécharge des dizaines de fichiers chaque nuit voit sa facture suivre le volume. n8n peut tourner sur ton propre serveur, ce qui veut dire que le contenu des fichiers ne quitte pas une infrastructure que tu maîtrises, argument décisif dès que les documents sont sensibles. Make propose un éditeur visuel que beaucoup d'équipes ops trouvent plus rapide à lire. Hébergement, maîtrise des données, modèle de coût, logique visuelle : tu arbitres dans cet ordre.