Тестирование workflow: Pin Data, Mock Data, режим Debug
Pin Data, Mock Data и режим Debug в n8n: как тестировать workflow с зафиксированными тестовыми данными вместо тестирования вживую на продуктивных системах.
Бинарные данные в оперативной памяти или в базе данных замедляют n8n. Режимы filesystem и S3 решают эту проблему с помощью подходящих переменных.
Когда workflow n8n обрабатывает PDF, изображения или другие файлы, n8n должен временно где-то сохранить эти бинарные данные, прежде чем передать их следующему node. Без явной настройки эти данные попадают в оперативную память или, в зависимости от режима работы, в саму базу данных, что при больших файлах или множестве параллельных выполнений быстро приводит к проблемам с памятью и раздутой базе данных. Официальная документация n8n по Обработка бинарных данных в большом масштабе поэтому рекомендует для рабочих инстансов переход в режим filesystem или, при наличии self-hosted enterprise лицензии, на внешнее S3-хранилище. Актуально на: июль 2026.
По умолчанию n8n хранит бинарные данные в оперативной памяти, что, согласно документации, может приводить к сбоям при больших файлах. Если инстанс работает в режиме queue с несколькими workers, n8n не поддерживает режим filesystem, и бинарные данные приходится хранить в режиме базы данных. Проблема в том, что реляционная база данных рассчитана на множество небольших структурированных строк, а не на крупные бинарные blob-объекты. По мере роста сохраненных файлов заметно растет и сама база данных, что замедляет резервное копирование, репликацию и обычные запросы. Именно здесь и пригождается переход на хранение в filesystem или S3.
Для self-hosted инстансов n8n вне режима queue режим filesystem является самым простым решением. Он активируется через переменную окружения N8N_DEFAULT_BINARY_DATA_MODE со значением filesystem, благодаря чему n8n записывает бинарные данные на диск вместо оперативной памяти. Расположение хранилища можно настроить через N8N_BINARY_DATA_STORAGE_PATH, по умолчанию оно находится в N8N_USER_FOLDER/binaryData. Кроме того, N8N_AVAILABLE_BINARY_DATA_MODES определяет, какие режимы вообще доступны, в виде списка через запятую со значением filesystem по умолчанию. Подробности по всем переменным перечислены в документации n8n о переменных окружения для бинарных данных. Важно для операторов: если инстанс работает в режиме queue, этот способ, согласно документации, использовать нельзя, остается только режим базы данных или S3.
Тот, кто эксплуатирует n8n в более крупном масштабе или использует несколько worker-инстансов, может хранить бинарные данные в S3-совместимом объектном хранилище. Согласно документации n8n о внешнем хранилище, этот режим доступен только на планах self-hosted enterprise и требует действительного ключа enterprise-лицензии, без которого инстанс вообще не запустится в режиме S3. Настройка выполняется через несколько переменных.
Режим активируется через N8N_AVAILABLE_BINARY_DATA_MODES=filesystem,s3 вместе с N8N_DEFAULT_BINARY_DATA_MODE=s3, после чего следует перезапуск инстанса. Бинарные данные затем оказываются структурированы по пути workflows/{workflowId}/executions/{executionId}/binary_data/{binaryFileId} в bucket.
Перед переходом следует настроить bucket вместе с IAM-политикой для необходимых действий S3 и задать правило жизненного цикла, которое автоматически удаляет старые бинарные данные, поскольку, согласно документации, n8n не берет на себя эту очистку автоматически. Еще один момент, который легко упустить: pruning бинарных данных всегда действует только на текущий активный режим. Если вы переключаетесь с режима базы данных на filesystem или S3, более старые бинарные данные остаются в прежнем месте хранения и должны быть очищены отдельно. Тот, кто эксплуатирует инстанс n8n в продакшене с растущим объемом данных, должен планировать этот переход заранее, а не реагировать только тогда, когда база данных заметно замедлится. NordFlux оказывает поддержку в настройке n8n, включая конфигурацию хранилища, соответствующую фактическому объему данных.
Режим filesystem записывает бинарные данные на локальный диск сервера n8n и подходит для отдельных инстансов, не работающих в режиме queue. Режим S3 выносит данные во внешнее объектное хранилище и предназначен для распределенных конфигураций с несколькими workers, но для этого требуется self-hosted enterprise лицензия.
Да. Согласно документации n8n, инстанс не запускается в режиме S3 без действительного ключа enterprise-лицензии. Для небольших конфигураций, не работающих в режиме queue, обычно достаточно бесплатного режима filesystem.
Нет. n8n не поддерживает режим filesystem в сочетании с режимом queue. Операторам с несколькими workers вместо этого необходимо использовать либо режим базы данных, либо, при наличии соответствующей лицензии, режим S3.
Они не мигрируют и не удаляются автоматически. Pruning всегда действует только на текущий настроенный режим, поэтому старые файлы в прежнем месте хранения остаются и должны быть очищены вручную.
NordFlux создаёт цифровых сотрудников для организаций: автоматизации и КИ-агентов, которые берут на себя повторяющуюся работу. Вы сохраняете контроль.
Pin Data, Mock Data и режим Debug в n8n: как тестировать workflow с зафиксированными тестовыми данными вместо тестирования вживую на продуктивных системах.
n8n хранит бинарные данные в оперативной памяти: 100 PDF-файлов могут привести к сбою сервера. Как режим Filesystem или S3 помогает справиться со взрывным ростом потребления памяти.
Почему база данных n8n растёт из-за executions и как EXECUTIONS_DATA_PRUNE, срок хранения и лимиты автоматически ограничивают объём данных.
Переход на файловую систему или S3 разгружает базу данных, но ставит новые вопросы о резервных копиях, сроках хранения и правах доступа. В управляемом хостинге n8n от NordFlux режим binary data настроен правильно с первого дня, включая pruning и стратегию резервного копирования. Мы охотно посмотрим, в каком состоянии ваш экземпляр сегодня.