Nodo SSH n8nConfigura SSH en n8n.
El nodo SSH n8n abre una sesión en una máquina remota para lanzar un comando o mover un archivo. Trae 3 operaciones repartidas en 2 recursos y entra con contraseña o con clave privada. Se ejecuta una vez por cada item que recibe y nunca arranca un flujo por su cuenta.
Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth
¿Para qué sirve el nodo SSH n8n en un flujo?
Un disparador precede siempre al nodo SSH n8n, un Schedule Trigger o un Webhook, esa URL que otro sistema llama para avisar a n8n; el nodo nunca arranca un flujo por su cuenta. A partir de ahí abre una sesión Secure Shell hacia una máquina remota y, en cada item que recibe, ejecuta una de sus tres operaciones: lanzar un comando, descargar un archivo o subir otro.
Hay tareas que nunca tuvieron API. Un servidor propio que se queda sin espacio, un programa de gestión antiguo que deja sus informes en una carpeta, un script que alguien lanza a mano cada lunes. Ahí es donde este nodo encaja, y sus tres operaciones cubren casi todos esos gestos.
Primer escenario: la limpieza programada. Un Schedule Trigger arranca de madrugada, Execute a command lanza el script en el Working Directory indicado y lo que devuelve el comando acaba en un aviso por Gmail para quien vigila la máquina. Segundo escenario: la descarga de un informe. Download a file recoge el archivo en su Path completo y las filas terminan en Google Sheets, donde el resto del equipo las consulta sin pedir acceso al servidor. Tercer escenario: la subida de una copia de seguridad generada antes en el flujo, enviada con Upload a file al Target Directory que espera la aplicación.
Conviene tener en cuenta dos detalles. La subida da por hecho que el archivo ya existe como dato binario en el item, así que otro nodo tiene que ponerlo antes: un Read/Write Files from Disk o una llamada HTTP Request que lo haya traído. Y ese mismo HTTP Request no sustituye a SSH: llama a endpoints HTTP, que es su terreno, mientras que una sesión SSH no es HTTP.
Los límites se resumen rápido. El nodo expone 3 operaciones sobre 2 recursos y el catálogo lo sitúa en la versión 1, de modo que cualquier cosa más elaborada hay que escribirla como comando. Los valores suelen venir del item anterior mediante una expresión del tipo {{ $json.path }}, que n8n resuelve al ejecutar. Si quieres ver cómo encaja este nodo en el conjunto de la plataforma, la Reseña n8n lo cuenta con calma.
¿Cómo se autentica el nodo SSH ?
- 01
Elige el método de autenticación
El nodo admite dos entradas:
passwordyprivateKey. La contraseña sirve para una primera prueba rápida; la clave privada es lo que acaban usando los equipos en los servidores que administran. La elección se hace en el credential, es decir, el conjunto de datos de conexión que n8n guarda por ti fuera del flujo. - 02
Crea el credential en n8n
Ve al menú Credentials, crea un credential SSH y rellena los datos del método elegido. Se crea una sola vez y se reutiliza en todos los flujos, así que nada sensible queda dentro del nodo y un segundo flujo que apunte a la misma máquina lo selecciona de una lista en lugar de repetir la configuración entera.
- 03
Selecciónalo en el nodo y prueba
De vuelta en el nodo, elige el credential en Credential to connect with y después la operación. Lanza una primera ejecución con un comando inofensivo, de los que solo leen, para confirmar que la sesión se abre antes de que un script real toque el servidor. La respuesta aparece en el item de salida, que es donde leerás los resultados más adelante.
¿Qué hace el nodo, operación por operación?
El nodo SSH expone 3 operaciones en 2 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.
Command
1 operaciónExecute a command
command.executeLo que ves en n8n
Notas y casos de uso
Esta operación lanza un comando en la máquina remota y devuelve su resultado en el item de salida, con lo que el resto del flujo puede decidir en función de lo que haya salido.
Parámetros clave
- Working Directory: requerido, la carpeta en la que n8n ejecuta el comando. Si se queda vacío, el nodo no llega a ejecutarse.
- Command: el comando que se ejecuta en el dispositivo remoto. Acepta expresiones, así que con
{{ $json.script }}decide un nodo anterior.
File
2 operacionesDownload a file
file.downloadLo que ves en n8n
Notas y casos de uso
Aquí el nodo trae un archivo de la máquina remota y lo engancha al item como dato binario, listo para el nodo de lectura o de almacenamiento que venga después.
Parámetros clave
- Path: requerido, la ruta del archivo que se descarga. Tiene que incluir la ruta completa con el nombre del archivo, al estilo de
/home/user/invoice.txt. - File Property: requerido, el nombre de la propiedad del objeto que contendrá los datos binarios.
- File Name: una opción que se añade desde la colección Options con Add option y que sobrescribe el nombre del archivo de los datos binarios.
Upload a file
file.uploadLo que ves en n8n
Notas y casos de uso
La subida envía a la máquina remota datos binarios que ya viajan en el item, así que suele ser el último paso de un flujo que ha generado o recuperado un documento antes.
Parámetros clave
- Input Binary Field: requerido, el nombre del campo binario de entrada que contiene el archivo que se va a subir.
- Target Directory: requerido, la carpeta de destino, por ejemplo
/home/user. El nombre del archivo no hace falta indicarlo, se toma de los datos binarios. - File Name: el mismo campo de Options, aquí para imponer un nombre distinto del heredado.
¿Necesitas ayuda para automatizar SSH con n8n?
El equipo te responde directamente.
Cada mensaje lo lee una persona.
