Recursos · Integración n8n

Nodo FTP n8nConfigura FTP en n8n.

El nodo FTP n8n lleva archivos de un workflow a un servidor remoto y al revés. Un solo nodo reúne 5 operaciones, desde una subida simple hasta el listado recursivo de una carpeta, por FTP o por SFTP. Eliges el protocolo, indicas una ruta y el archivo aparece donde el workflow lo espera.

Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth

Por qué automatizar

¿Para qué sirve el nodo FTP n8n?

El nodo FTP conecta un workflow con un servidor de archivos y hace una sola cosa por ejecución: borrar, descargar, listar, renombrar o subir. Es un nodo core, incluido en n8n, así que aparece en el panel sin instalar nada y sin coste añadido, tanto en n8n Cloud como en una instancia alojada por ti. El campo Protocol decide si el intercambio va por FTP o por SFTP, la variante cifrada que viaja dentro de un túnel SSH.

Primer escenario, el catálogo del proveedor. Muchos mayoristas siguen dejando su stock en una carpeta SFTP cada madrugada. Un Schedule Trigger despierta el workflow, un nodo FTP en List recorre /public/folder con Recursive activado y otro descarga cada archivo encontrado. Después los datos aterrizan donde toque, por ejemplo en la hoja que gestiona el nodo Google Sheets.

Segundo escenario, el camino inverso. El workflow genera un export y lo deja en el servidor del cliente. La operación Upload admite un archivo binario que viene de un nodo anterior o un texto escrito en File Content, suficiente para un manifiesto corto. Si la carpeta de destino cambia según el archivo, un nodo If separa los dos casos y un aviso por Slack cierra la ejecución.

Tercer escenario, el orden. Rename mueve el archivo ya procesado a una carpeta de archivo histórico y Delete quita lo que ya no hace falta. Son dos operaciones modestas, pero piden una ruta revisada: el nodo actúa sobre la ruta completa que recibe, sin preguntar nada.

Conviene aclarar lo que este nodo no es: un cliente HTTP. El nodo HTTP Request llama a cualquier endpoint HTTP y sirve de recurso cuando a un nodo dedicado le falta una operación de API, nunca para un protocolo que no es HTTP. FTP y SFTP quedan fuera de su alcance, y por eso existe el nodo FTP.

Quedan los límites, mejor conocerlos antes de montar nada. No hay trigger de FTP, así que el workflow lo abre otra cosa, normalmente un Schedule Trigger o un Webhook. Las lecturas concurrentes solo aceleran la descarga por SFTP y no todos los servidores las admiten. El nodo va por la versión 1, de modo que un workflow antiguo muestra los mismos campos. Si la duda es qué plataforma usar, la Reseña n8n repasa los criterios.

Conexión

¿Qué credencial necesita el nodo FTP ?

  1. 01

    Crear la cuenta en el servidor

    La credencial se autentica contra un servidor File Transfer Protocol que ya existe, así que esa cuenta va primero. Sirven JSCAPE, OpenSSH o FileZilla Server, y la documentación del proveedor es donde están los datos de conexión. En n8n hay dos tipos de credencial: FTP account, para un servidor sin túnel SSH ni conexión cifrada, y SFTP account, para un servidor que admite ambas cosas.

  2. 02

    Rellenar los campos de conexión

    Los dos tipos empiezan igual. Escribes el Host, es decir el nombre o la dirección IP del servidor, luego el Port que debe usar la conexión, el Username con el que se conecta la credencial y el Password de ese usuario. Una credencial se crea una vez en el menú Credentials y la reutilizan todos los workflows que hablan con ese servidor.

  3. 03

    Añadir la clave para SFTP

    Una cuenta SFTP pide dos campos más. Private Key recibe una cadena para autenticación basada en clave o en host, en formato OpenSSH, generada casi siempre con el parámetro -o de ssh-keygen, por ejemplo ssh-keygen -o -a 100 -t ed25519. Si esa clave está cifrada, Passphrase la descifra. Si no lleva passphrase, el campo se deja vacío.

Acciones

¿Qué sabe hacer el nodo FTP en un servidor?

El nodo FTP expone 5 operaciones. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.

01

Delete a file or folder

delete

Lo que ves en n8n

Notas y casos de uso

Borra un archivo del servidor, o un directorio entero en cuanto se activa la opción correspondiente. A la salida no llega nada más que la confirmación de que la entrada ya no está.

Parámetros clave

  • Path: la ruta completa de lo que se borra, del tipo /public/documents/file-to-delete.txt, a menudo {{ $json.path }} heredado de un listado.
  • Folder: activado, el nodo borra carpetas además de archivos, y aparece una opción más.
  • Recursive: activado sobre una carpeta, se van con ella todos los archivos y directorios del directorio de destino.
Casos de uso
vaciar la carpeta de entrada cuando sus archivos ya están guardados, o quitar un directorio temporal al terminar un lote.
02

Download a file

download

Lo que ves en n8n

Notas y casos de uso

Trae un archivo del servidor y lo adjunta al item como dato binario, listo para cualquier nodo que lea archivos.

Parámetros clave

  • Path: la ruta completa del archivo que se descarga, por ejemplo /public/documents/file-to-download.txt.
  • Put Output File in Field: el nombre del campo binario de salida donde queda el archivo, el que leerá el nodo siguiente.
  • Enable Concurrent Reads: en SFTP acelera las descargas, y Max Concurrent Reads limita cuántas corren a la vez. Hay servidores SFTP que no lo aceptan.
  • Chunk Size: el tamaño en KB de cada trozo, que no todos los servidores soportan.
Casos de uso
recoger la tarifa nocturna antes de procesarla, o traer un archivo pesado que en un servidor lento se quedaría a medias.
03

List folder content

list

Lo que ves en n8n

Notas y casos de uso

Devuelve lo que contiene un directorio, un item por entrada, con lo que una carpeta remota se convierte en una lista que el workflow puede recorrer.

Parámetros clave

  • Path: el directorio cuyo contenido se lista, por ejemplo /public/folder.
  • Recursive: aquí es obligatorio, y activado devuelve un objeto con todos los directorios y objetos encontrados de forma recursiva en el servidor, en lugar del primer nivel solo.
  • Timeout: el tiempo de espera de la conexión en milisegundos, útil cuando un árbol profundo tiene ocupado al servidor.
Casos de uso
comprobar si el proveedor ya dejó el archivo del día antes de seguir, o construir la lista de rutas que atacará el paso de descarga.
04

Rename / move a file or folder

rename

Lo que ves en n8n

Notas y casos de uso

Cambia el sitio donde vive una entrada dentro del servidor. Renombrar y mover son aquí la misma operación, porque todo se reduce a escribir otra ruta.

Parámetros clave

  • Old Path: la ruta que existe ahora, por ejemplo /public/documents/old-file.txt.
  • New Path: el destino, del estilo /public/documents/new-file.txt, muchas veces montado con una expresión para meter la fecha en el nombre.
  • Create Directories: activado, el nodo crea de forma recursiva el directorio de destino, lo que salva la ejecución cuando la carpeta de archivo histórico todavía no existe.
Casos de uso
guardar cada factura procesada en una carpeta por año, o marcar el nombre con la fecha antes de que otro sistema lo recoja.
05

Upload a file

upload

Lo que ves en n8n

Notas y casos de uso

Escribe un archivo en el servidor, ya venga como dato binario de un nodo anterior o como texto escrito en el propio nodo.

Parámetros clave

  • Path: la ruta completa de destino, por ejemplo /public/documents/file-to-upload.txt.
  • Binary File: activado para subir un archivo binario, desactivado para teclear el contenido. Los campos siguientes dependen de esta elección.
  • Input Binary Field: se muestra con Binary File activado y nombra el campo binario de entrada que contiene el archivo por escribir.
  • File Content: se muestra con Binary File desactivado y recibe el contenido de texto del archivo que se sube.
Casos de uso
dejar un export CSV en el servidor de un cliente, o escribir un archivo de estado corto que otro sistema consulta.
Necesitas ayuda

¿Necesitas ayuda para automatizar FTP con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

FTP y n8n: preguntas frecuentes

01¿El nodo FTP viene incluido en n8n, en Cloud y en autoalojado?
Sí. FTP es un nodo core, incluido en n8n, así que no hay nada que instalar ni coste extra por el lado de n8n. Funciona igual en n8n Cloud, la oferta alojada por n8n, y en una instancia autoalojada con Docker o npm, en Community Edition bajo licencia Sustainable Use. Un workflow montado en un sitio funciona en el otro. Lo que el nodo toca, en cambio, vive fuera de n8n: el servidor de archivos es tuyo o de tu proveedor, y lo que cueste mantenerlo es otra conversación.
02¿Qué hace falta para que funcione el nodo FTP n8n?
Una credencial, es decir unos datos de acceso guardados en n8n, y una cuenta en un servidor de archivos. Hay dos métodos de autenticación. El tipo FTP account encaja con un servidor sin túnel SSH ni conexiones cifradas, y pide Host, Port, Username y Password. El tipo SFTP account es para un servidor que admite túnel SSH y cifrado, y añade Private Key en formato OpenSSH junto con la Passphrase que la descifra cuando la clave está protegida. La credencial se crea una vez y la reutilizan todos los workflows.
03¿Qué límites tiene el nodo FTP?
Cubre 5 operaciones sobre un único recurso: borrar, descargar, listar, renombrar y subir. Cualquier otra cosa del servidor queda fuera. Va por la versión 1, así que los workflows antiguos muestran el mismo panel. Las lecturas concurrentes solo afectan a la descarga por SFTP y algunos servidores las rechazan, igual que pueden rechazar un tamaño de trozo personalizado. Subir exige que el archivo llegue en binario desde otro nodo, y por eso suele haber antes un paso Read/Write Files from Disk o HTTP Request. Un campo obligatorio vacío detiene la ejecución.
04¿Cuándo usar el nodo FTP en lugar de HTTP Request?
Siempre que la transferencia vaya por FTP o por SFTP. El nodo HTTP Request llama a cualquier endpoint HTTP y cubre lo que un nodo dedicado deja fuera en una API HTTP, pero ahí se acaba: no es un recurso para un protocolo que no es HTTP. Un proveedor que expone una API REST se atiende con HTTP Request, y ese mismo proveedor dejando archivos en un servidor se atiende con el nodo FTP. Los dos se combinan sin problema, y la plantilla 663 hace justo eso: descargar un archivo por HTTP y subirlo luego a un servidor FTP.
05¿n8n o Make para mover archivos por FTP?
Depende de dónde quieras que vivan los archivos y la plataforma. Make está alojado, sin opción de autoalojamiento, y se factura por operación, así que un workflow que lista una carpeta y descarga decenas de archivos cada noche tiene un coste que sube con el volumen. n8n puede correr en tu propio servidor, lo que significa que el contenido de los archivos no sale de una infraestructura que controlas, y ese suele ser el punto que decide cuando los documentos son sensibles. Make ofrece un editor visual que a muchos equipos de operaciones les resulta más rápido de leer. Aloja, control del dato, modelo de coste y lógica visual: ese es el orden.