Recursos · Integración n8n

Integración S3 n8nAutomatiza S3 con n8n.

Tus archivos viven en un MinIO, un Wasabi o un Space de DigitalOcean, y un flujo de trabajo necesita alcanzarlos. La integración S3 n8n reúne 12 operaciones sobre 3 recursos: buckets, archivos y carpetas. Nadie escucha por su cuenta, así que la ejecución arranca desde otro nodo.

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

Por qué automatizar

¿Qué resuelve la integración S3 n8n?

El nodo S3 habla con cualquier almacenamiento compatible con S3 que no sea el de Amazon: MinIO, Wasabi, DigitalOcean Spaces o Tigris. Le das a n8n una URL de endpoint, una región y un par de claves de acceso, y a partir de ahí crea, lee y borra buckets, archivos y carpetas desde el propio flujo. Para el servicio de Amazon, n8n trae un nodo AWS S3 aparte: no son intercambiables, porque las credenciales no tienen la misma forma.

Primer escenario, el respaldo que corre de madrugada. Un Schedule Trigger arranca, una consulta contra Microsoft SQL devuelve los movimientos del día, el flujo los arma como texto CSV y file.upload escribe ese texto en una carpeta con fecha usando el parámetro File Content. Sin binarios y sin pasar por el disco de nadie.

Segundo escenario, los documentos generados. Un nodo HTTP Request recoge un informe o una imagen producida en otro sitio y la entrega como datos binarios, file.upload la guarda bajo una clave predecible y esa clave termina en una fila de Google Sheets que hace de índice. Es la forma exacta de las plantillas S3 publicadas, donde el nodo aparece junto a HTTP Request y poco más.

Tercer escenario, la entrada de material externo. Un nodo Webhook, es decir una URL de n8n que un sistema ajeno llama, recibe el archivo de un proveedor, y este cae en el bucket que bucket.create abrió al dar de alta a ese proveedor. Conviene recordar que la subida exige que el archivo llegue desde un nodo anterior como propiedad de datos: Read/Write Files from Disk o HTTP Request cumplen ese papel. Un caso parecido es guardar los artefactos que publica un repositorio de GitHub.

¿Cuándo tirar de HTTP Request? El nodo expone 12 operaciones y ahí termina su superficie. Lo demás de la API S3 de tu proveedor queda a un nodo HTTP Request de distancia, reutilizando la misma credencial con autenticación predefinida, así las claves no se copian dentro del flujo.

Los límites conviene tenerlos claros antes de montar nada. No hay trigger de S3, o sea que nada reacciona solo cuando aparece un objeto. Tampoco hay mover ni renombrar: reubicar un archivo es file.copy y luego file.delete. Los listados se detienen en Limit mientras Return All siga desmarcado, algo que pesa en un bucket con miles de claves. Y en Wasabi los permisos se fijan sí o sí desde el desplegable ACL, nunca con los interruptores de concesión. Si el equipo arranca de cero con n8n, el Curso n8n cubre credenciales y expresiones antes de tocar datos reales.

Conexión

¿Cómo conectar S3 con n8n?

  1. 01

    Genera la clave de acceso en tu proveedor

    Todo almacenamiento compatible con S3 entrega un par de claves. En DigitalOcean Spaces está en Settings, luego la página API y la pestaña Spaces Keys, donde Generate New Key muestra una Key y un Secret. En Tigris es la sección Access Keys de la consola: el identificador empieza por tid_ y el secreto por tsec_. Ese secreto aparece una sola vez, cópialo antes de cerrar la ventana.

  2. 02

    Rellena la credencial S3 en n8n

    Entra en el menú Credentials de n8n, elige S3 y pega cuatro valores. S3 Endpoint es la URL del almacenamiento, con https:// delante. Region es la región donde está tu bucket, lo que algunos proveedores llaman region slug, por ejemplo nyc3 en Spaces o auto en Tigris. Después Access Key ID y Secret Access Key del paso anterior.

  3. 03

    Ajusta los dos interruptores de direccionamiento

    Force Path Style pasa la conexión a direccionamiento de buckets por ruta. DigitalOcean Spaces y Tigris lo quieren apagado, porque ambos usan el formato por subdominio. Ignore SSL Issues deja que n8n conecte aunque falle la validación del certificado, situación habitual contra un MinIO autoalojado con certificado propio. Fuera de ese caso, déjalo apagado. Guardada una vez, la credencial aparece en todos los flujos.

Acciones

Las 12 operaciones del nodo S3

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

Matriz recursos × operaciones
RecursoCreateGet ManyDeleteCopyDownloadSearchUpload
Bucket✓✓✓✓
File✓✓✓✓✓
Folder✓✓✓

Bucket

4 operaciones
01

Create a bucket

bucket.create

Lo que ves en n8n

Notas y casos de uso

Crea un bucket en el almacenamiento al que apunta la credencial. Aterriza en la región definida en esa credencial, salvo que la llamada indique otra.

Parámetros clave

  • Name: el nombre del bucket, muchas veces una expresión tipo {{ $json.account_slug }} cuando un flujo aprovisiona espacio por cuenta.
  • ACL: la canned ACL que se aplica al crear, desde Authenticated Read hasta Public Read Write. Private lo deja cerrado a las llamadas anónimas.
  • Region: solo hace falta si el bucket debe vivir fuera de la región de la credencial.
Casos de uso
el alta de un cliente que recibe almacenamiento aislado, creado por el mismo flujo que registra su ficha.
02

Delete a bucket

bucket.delete

Lo que ves en n8n

Notas y casos de uso

Le pasas un nombre de bucket y el servidor lo elimina. El nodo no pide ninguna confirmación, de modo que lo que resuelva la expresión es lo que desaparece.

Parámetros clave

  • Name: el nombre del bucket a borrar, escrito a mano o heredado de un item anterior con {{ $json.Name }}.
Casos de uso
desmontar el bucket de pruebas que creó una batería de tests, o liberar el espacio de una cuenta dada de baja hace meses.
03

Get many buckets

bucket.getAll

Lo que ves en n8n

Notas y casos de uso

Devuelve los buckets que ve la clave de acceso, un item de n8n por bucket. Va bien como primer paso, cuando el flujo necesita saber qué existe antes de escribir nada.

Parámetros clave

  • Return All: marcado, n8n encadena las páginas de la API hasta el último bucket; sin marcar, se detiene en Limit.
  • Limit: el techo de items devueltos mientras Return All siga apagado.
Casos de uso
el inventario mensual del almacenamiento, o la comprobación de que el bucket del cliente existe antes de subir nada.

File

5 operaciones
05

Copy a file

file.copy

Lo que ves en n8n

Notas y casos de uso

Duplica un objeto de una ubicación a otra sin que los bytes pasen por n8n. Ambas rutas empiezan con una barra y el nombre del bucket, seguidos de la clave.

Parámetros clave

  • Source Path: bucket y clave del original, con el formato /bucket/my-image.jpg.
  • Destination Path: destino de la copia, mismo formato, por ejemplo /bucket/my-second-image.jpg.
  • Metadata Directive: Copy conserva los metadatos del origen, Replace pone los que trae la petición.
  • Storage Class: la clase en la que se escribe la copia, de Standard a Deep Archive.
Casos de uso
ascender un documento validado del bucket de entrada al de expedientes tratados.
06

Delete a file

file.delete

Lo que ves en n8n

Notas y casos de uso

Apunta a un objeto por su clave y lo retira del bucket. En un bucket con versiones, la llamada puede dirigirse a una versión concreta en lugar de a la vigente.

Parámetros clave

  • Bucket Name: el bucket que guarda el objeto.
  • File Key: la clave completa del objeto, prefijo de carpeta incluido.
  • Version ID: campo opcional dentro de Options que dirige el borrado a una versión.
Casos de uso
la segunda mitad de un traslado, justo después de Copy a file, o la purga de exportaciones que superan el plazo de conservación que te has fijado.
07

Download a file

file.download

Lo que ves en n8n

Notas y casos de uso

Saca un objeto del bucket y se lo entrega al resto del flujo como datos binarios, listo para el nodo que lo envía, lo lee o lo vuelve a subir.

Parámetros clave

  • Bucket Name: dónde está el objeto.
  • File Key: la clave que se recupera, normalmente {{ $json.Key }} venida de Get many files.
  • Put Output File in Field: el nombre del campo binario de salida donde se deposita el archivo, el que tendrá que mirar el nodo siguiente.
Casos de uso
recuperar una factura guardada para adjuntarla en el aviso de cobro que sale después.
08

Get many files

file.getAll

Lo que ves en n8n

Notas y casos de uso

Recorre el contenido de un bucket y devuelve un item por objeto, con su clave y sus metadatos. Se combina con Download a file cuando el flujo también necesita los bytes.

Parámetros clave

  • Bucket Name: el bucket que se lista.
  • Folder Key: reduce el listado a una carpeta en vez del bucket entero.
  • Fetch Owner: no viene en la respuesta por defecto, actívalo para recibir el campo propietario en cada clave.
  • Return All: marcado, vuelven todos los objetos; sin marcar, Limit acota el lote.
Casos de uso
contar cada mañana los archivos que un socio ha dejado en su carpeta de entrega.
09

Upload a file

file.upload

Lo que ves en n8n

Notas y casos de uso

Escribe un archivo en el bucket, ya sea desde un campo binario producido antes o desde texto tecleado en el propio nodo. Es la operación sobre la que gira casi cualquier flujo con S3.

Parámetros clave

  • Bucket Name: el bucket de destino.
  • File Name: el nombre que toma el objeto, por ejemplo hello.txt.
  • Input Binary Field: el campo binario de entrada que contiene el archivo, alimentado por Read/Write Files from Disk o HTTP Request.
  • Binary File: apagado, el nodo usa File Content, el texto que escribes, en lugar de un campo binario.
  • ACL: en Wasabi los permisos se ajustan con este desplegable y no con los interruptores.
Casos de uso
archivar un contrato firmado en cuanto el formulario lo devuelve.

Folder

3 operaciones
10

Create a folder

folder.create

Lo que ves en n8n

Notas y casos de uso

En S3 una carpeta es una convención de nombres más que un directorio real, y esta operación escribe la clave que la hace visible en la consola y en los listados.

Parámetros clave

  • Bucket Name: el bucket que acoge la carpeta.
  • Folder Name: el nombre de la carpeta a secas, sin la ruta del padre.
  • Parent Folder Key: la carpeta dentro de la cual quieres crear esta, que es como se expresa el anidamiento.
  • Storage Class: de Standard a Reduced Redundancy, según lo que vaya a acumularse ahí.
Casos de uso
abrir una carpeta por mes al inicio de un flujo de exportación.
11

Delete a folder

folder.delete

Lo que ves en n8n

Notas y casos de uso

Quita una carpeta de un bucket a partir de su clave. Como una carpeta es solo una clave, la operación toca la estructura y no los objetos que el flujo haya ido dejando dentro.

Parámetros clave

  • Bucket Name: el bucket afectado.
  • Folder Key: la clave de la carpeta que se retira, con la ruta del padre incluida.
Casos de uso
cerrar el espacio de un proyecto cuando sus entregables ya están copiados al almacenamiento de largo plazo, o limpiar carpetas temporales creadas antes en la misma ejecución.
12

Get many folders

folder.getAll

Lo que ves en n8n

Notas y casos de uso

Enumera las carpetas que hay en un bucket, un item por cada una, para que un flujo pueda iterar sobre ellas sin conocer de antemano la estructura.

Parámetros clave

  • Bucket Name: el bucket que se explora.
  • Folder Key: limita la respuesta a lo que cuelga de una carpeta concreta.
  • Return All: marcado, el nodo encadena páginas; sin marcar, Limit fija el máximo devuelto.
  • Fetch Owner: añade el campo propietario a cada clave del resultado.
Casos de uso
pasar por una carpeta de cada cliente para aplicarles el mismo paso de archivado.
Necesitas ayuda

¿Necesitas ayuda para automatizar S3 con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

S3 y n8n, lo que se pregunta todo el mundo

01¿La integración S3 n8n es gratuita?
Sí por el lado de n8n. El nodo S3 viene incluido con n8n, no hay nada que instalar ni ningún coste añadido, tanto en n8n Cloud como en una instancia autoalojada con la Community Edition y su licencia Sustainable Use. Un flujo se comporta igual en ambos casos. Lo que se paga es el almacenamiento en sí, y eso lo arreglas con tu proveedor: el nodo se limita a firmar peticiones contra el endpoint que le indicas. Sumar un segundo bucket, un segundo proveedor o un segundo flujo no mueve ni un céntimo en la parte de n8n.
02¿Qué credenciales necesita el nodo S3?
Una sola credencial S3, con el método S3 endpoint. Hay que dar cuatro valores: S3 Endpoint, la URL del almacenamiento, Region, lo que algunos proveedores llaman region slug, Access Key ID, la clave de acceso que emite tu proveedor para el bucket o el space, y Secret Access Key, su secreto correspondiente. Dos interruptores completan la ficha: Force Path Style para direccionar los buckets por ruta, e Ignore SSL Issues para backends cuyo certificado no pasa la validación. Creada una vez en Credentials, queda disponible en todos los flujos.
03¿Qué límites tiene el nodo S3 en n8n?
El nodo se queda en 12 operaciones sobre 3 recursos, así que cualquier otra cosa de la API S3 de tu proveedor pide un nodo HTTP Request, que puede reutilizar la misma credencial con autenticación predefinida. No existe mover ni renombrar: reubicar un objeto es Copy a file y después Delete a file. Los listados devuelven hasta Limit mientras Return All siga desmarcado. Subir un archivo exige que llegue como propiedad de datos desde otro nodo. Y en Wasabi los permisos se fijan con el desplegable ACL, no con los interruptores de concesión.
04¿Puede n8n reaccionar cuando llega un archivo al bucket?
No de forma directa, porque esta integración no trae nodo trigger, es decir el nodo que inicia un flujo. Un flujo con S3 arranca en otro sitio: un Schedule Trigger que repite la comprobación a intervalo fijo, un nodo Webhook al que llama un servicio que ya conoce el objeto nuevo, o el trigger de otra herramienta de la cadena. El montaje habitual es un Get many files o un Search a bucket programado, cuyo resultado se compara con lo que la ejecución anterior ya había procesado.
05¿n8n o Make para un almacenamiento compatible con S3?
Depende sobre todo de dónde tengan que quedarse los datos. n8n se autoaloja con Docker o npm, de modo que buckets, claves y registros de ejecución siguen en una infraestructura que controlas tú, y además existe la versión alojada n8n Cloud. Make solo funciona alojado, sin opción de autoalojamiento, y factura por operación: un flujo que lista miles de claves tiene un perfil de coste muy distinto. Make aporta un editor visual que muchos equipos leen más rápido. Las claves de almacenamiento son datos sensibles, y ese criterio suele inclinar la balanza.