Tester des workflows : Pin Data, Mock Data, mode Debug
Pin Data, Mock Data et mode Debug dans n8n : comment tester des workflows avec des données de test fixées plutôt qu'en direct contre des systèmes de production.
Les données binaires en mémoire vive ou dans la base de données ralentissent n8n. Les modes filesystem et S3 résolvent le problème, avec les variables adéquates.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
NordFlux construit des employés numériques pour les organisations : des automatisations et des agents KI qui prennent en charge le travail répétitif. Vous gardez le contrôle.
Pin Data, Mock Data et mode Debug dans n8n : comment tester des workflows avec des données de test fixées plutôt qu'en direct contre des systèmes de production.
n8n garde les données binaires en RAM : 100 PDFs peuvent faire crasher le serveur. Voici comment le mode Filesystem ou S3 aide à prévenir l'explosion de mémoire.
Pourquoi la base de données n8n grossit à cause des executions et comment EXECUTIONS_DATA_PRUNE, la durée de conservation et les limites réduisent automatiquement le volume de données.
Passer au stockage filesystem ou S3 soulage la base de données, mais soulève de nouvelles questions sur les sauvegardes, la rétention et les droits d'accès. Avec l'hébergement n8n géré par NordFlux, le mode binary data est configuré correctement dès le départ, pruning et stratégie de sauvegarde compris. Nous examinons volontiers où en est votre instance aujourd'hui.