Données binaires : Filesystem/S3 au lieu de la base de données

Lorsqu'un workflow n8n traite des PDF, des images ou d'autres fichiers, n8n doit stocker temporairement ces données binaires quelque part avant de les transmettre au node suivant. Sans configuration explicite, ces données atterrissent dans la mémoire vive ou, selon le mode de fonctionnement, dans la base de données elle-même, ce qui entraîne rapidement des problèmes de mémoire et une base de données surchargée en cas de fichiers volumineux ou de nombreuses exécutions parallèles. La documentation officielle de n8n sur le Gestion des données binaires à grande échelle recommande donc, pour les instances de production, de passer au mode filesystem ou, avec les licences self-hosted enterprise, à un stockage S3 externe. Date : juillet 2026.

Pourquoi la base de données n'est pas adaptée aux données binaires

Par défaut, n8n conserve les données binaires en mémoire vive, ce qui, selon la documentation, peut provoquer des plantages avec des fichiers volumineux. Si une instance fonctionne en mode queue avec plusieurs workers, n8n ne prend pas en charge le mode filesystem, et les données binaires doivent alors être stockées en mode base de données. Le problème : une base de données relationnelle est conçue pour de nombreuses petites lignes structurées, pas pour de gros blobs binaires. Plus les fichiers stockés grossissent, plus la base de données grossit sensiblement elle aussi, ce qui ralentit les sauvegardes, la réplication et les requêtes normales. C'est exactement là qu'intervient le passage au stockage filesystem ou S3.

Mode filesystem : la première étape pragmatique

Pour les instances n8n self-hosted en dehors du mode queue, le mode filesystem est la solution la plus simple. Il peut être activé via la variable d'environnement N8N_DEFAULT_BINARY_DATA_MODE avec la valeur filesystem, ce qui amène n8n à écrire les données binaires sur le disque plutôt qu'en mémoire vive. L'emplacement de stockage peut être adapté via N8N_BINARY_DATA_STORAGE_PATH, par défaut il se trouve sous N8N_USER_FOLDER/binaryData. De plus, N8N_AVAILABLE_BINARY_DATA_MODES définit quels modes sont disponibles, sous forme de liste séparée par des virgules avec filesystem comme valeur par défaut. Les détails de toutes les variables sont listés dans la documentation n8n sur les variables d'environnement pour les données binaires. Important pour les exploitants : si l'instance fonctionne en mode queue, cette approche n'est pas utilisable selon la documentation, il ne reste alors que le mode base de données ou S3.

Mode S3 : stockage externe pour les déploiements évolutifs

Quiconque exploite n8n à plus grande échelle ou s'appuie sur plusieurs instances worker peut stocker les données binaires dans un stockage d'objets compatible S3. Selon la documentation n8n sur le stockage externe, ce mode n'est disponible que sur les plans self-hosted enterprise et nécessite une clé de licence enterprise valide, sans laquelle l'instance ne démarre même pas en mode S3. La configuration se fait via plusieurs variables.

• N8N_EXTERNAL_STORAGE_S3_HOST: le point de terminaison S3, par exemple s3.us-east-1.amazonaws.com
• N8N_EXTERNAL_STORAGE_S3_BUCKET_NAME: le nom du bucket
• N8N_EXTERNAL_STORAGE_S3_BUCKET_REGION: la région, à partir de la version 2.6.4 uniquement des caractères alphanumériques et des tirets, sans région définie la valeur auto suffit
• N8N_EXTERNAL_STORAGE_S3_ACCESS_KEY et N8N_EXTERNAL_STORAGE_S3_ACCESS_SECRET: identifiants d'accès pour le bucket
• N8N_EXTERNAL_STORAGE_S3_AUTH_AUTO_DETECT: optionnellement sur true, pour détecter automatiquement les identifiants, par exemple via un rôle IAM

Le mode est activé via N8N_AVAILABLE_BINARY_DATA_MODES=filesystem,s3 combiné à N8N_DEFAULT_BINARY_DATA_MODE=s3, suivi d'un redémarrage de l'instance. Les données binaires se retrouvent alors structurées sous workflows/{workflowId}/executions/{executionId}/binary_data/{binaryFileId} dans le bucket.

Bien préparer la migration

Avant la bascule, vous devriez configurer le bucket avec la politique IAM pour les actions S3 nécessaires et définir une règle de cycle de vie qui supprime automatiquement les anciennes données binaires, car selon la documentation, n8n ne prend pas en charge ce nettoyage automatiquement. Un autre point facilement négligé : le pruning des données binaires n'agit à chaque fois que sur le mode actuellement actif. Si vous passez du mode base de données au mode filesystem ou S3, les anciennes données binaires restent dans l'emplacement de stockage précédent et doivent être nettoyées séparément. Quiconque exploite une instance n8n en production avec un volume de données croissant a intérêt à planifier cette bascule tôt, plutôt que de réagir seulement lorsque la base de données devient nettement plus lente. NordFlux accompagne la mise en place de n8n, y compris une configuration de stockage adaptée au volume de données réel.

Questions fréquentes sur les données binaires dans n8n

Quelle est la différence entre le mode filesystem et le mode S3 ?

Le mode filesystem écrit les données binaires sur le disque local du serveur n8n et convient aux instances individuelles ne fonctionnant pas en mode queue. Le mode S3 externalise les données vers un stockage d'objets externe et est destiné aux configurations distribuées avec plusieurs workers, mais nécessite pour cela une licence self-hosted enterprise.

Ai-je obligatoirement besoin d'une licence enterprise pour le mode S3 ?

Oui. Selon la documentation n8n, l'instance ne démarre pas en mode S3 sans clé de licence enterprise valide. Pour les configurations plus petites ne fonctionnant pas en mode queue, le mode filesystem gratuit suffit généralement.

Le mode filesystem fonctionne-t-il aussi en mode queue ?

Non. n8n ne prend pas en charge le mode filesystem en combinaison avec le mode queue. Les exploitants disposant de plusieurs workers doivent à la place utiliser soit le mode base de données, soit, avec la licence adéquate, le mode S3.

Qu'advient-il des données binaires déjà stockées lors du changement de mode ?

Elles ne sont ni migrées ni supprimées automatiquement. Le pruning ne fonctionne toujours que sur le mode actuellement configuré, donc les anciens fichiers dans l'emplacement de stockage précédent restent en place et doivent être nettoyés manuellement.