n8n Queue Mode: масштабирование с Redis и воркерами

n8n Queue Mode - это режим выполнения для самостоятельно размещаемых установок n8n, в котором главный экземпляр больше не выполняет workflow сам, а распределяет задания на выполнение через очередь Redis на отдельные процессы воркеров. Режим активируется с помощью переменной окружения EXECUTIONS_MODE=queue на главном экземпляре и экземплярах воркеров; в качестве базы данных n8n рекомендует Postgres вместо SQLite. Queue Mode целесообразен при высокой нагрузке webhook или большом числе параллельных выполнений; для небольших установок с малым числом ежедневных запусков это, напротив, обычно излишние затраты на инфраструктуру. Актуально на: июль 2026 года.

Как технически работает n8n Queue Mode?

Главный экземпляр обрабатывает триггеры, вызовы webhook и интерфейс, но в Queue Mode больше не выполняет workflow сам, а создает ID выполнения и помещает его в очередь Redis. Доступный воркер забирает задание из этой очереди, загружает детали workflow из базы данных по ID выполнения, выполняет workflow и записывает результат обратно в базу данных. Redis сообщает о завершении главному экземпляру. Воркеры - это самостоятельные процессы Node.js, которые работают параллельно друг другу и запускаются по отдельности, например с помощью команды n8n worker. Подробности этого процесса n8n описывает в руководстве Enable queue mode.

Когда Queue Mode действительно необходим?

Queue Mode оправдан, как только один экземпляр n8n достигает своих пределов, например из-за того, что одновременно поступает очень много webhook или несколько workflow должны выполняться параллельно, не замедляя друг друга. В стандартной конфигурации без Queue Mode n8n сам по себе не ограничивает число одновременных продуктивных выполнений, что при высокой нагрузке может привести к перегрузке event loop и медленной реакции экземпляра. С Queue Mode вы распределяете эту нагрузку между несколькими воркерами и можете просто добавлять новые воркеры по мере роста потребности, вместо вертикального масштабирования одного экземпляра. Queue Mode также является предпосылкой для высокой доступности с несколькими главными экземплярами, однако эта конфигурация multi-main является функцией Enterprise.

Когда Queue Mode избыточен для вашей установки?

Для большинства малых и средних предприятий с несколькими десятками автоматизаций и умеренным числом выполнений в день одного экземпляра n8n без Queue Mode вполне достаточно. Вместо того чтобы настраивать Redis, несколько контейнеров воркеров и дополнительный мониторинг, надвигающуюся перегрузку часто можно предотвратить уже с помощью переменной окружения N8N_CONCURRENCY_PRODUCTION_LIMIT, которая ограничивает параллельные продуктивные выполнения на одном экземпляре без необходимости отдельной инфраструктуры очереди. Каждый дополнительный компонент, такой как Redis или дополнительные процессы воркеров, - это также дополнительный элемент, который нужно отслеживать, обновлять и восстанавливать в случае сбоя. Тот, кто лишь изредка обрабатывает данные форм, рассылает ежедневные отчеты или синхронизирует CRM, не получает от Queue Mode заметной пользы, зато получает значительно больше эксплуатационных затрат.

Что нужно технически учесть при настройке?

Для продуктивной работы Queue Mode, по данным n8n, обязательно нужен общий экземпляр Redis в качестве message broker, а также Postgres в качестве базы данных; SQLite не рекомендуется для такого распределенного режима работы. Ключ шифрования N8N_ENCRYPTION_KEY должен быть установлен одинаково на главном экземпляре и на всех экземплярах воркеров, иначе воркеры не смогут расшифровать сохраненные учетные данные. Каждый воркер по умолчанию обрабатывает до десяти заданий параллельно, что настраивается через флаг --concurrency, при этом n8n рекомендует не устанавливать слишком низкое значение, так как иначе при большом числе воркеров пул соединений базы данных может быть исчерпан. Важно также, что Queue Mode не может сохранять бинарные данные в локальной файловой системе соответствующего воркера; для этого предусмотрено внешнее хранилище, такое как S3. Полный список переменных окружения n8n приводит по адресу Queue mode environment variables.

Тем, кто не уверен, действительно ли их собственная установка n8n нуждается в Queue Mode или можно обойтись одним, аккуратно настроенным экземпляром, лучше всего проверить это в рамках технического аудита, например в рамках консультаций NordFlux по n8n.

Часто задаваемые вопросы о n8n Queue Mode

Обязательно ли мне нужен Redis для n8n Queue Mode?

Да, Redis является неотъемлемой частью архитектуры в Queue Mode и управляет очередью, из которой воркеры забирают свои задания. Без работающего экземпляра Redis главный экземпляр и воркеры не могут общаться друг с другом, поэтому Queue Mode невозможно эксплуатировать без Redis.

Могу ли я использовать Queue Mode с SQLite в качестве базы данных?

Нет, для Queue Mode n8n рекомендует Postgres начиная с версии 13, SQLite не рекомендуется для такого распределенного режима работы. Поскольку несколько воркеров одновременно обращаются на чтение и запись к одной и той же базе данных, серверная база данных, предназначенная для этого, такая как Postgres, является более разумным выбором.

Сколько воркеров мне следует запланировать?

Общего ориентировочного значения не существует; каждый воркер по умолчанию обрабатывает до десяти заданий одновременно, что настраивается через флаг --concurrency. Разумнее не запускать сразу много воркеров, а начать с одного или двух воркеров и добавлять новые целенаправленно по мере роста нагрузки.

Что происходит с файлами и вложениями в Queue Mode?

Бинарные данные, такие как загруженные файлы, нельзя сохранять в Queue Mode в локальной файловой системе воркера, поскольку следующий шаг обработки может выполняться на другом воркере. Вместо этого необходимо подключить внешнее хранилище, такое как S3, чтобы все воркеры могли обращаться к одним и тем же бинарным данным.