Datos binarios: Filesystem/S3 en lugar de base de datos

Cuando un workflow de n8n procesa PDF, imágenes u otros archivos, n8n debe almacenar temporalmente estos datos binarios en algún lugar antes de pasarlos al siguiente node. Sin una configuración explícita, estos datos terminan en la memoria RAM o, según el modo de funcionamiento, en la propia base de datos, lo que provoca rápidamente problemas de memoria y una base de datos sobrecargada con archivos grandes o muchas ejecuciones paralelas. La documentación oficial de n8n sobre el Gestión de datos binarios a gran escala recomienda por ello que las instancias en producción cambien al modo filesystem o, con licencias self-hosted enterprise, a un almacenamiento S3 externo. Fecha: julio de 2026.

Por qué la base de datos no es adecuada para datos binarios

De forma predeterminada, n8n mantiene los datos binarios en la memoria RAM, lo que, según la documentación, puede provocar fallos con archivos grandes. Si una instancia se ejecuta en modo queue con varios workers, n8n no admite el modo filesystem, y los datos binarios deben almacenarse entonces en modo base de datos. El problema: una base de datos relacional está diseñada para muchas filas pequeñas y estructuradas, no para grandes blobs binarios. A medida que crecen los archivos almacenados, la base de datos también crece notablemente, lo que ralentiza las copias de seguridad, la replicación y las consultas normales. Ahí es exactamente donde entra el cambio a almacenamiento filesystem o S3.

Modo filesystem: el primer paso pragmático

Para instancias n8n self-hosted fuera del modo queue, el modo filesystem es la solución más sencilla. Se puede activar mediante la variable de entorno N8N_DEFAULT_BINARY_DATA_MODE con el valor filesystem, lo que hace que n8n escriba los datos binarios en disco en lugar de en memoria RAM. La ubicación de almacenamiento se puede ajustar mediante N8N_BINARY_DATA_STORAGE_PATH, y por defecto se encuentra en N8N_USER_FOLDER/binaryData. Además, N8N_AVAILABLE_BINARY_DATA_MODES define qué modos están disponibles, como una lista separada por comas con filesystem como valor predeterminado. Los detalles de todas las variables se enumeran en la documentación de n8n sobre variables de entorno para datos binarios. Importante para los operadores: si la instancia se ejecuta en modo queue, este enfoque no se puede utilizar según la documentación, y solo queda el modo base de datos o S3.

Modo S3: almacenamiento externo para despliegues escalables

Quien opere n8n a mayor escala o dependa de varias instancias worker puede almacenar los datos binarios en un almacenamiento de objetos compatible con S3. Según la documentación de n8n sobre almacenamiento externo, este modo solo está disponible en los planes self-hosted enterprise y requiere una clave de licencia enterprise válida, sin la cual la instancia ni siquiera arranca en modo S3. La configuración se realiza mediante varias variables.

• N8N_EXTERNAL_STORAGE_S3_HOST: el endpoint de S3, por ejemplo s3.us-east-1.amazonaws.com
• N8N_EXTERNAL_STORAGE_S3_BUCKET_NAME: el nombre del bucket
• N8N_EXTERNAL_STORAGE_S3_BUCKET_REGION: la región, a partir de la versión 2.6.4 solo caracteres alfanuméricos y guiones, si no se especifica región basta con el valor auto
• N8N_EXTERNAL_STORAGE_S3_ACCESS_KEY y N8N_EXTERNAL_STORAGE_S3_ACCESS_SECRET: credenciales de acceso para el bucket
• N8N_EXTERNAL_STORAGE_S3_AUTH_AUTO_DETECT: opcionalmente en true, para detectar automáticamente las credenciales, por ejemplo mediante un rol IAM

El modo se activa mediante N8N_AVAILABLE_BINARY_DATA_MODES=filesystem,s3 junto con N8N_DEFAULT_BINARY_DATA_MODE=s3, seguido de un reinicio de la instancia. Los datos binarios quedan entonces estructurados en workflows/{workflowId}/executions/{executionId}/binary_data/{binaryFileId} dentro del bucket.

Preparar bien la migración

Antes del cambio, debería configurar el bucket junto con la política IAM para las acciones S3 necesarias y establecer una regla de ciclo de vida que elimine automáticamente los datos binarios antiguos, ya que, según la documentación, n8n no se encarga de esta limpieza automáticamente. Otro punto que se pasa por alto fácilmente: el pruning de datos binarios solo afecta cada vez al modo actualmente activo. Si cambia del modo base de datos al modo filesystem o S3, los datos binarios más antiguos permanecen en la ubicación de almacenamiento anterior y deben limpiarse por separado. Quien opere una instancia n8n en producción con un volumen de datos creciente debería planificar este cambio con antelación, en lugar de reaccionar solo cuando la base de datos se vuelva notablemente más lenta. NordFlux ayuda con la configuración de n8n, incluyendo una configuración de almacenamiento que se ajusta al volumen de datos real.

Preguntas frecuentes sobre datos binarios en n8n

¿Cuál es la diferencia entre el modo filesystem y el modo S3?

El modo filesystem escribe los datos binarios en el disco local del servidor n8n y es adecuado para instancias individuales que no se ejecutan en modo queue. El modo S3 traslada los datos a un almacenamiento de objetos externo y está pensado para configuraciones distribuidas con varios workers, pero requiere para ello una licencia self-hosted enterprise.

¿Necesito obligatoriamente una licencia enterprise para el modo S3?

Sí. Según la documentación de n8n, la instancia no arranca en modo S3 sin una clave de licencia enterprise válida. Para configuraciones más pequeñas que no se ejecutan en modo queue, normalmente basta con el modo filesystem gratuito.

¿Funciona el modo filesystem también en modo queue?

No. n8n no admite el modo filesystem en combinación con el modo queue. Los operadores con varios workers deben usar en su lugar el modo base de datos o, con la licencia adecuada, el modo S3.

¿Qué ocurre con los datos binarios ya almacenados al cambiar de modo?

No se migran ni se eliminan automáticamente. El pruning siempre funciona solo sobre el modo configurado actualmente, por lo que los archivos antiguos en la ubicación de almacenamiento anterior permanecen y deben limpiarse manualmente.