N8n requirements

Требования к развертыванию и эксплуатации платформы автоматизации n8n

n8n — это мощный инструмент для автоматизации рабочих процессов (workflow automation), распространяемый по модели fair-code. Его архитектура, построенная на Node.js, предъявляет конкретные требования к аппаратному и программному обеспечению, а также к сетевым конфигурациям. Понимание этих требований критически важно для стабильной, безопасной и производительной работы системы как в режиме самохостинга, так и при использовании облачного предложения n8n.cloud. Данная статья детально рассматривает все аспекты, необходимые для планирования, установки и поддержки n8n.

Аппаратные требования (Self-Hosted)

Аппаратные требования сильно варьируются в зависимости от сложности и количества выполняемых рабочих процессов, объема обрабатываемых данных и уровня параллелизма.

Минимальные требования (для тестирования и небольших нагрузок)

• ЦПУ (CPU): 1-2 ядра современного процессора (Intel/AMD x64, ARM64).
• Оперативная память (RAM): Не менее 1 ГБ. Для стабильной работы рекомендуется от 2 ГБ. Память активно используется для выполнения рабочих процессов и хранения временных данных.
• Дисковое пространство (Storage): Не менее 1 ГБ для установки самого n8n, его зависимостей и баз данных. Тип диска: SSD настоятельно рекомендуется для повышения производительности операций ввода-вывода, особенно при использовании внутренней базы данных SQLite.
• Сеть: Стабильное интернет-соединение для доступа к внешним API и сервисам.

Рекомендуемые требования (для рабочих сред, production)

• ЦПУ (CPU): 4+ ядер. Сложные рабочие процессы, включающие обработку данных, преобразования и множественные HTTP-запросы, требуют значительных вычислительных ресурсов.
• Оперативная память (RAM): 4-8 ГБ и более. Каждый экземпляр рабочего процесса потребляет память. Большое количество одновременно выполняемых workflow или обработка крупных наборов данных (например, файлов) может быстро исчерпать память.
• Дисковое пространство (Storage): 20+ ГБ на быстром SSD или NVMe. Объем зависит от:
  • Логирования (журналов выполнения).
  • Хранения вложений (если workflow обрабатывают файлы).
  • Роста базы данных (исполнения, учетные записи пользователей, сохраненные credentials).
• Резервирование: Для отказоустойчивости рекомендуется развертывание в кластерной конфигурации с использованием внешней базы данных и очереди сообщений.

Программные требования и зависимости

Базовое программное обеспечение

• Node.js: Версия 18.x или 20.x. Версии 16.x и 19.x не поддерживаются. Необходим пакетный менеджер npm (обычно поставляется с Node.js).
• Система управления пакетами: Для установки через npm или yarn.
• Система контроля версий Git: Требуется для установки n8n через git, а также для использования функционала Version Control.
• Python 3: Не является обязательным для самого n8n, но требуется для работы некоторых специфичных узлов (нод), например, для выполнения пользовательского кода на Python.

Сервер баз данных (для Production-сред)

n8n поддерживает несколько СУБД. Выбор зависит от масштаба и требований к отказоустойчивости.

База данных	Использование	Рекомендации и требования
SQLite	По умолчанию, для демо и малых нагрузок.	Встроена, не требует отдельной установки. Не подходит для production с высокой нагрузкой или многопользовательским доступом. Ограничения по параллелизму.
PostgreSQL	Основной выбор для production.	Требуется версия 12 или выше. Обеспечивает высокую производительность, надежность и поддержку многопользовательского режима. Необходима отдельная установка и настройка.
MySQL / MariaDB	Альтернатива для production.	Требуется MySQL 8.0 или выше, или MariaDB 10.8 и выше. Должна использоваться кодировка utf8mb4.

Дополнительные компоненты для масштабирования

• Очередь сообщений (Message Queue): Для горизонтального масштабирования (запуска нескольких воркеров) необходима внешняя очередь. Поддерживается Redis (версии 5 и выше) и RabbitMQ. Очередь управляет распределением задач (workflow execution) между экземплярами n8n.
• Веб-сервер / Reverse Proxy: Для production-развертывания настоятельно рекомендуется размещать n8n за reverse proxy (например, Nginx, Apache, Caddy). Это обеспечивает:
  • SSL/TLS терминацию (HTTPS).
  • Балансировку нагрузки.
  • Кэширование статических файлов.
  • Безопасность (скрытие внутренней структуры).

Требования к операционной системе и среде исполнения

n8n является кроссплатформенным приложением и может работать на:

• Linux: Наиболее предпочтительная и распространенная ОС для серверного развертывания (Ubuntu 20.04/22.04 LTS, Debian 11/12, CentOS/RHEL 8+ и их производные).
• Windows: Поддерживается, но в основном для целей разработки и тестирования. Для production на Windows существуют дополнительные сложности с управлением службами и производительностью.
• macOS: Подходит для локальной разработки и тестирования.
• Контейнеры Docker: Официальный образ Docker — это стандартный и рекомендуемый способ развертывания. Он инкапсулирует все зависимости (Node.js, n8n) и упрощает обновление. Требуется установленный Docker Engine или совместимая среда (Podman, Kubernetes).
• Облачные платформы (IaaS): Может быть развернут на любом облачном VM (AWS EC2, Google Compute Engine, Azure VMs, DigitalOcean Droplet) при соблюдении вышеуказанных требований.

Требования к сети и безопасности

Исходящие соединения

n8n должен иметь доступ в интернет для взаимодействия с внешними API, сервисами (Google Sheets, Slack, Telegram, HTTP-запросы и т.д.). Необходимо обеспечить:

• Разрешение исходящего трафика на TCP-порты 80 (HTTP) и 443 (HTTPS). Для специфичных API могут потребоваться другие порты.
• Отсутствие блокировок на уровне межсетевого экрана (firewall) или прокси-сервера для доменов, используемых в рабочих процессах.

Входящие соединения

Для приема вебхуков (Webhooks) от внешних сервисов n8n должен быть доступен извне.

• Порт по умолчанию: 5678 (для прямого доступа). В production этот порт должен быть закрыт для внешнего мира, а доступ должен осуществляться только через reverse proxy на стандартных портах 80/443.
• Динамические вебхуки (Dynamic Webhooks): Требуют уникального, публично доступного URL. Это накладывает обязательное требование к наличию белого IP-адреса и доменного имени, привязанного к инстансу n8n.
• Статические вебхуки (Static Webhooks): Могут использовать настройки reverse proxy для маршрутизации.

Безопасность

• Шифрование (HTTPS): Обязательно для production-среды. Достигается через reverse proxy с использованием сертификатов от Let’s Encrypt или коммерческих центров сертификации.
• Аутентификация: Для многопользовательского режима (n8n.cloud или Enterprise-версия) требуется настройка аутентификации. В самохостинговой версии по умолчанию её нет, что требует организации дополнительной защиты (например, базовой аутентификации на уровне reverse proxy или VPN).
• Безопасность credentials: Учетные данные для подключения к сервисам хранятся в зашифрованном виде в базе данных. Необходимо обеспечить физическую безопасность сервера БД и строгое управление доступом.

Требования для специфичных сценариев использования

Обработка файлов и вложений

Если workflow включают загрузку, создание или обработку файлов, необходимо:

• Дополнительное дисковое пространство, соответствующее максимальному ожидаемому объему файлов.
• Настройка переменной среды N8N_DEFAULT_BINARY_DATA_MODE для определения способа хранения файлов: в памяти (для маленьких файлов), в файловой системе или во внешнем хранилище (например, Amazon S3).
• Высокая пропускная способность дисковой подсистемы.

Высокая доступность (High Availability) и масштабирование

Для построения отказоустойчивой архитектуры требуются:

• Несколько экземпляров (инстансов) n8n, запущенных на разных серверах или в разных зонах доступности.
• Внешняя база данных (PostgreSQL/MySQL) в кластерной конфигурации (репликация, мастер-слейв).
• Внешняя очередь сообщений (Redis Sentinel/Cluster или RabbitMQ Cluster).
• Внешнее хранилище для файлов (S3, MinIO) для обеспечения общего доступа всех инстансов к данным.
• Балансировщик нагрузки (Load Balancer) перед reverse proxy или между ними.

Требования для развертывания в Kubernetes

Для оркестрации контейнеризированных инстансов n8n в Kubernetes необходимы:

• Кластер Kubernetes версии 1.19 и выше.
• Helm (для установки с использованием официального Helm-чарта) или манифесты YAML.
• Настроенный Ingress Controller (Nginx, Traefik) для маршрутизации входящего трафика.
• Persistent Volume (PV) для хранения данных, если не используется внешнее хранилище для вложений.
• External Secrets Operator или аналогичный инструмент для управления секретами (база данных, ключи API).

Требования для использования n8n.cloud (Managed Service)

При использовании облачной управляемой версии от n8n требования к инфраструктуре снимаются с пользователя, но появляются другие аспекты:

• Учетная запись и подписка: Требуется регистрация и выбор тарифного плана (Starter, Pro, Business).
• Доступ в интернет: Для работы с веб-интерфейсом и выполнения workflow.
• Настройка подключений: Необходимо обеспечить доступность ваших внутренних систем (если к ним обращается n8n) из облака n8n (белые IP-адреса, VPN).
• Соблюдение политик безопасности компании: Проверка соответствия облачного сервиса корпоративным нормам (GDPR, локализация данных и т.д.).

Заключение

Требования к развертыванию n8n варьируются от минимальных (для ознакомления) до сложных распределенных систем для enterprise-сред. Ключевыми факторами при планировании являются: ожидаемая нагрузка (количество workflow и их сложность), необходимость в высокой доступности и отказоустойчивости, требования безопасности и комплаенс. Для большинства рабочих сред оптимальным выбором является развертывание в Docker-контейнерах с использованием PostgreSQL в качестве базы данных, Redis для очередей и Nginx в качестве reverse proxy. Использование управляемого сервиса n8n.cloud полностью снимает вопросы инфраструктурных требований, перекладывая их на поставщика услуги.

Ответы на часто задаваемые вопросы (FAQ)

Можно ли запустить n8n на Raspberry Pi?

Да, это возможно, так как существуют Docker-образы и пакеты для архитектуры ARM. Raspberry Pi 4 с 4+ ГБ оперативной памяти может справиться с небольшими и средними рабочими нагрузками. Однако необходимо учитывать ограничения производительности CPU и ввода-вывода SD-карты. Для повышения надежности рекомендуется использовать внешний SSD и внешнюю базу данных.

Какая база данных лучше для n8n: PostgreSQL или MySQL?

Официальная документация n8n рекомендует PostgreSQL как основную базу данных для production-сред. Она лучше протестирована с n8n и часто показывает более стабильную производительность при сложных операциях. MySQL/MariaDB является полностью поддерживаемой альтернативой, и выбор может быть обусловлен существующей инфраструктурой и экспертизой команды.

Обязательно ли использовать Docker для развертывания?

Нет, не обязательно. n8n можно установить напрямую с помощью npm (npm install n8n -g), развернуть как systemd-сервис или использовать готовые пакеты (например, .deb). Однако Docker (или другой контейнерный runtime) значительно упрощает процесс установки зависимостей, обновления и изоляции приложения, что делает его де-факто стандартом для self-hosted развертываний.

Почему n8n не запускается после обновления Node.js?

n8n строго требует определенных мажорных версий Node.js (18 или 20). Обновление до неподдерживаемой версии (например, 21) или откат на более старую (16) приведет к ошибкам. Необходимо использовать менеджер версий Node.js (как nvm или n) для корректной установки и переключения между версиями, совместимыми с n8n.

Как обеспечить безопасность self-hosted инстанса n8n?

Ключевые меры: 1) Размещение за reverse proxy с обязательным HTTPS. 2) Настройка базовой аутентификации или интеграция с OAuth2 прокси, если используется однопользовательский режим. 3) Регулярное обновление n8n и его зависимостей. 4) Ограничение доступа к порту 5678 только для локального хоста или reverse proxy. 5) Использование отдельного пользователя ОС с минимальными привилегиями для запуска процесса n8n. 6) Шифрование тома базы данных и регулярное резервное копирование.

Сколько рабочих процессов (workflows) может одновременно выполняться на одном сервере?

Ограничение зависит от ресурсов CPU и RAM. По умолчанию n8n использует «веб-процесс» и «воркер-процесс». Воркер может выполнять несколько workflow параллельно за счет асинхронной обработки. При нехватке памяти или CPU будут возникать задержки и ошибки. Для увеличения пропускной способности необходимо настроить горизонтальное масштабирование: запустить несколько экземпляров n8n в режиме «worker» с общей очередью (Redis) и базой данных.

Нужно ли открывать порт 5678 для интернета?

Категорически не рекомендуется открывать порт 5678 напрямую в интернет. Это создает угрозу безопасности. Весь входящий трафик должен проходить через reverse proxy (Nginx/Apache/Caddy), который обеспечивает SSL-терминацию, базовую защиту и маршрутизацию на внутренний порт 5678.