Nœud SSH n8nConfigurer SSH dans n8n.
Le nœud SSH n8n ouvre une session sur une machine distante pour y lancer une commande ou y déplacer un fichier. Il compte 3 opérations réparties sur 2 ressources et s'authentifie par mot de passe ou par clé privée. Il tourne une fois par item reçu, jamais tout seul.
Avis vérifiés sur Trustpilot · Agence IA, automatisation & growth
À quoi sert le nœud SSH n8n concrètement ?
Le nœud SSH n8n ne démarre jamais un workflow : un déclencheur le précède toujours, Schedule Trigger ou Webhook, cette URL qu'un système tiers appelle pour prévenir n8n. Une fois cette étape passée, le nœud ouvre une session Secure Shell vers une machine distante et exécute, à chaque item reçu, l'une de ses trois opérations : lancer une commande, récupérer un fichier ou en déposer un.
Certains traitements n'ont jamais eu d'API. Un serveur de sauvegarde, un vieux logiciel de gestion qui dépose ses exports dans un dossier, un script maison qu'on lance à la main tous les lundis matin. C'est exactement le terrain de ce nœud, et ses trois opérations couvrent la plupart de ces gestes.
Premier cas : la sauvegarde nocturne. Un Schedule Trigger part à heure fixe, Execute a command lance le script de dump dans le Working Directory indiqué, et le retour de la commande atterrit dans un message d'alerte, souvent via Slack. Deuxième cas : la récupération d'un export comptable. Download a file va chercher le CSV à son Path complet, et les lignes finissent dans Google Sheets pour l'équipe finance. Troisième cas : le dépôt d'un document produit plus tôt dans le workflow, envoyé avec Upload a file dans le Target Directory attendu par l'application métier.
Deux points à connaître avant de monter ça. Le dépôt suppose que le fichier existe déjà sous forme de données binaires sur l'item : un nœud précédent doit l'y placer, un Read/Write Files from Disk ou un appel HTTP Request qui l'a récupéré. Et ce même HTTP Request ne remplace pas SSH : il appelle des endpoints HTTP, c'est son terrain, alors qu'une session SSH n'est pas du HTTP.
Les limites tiennent en une phrase. Le nœud expose 3 opérations sur 2 ressources, en version 1 d'après le catalogue : tout le reste passe par une commande que tu écris toi-même. Les valeurs viennent en général de l'item précédent, sous la forme d'une expression comme {{ $json.path }}, que n8n remplace au moment de l'exécution. Pour situer ce nœud dans l'ensemble de la plateforme, l'Avis n8n détaille le reste.
Comment authentifier le nœud SSH ?
- 01
Choisir la méthode d'authentification
Deux entrées possibles sur ce nœud :
passwordetprivateKey. Le mot de passe va vite pour un premier test, la clé privée est ce que la plupart des équipes utilisent sur leurs propres serveurs. Le choix se fait sur le credential, c'est-à-dire l'ensemble des informations de connexion que n8n garde de côté pour toi. - 02
Créer le credential dans n8n
Direction le menu Credentials, crée un credential SSH et renseigne les informations correspondant à la méthode retenue. Il se crée une fois et se réutilise dans tous les workflows : rien de sensible ne reste dans le nœud, et un deuxième scénario qui vise la même machine le sélectionne dans une liste au lieu de tout resaisir.
- 03
Le sélectionner puis tester à vide
De retour sur le nœud, choisis le credential dans Credential to connect with, puis l'opération. Lance une première exécution avec une commande inoffensive, qui lit sans rien modifier, histoire de valider que la session s'ouvre avant qu'un vrai script touche au serveur. Le retour s'affiche sur l'item de sortie, là où tu iras lire les résultats ensuite.
Que sait faire le nœud, opération par opération ?
Le nœud SSH expose 3 opérations sur 2 ressources. Pour chacune : le nœud tel que tu le configures dans n8n, les champs obligatoires, et nos notes de terrain.
Command
1 opérationExecute a command
command.executeCe que tu vois dans n8n
Notes & cas d'usage
Cette opération lance une commande sur la machine distante et renvoie son résultat sur l'item de sortie, ce qui permet à la suite du workflow de réagir à ce qui en sort.
Paramètres clés
- Working Directory : requis, le dossier dans lequel n8n exécute la commande. Laissé vide, le nœud refuse de tourner.
- Command : la commande à exécuter sur la machine distante. Elle accepte une expression, donc
{{ $json.script }}laisse un nœud précédent décider de ce qui part.
File
2 opérationsDownload a file
file.downloadCe que tu vois dans n8n
Notes & cas d'usage
Le nœud récupère ici un fichier de la machine distante et l'attache à l'item sous forme de données binaires, prêt pour un nœud de lecture ou de stockage placé juste après.
Paramètres clés
- Path : requis, le chemin du fichier à télécharger. Il doit contenir le chemin complet, nom de fichier inclus, du type
/home/user/invoice.txt. - File Property : requis, le nom de la propriété d'objet qui portera les données binaires sur l'item.
- File Name : une option, ajoutée depuis la collection Options avec Add option, qui remplace le nom de fichier des données binaires.
Upload a file
file.uploadCe que tu vois dans n8n
Notes & cas d'usage
Le dépôt envoie vers la machine distante des données binaires déjà présentes sur l'item : c'est la dernière étape d'un workflow qui a fabriqué ou récupéré un document plus tôt.
Paramètres clés
- Input Binary Field : requis, le nom du champ binaire d'entrée qui contient le fichier à envoyer.
- Target Directory : requis, le dossier de destination, par exemple
/home/user. Le nom du fichier n'a pas à être précisé, il est repris des données binaires. - File Name : le même champ d'Options, utilisé ici pour forcer un autre nom que celui hérité.
Besoin d'aide pour automatiser SSH avec n8n ?
L'équipe te répond directement.
Chaque message est lu par une personne.
