Требования n8n к серверу: сколько RAM, CPU и диска
Сколько памяти, процессора и диска нужно n8n на своём VPS: стартовые цифры, что на самом деле расходует RAM, почему растёт база и когда переходить на PostgreSQL.
Короткий ответ: требования n8n к серверу
Требования n8n к серверу невысокие: для пробы хватает 1 vCPU и 1 ГБ оперативной памяти, а для реальной работы стоит закладывать 2 ГБ. Документация n8n приводит только пример на основе n8n Cloud (память от 320 МБ до 2 ГБ, база от 512 МБ до 4 ГБ на SSD) и прямо называет его иллюстрацией. Поэтому остальные цифры ниже либо наша рекомендация, либо замер, который вы сделаете на своём VPS за пять минут. Диск чаще всего заканчивается из-за истории запусков, и её стоит ограничить сразу после установки.
Ориентиры по профилям нагрузки:
- Проба и обучение. 1 vCPU, 1 ГБ RAM, база SQLite. SQLite n8n использует по умолчанию, отдельный сервер базы данных не нужен.
- Несколько десятков рабочих сценариев (workflows). 2 ГБ RAM, на старте 1 vCPU, база SQLite или PostgreSQL. Второе ядро нужно, когда много сценариев запускается одновременно.
- Queue mode (режим очереди с воркерами). От 2 vCPU, обязательно Redis, рекомендован PostgreSQL. Queue mode с SQLite не рекомендуется, а распределённая работа поверх SQLite не поддерживается. Объём памяти определяйте замером: каждый воркер работает как отдельный процесс Node.js со своей памятью.
- Диск. В примере на основе n8n Cloud n8n называет для базы (SQLite или PostgreSQL) от 512 МБ до 4 ГБ на SSD, но это иллюстрация. Реальный размер определяют история запусков в базе и бинарные файлы, если вы храните их на диске. Ниже показано, как это ограничить и измерить.
Первые две строки совпадают с нашей инструкцией установка n8n на VPS через Docker с HTTPS: там написано, что для старта нужен 1 ГБ RAM, а когда сценарии начинают делать настоящую работу, нужно 2 ГБ, и одного vCPU для начала достаточно. У хостеров встречаются другие цифры. Например, Hostinger в своей статье про n8n называет минимум 1 vCPU, 2 ГБ RAM и 20 ГБ SSD. Это цифры хостинг-провайдера, а не требования n8n. По памяти они совпадают с нашей рабочей планкой, а 1 ГБ из нашей инструкции подходит только для пробы.
Почему n8n приходится держать на своём сервере
В блоге n8n 10 марта 2022 года вышла запись Update on n8n Cloud accounts in Russia and Belarus. В ней сказано, что с 7 марта компания перестала принимать новых клиентов n8n Cloud из России и Беларуси. Действующим клиентам из этих стран дали 60 дней на перенос своих инстансов. Поэтому для многих читателей из России вариант один: свой сервер. Это значит, что вопрос «сколько памяти и диска нужно» решаете вы, а не облачный тариф.
Если по ходу выяснится, что n8n вам не подходит по другим причинам, посмотрите альтернативы n8n, которые можно поставить на свой сервер.
Что говорит документация n8n о ресурсах
Немного. Страницы об установке через Docker Compose, о проблемах с памятью, о queue mode, о хранении истории запусков и обзор масштабирования не содержат требований к RAM, CPU или диску. Цифры есть на двух страницах. Страница предварительных требований для встраивания n8n в свой продукт (Deploy as an OEM integration) приводит таблицу: CPU «минимум 10 циклов CPU, с масштабированием по необходимости», память от 320 МБ до 2 ГБ, база от 512 МБ до 4 ГБ на SSD (SQLite или PostgreSQL). Там же сказано, что это пример на основе n8n Cloud, приведённый только для иллюстрации, и что реальные потребности зависят от числа пользователей, сценариев и запусков. Вторая страница описывает бенчмарк: один экземпляр n8n на машине AWS c5a.large с 4 ГБ RAM обработал до 220 запусков сценариев в секунду. Это тест пропускной способности, а не минимальные требования. На небольшом VPS вы упрётесь в память раньше, чем в такую нагрузку.
Вывод простой: даже сама n8n называет свои цифры примером, а не требованием. Надёжнее измерить свой сервер.
Как измерить, сколько ресурсов n8n занимает у вас
Сначала посмотрите, что есть на сервере:
nproc
free -h
df -h /nproc выводит число ядер. В выводе free -h смотрите столбец available: это память, которую система может отдать программам без вытеснения в swap. df -h / показывает свободное место на корневом разделе, где Docker по умолчанию хранит тома.
Потом посмотрите, сколько памяти занимают контейнеры:
docker stats --no-streamСтолбец MEM USAGE / LIMIT показывает текущую память каждого контейнера: n8n, а также PostgreSQL и Redis, если они есть. Одного замера в простое мало. Запустите самый тяжёлый сценарий и выполните команду ещё раз во время его работы. Рабочая цифра определяется пиком, а не простоем. Если вы ещё не знакомы с контейнерами, начните с Docker на VPS: что нужно знать до установки сервисов.
Что на самом деле расходует память n8n
На странице n8n «Fix memory issues» перечислены типичные причины. Каждая из них работает по понятному механизму.
- Объём данных JSON. Элементы, которые проходят через узел, лежат в памяти. Сценарий, который за один запуск забирает 10 000 строк из таблицы, держит их все сразу.
- Размер бинарных данных. В режиме
defaultn8n хранит файлы в памяти. Большой PDF или архив целиком занимает оперативную память, и на больших файлах n8n может упасть. - Число узлов в сценарии. Чем длиннее цепочка, тем больше промежуточных данных хранится одновременно.
- Узел Code и старый узел Function. Документация отдельно называет их узлами, которые могут заметно увеличить расход памяти.
- Ручные запуски из редактора. При ручном запуске n8n делает копию данных для интерфейса. Поэтому тот же сценарий в редакторе требует больше памяти, чем в рабочем режиме.
- Сценарии, которые работают одновременно. Каждый параллельный запуск добавляет свои данные к общей памяти процесса.
Отсюда понятны и средства, которые предлагает n8n. Обрабатывайте данные частями: не 10 000 строк за запуск, а, например, по 200. Не используйте узел Code там, где хватает обычных узлов. Не гоняйте большие объёмы данных ручными запусками. Делите длинный сценарий на подсценарии (sub-workflows), каждый из которых возвращает родителю только небольшой результат.
Два параметра помогают прямо на маленьком VPS. Первый ограничивает параллельные запуски. В обычном режиме n8n не ограничивает число одновременных рабочих запусков. Переменная N8N_CONCURRENCY_PRODUCTION_LIMIT включает лимит, и лишние запуски ждут в очереди по порядку поступления. Лимит действует только на рабочие запуски от вебхука или триггера. Второй параметр переносит файлы из памяти на диск: N8N_DEFAULT_BINARY_DATA_MODE=filesystem.
services:
n8n:
environment:
- N8N_CONCURRENCY_PRODUCTION_LIMIT=5
- N8N_DEFAULT_BINARY_DATA_MODE=filesystemЗначение 5 здесь наш пример, а не рекомендация n8n. Подберите его по замеру docker stats во время пиковой нагрузки.
Как понять, что n8n упёрся в память
В интерфейсе n8n нехватку памяти показывает сообщение Execution stopped at this node (n8n may have run out of memory while executing it). Также встречаются Problem running workflow, Connection Lost и 503 Service Temporarily Unavailable. Причину ищите в логах. Команды выполняйте в каталоге, где лежит ваш docker-compose.yml:
docker compose logs n8n | grep -i "heap out of memory"
sudo dmesg -T | grep -i "out of memory"Это два разных предела, и важно понять, какой из них сработал.
Первая команда ищет строку Allocation failed - JavaScript heap out of memory. Она означает, что процесс Node.js дошёл до своего лимита кучи (heap, область памяти для объектов JavaScript) и остановился сам. На сервере при этом может оставаться свободная память. Это лечится параметром --max-old-space-size, о нём следующий раздел.
Вторая команда ищет сообщение ядра Out of memory: Killed process. Оно означает, что закончилась память всего сервера, и ядро Linux принудительно завершило процесс. Здесь увеличение лимита Node.js не поможет, потому что памяти физически нет. Нужно уменьшать нагрузку или добавлять RAM. Если n8n регулярно пропадает без понятной ошибки, разберите почему n8n уходит в офлайн и как найти причину.
Как поднять лимит памяти Node.js через NODE_OPTIONS
n8n советует при ошибке JavaScript heap out of memory задать параметр V8 --max-old-space-size=SIZE через командную строку или через переменную окружения NODE_OPTIONS. В Docker Compose это выглядит так:
services:
n8n:
environment:
- NODE_OPTIONS=--max-old-space-size=1536Примените изменение и проверьте, что лимит дошёл до контейнера:
docker compose up -d
docker compose exec n8n node -e "console.log(Math.round(v8.getHeapStatistics().heap_size_limit / 1048576))"Команда выводит лимит кучи в мебибайтах. С этой настройкой число должно быть около 1536. Если оно сильно отличается, переменная не попала в контейнер: проверьте отступы в YAML и имя сервиса.
Откуда число 1536. n8n не даёт ни значения по умолчанию, ни рекомендованного размера. Значение указывается в МиБ, и документация Node.js советует для машины с 2 ГиБ памяти ставить 1536 (1,5 ГиБ), чтобы оставить память другим программам и не уходить в swap. Этот совет рассчитан на машину, где Node.js работает один. Если на том же VPS работает PostgreSQL, ему тоже нужна память, поэтому выбирайте значение меньше и проверяйте docker stats. Помните, что параметр только поднимает потолок. Он не добавляет памяти серверу. Если поставить лимит выше реальной свободной памяти, вместо ошибки Node.js вы получите сообщение ядра Out of memory: Killed process.
Почему растёт диск: история запусков n8n
По умолчанию n8n сохраняет данные каждого запуска: успешного, с ошибкой и ручного. Очистка старых запусков (pruning) включена по умолчанию. Завершённый запуск попадает под очистку, если он завершился больше EXECUTIONS_DATA_MAX_AGE часов назад (по умолчанию 336 часов, то есть 14 дней), или если общее число запусков превышает EXECUTIONS_DATA_PRUNE_MAX_COUNT (по умолчанию 10 000). Запуски с аннотациями, например тегами или оценками, никогда не удаляются автоматической очисткой; статусы new, running и waiting тоже исключены. Очистка учитывает защитный интервал EXECUTIONS_DATA_HARD_DELETE_BUFFER, по умолчанию 1 час, поэтому эти пороги не гарантируют удаления или точного соблюдения лимита количества. Сначала n8n помечает запуски на удаление и только потом удаляет их окончательно.
Значит, размер базы зависит не от числа сценариев, а от того, сколько данных несёт каждый запуск. Десять тысяч маленьких запусков почти ничего не весят. Десять тысяч запусков, каждый из которых сохранил большой ответ API, могут занять много места. Документация n8n прямо предупреждает, что база может вырасти и занять всё хранилище.
n8n рекомендует не сохранять лишнее. Вот настройка из документации n8n: сохранять только запуски с ошибками и не сохранять ручные. Срок хранения 7 дней (168 часов) тоже взят из примера в документации:
services:
n8n:
environment:
- EXECUTIONS_DATA_SAVE_ON_ERROR=all
- EXECUTIONS_DATA_SAVE_ON_SUCCESS=none
- EXECUTIONS_DATA_SAVE_MANUAL_EXECUTIONS=false
- EXECUTIONS_DATA_PRUNE=true
- EXECUTIONS_DATA_MAX_AGE=168Цена этой настройки: успешные запуски больше не сохраняются, и в списке Executions вы их не увидите. Для отладки нового сценария временно верните EXECUTIONS_DATA_SAVE_ON_SUCCESS=all.
Бинарные данные в режиме filesystem лежат в томе n8n и удаляются вместе с историей запусков. Очистка работает только для активного режима хранения. Если вы раньше хранили файлы в другом режиме, а потом переключились, старые данные прежнего режима очистка не затронет.
Размер томов Docker удобно смотреть одной командой:
docker system df -vВ разделе Local Volumes space usage найдите том n8n (Compose добавляет к имени тома имя проекта, например n8n_n8n_data) и том PostgreSQL, если он есть. Повторите замер через неделю, и вы увидите реальную скорость роста.
Почему файл SQLite не уменьшается после очистки
На SQLite очистка истории не освобождает место на диске. Место удалённых запусков используется заново для новых данных. Поэтому файл database.sqlite после очистки не уменьшается. Зато когда история выходит на постоянный объём, файл перестаёт расти. n8n открывает файл SQLite в режиме WAL, поэтому рядом с ним вы можете увидеть файл database.sqlite-wal.
Чтобы вернуть место, нужна операция VACUUM, которая пересобирает базу. В n8n для этого есть переменная DB_SQLITE_VACUUM_ON_STARTUP, по умолчанию она выключена (false). Включите её на один перезапуск:
services:
n8n:
environment:
- DB_SQLITE_VACUUM_ON_STARTUP=truedocker compose up -d
docker compose logs -f n8nVACUUM выполняется при старте и блокирует запуск, поэтому n8n поднимается дольше обычного. На большой базе это заметно. Дождитесь, пока редактор n8n снова откроется в браузере, затем удалите переменную и снова выполните docker compose up -d. Если оставить её включённой, каждый перезапуск будет долгим. Перед этой операцией сделайте резервную копию тома.
Когда переходить с SQLite на PostgreSQL
n8n не называет порога по числу сценариев или запусков. Есть две конкретные причины для PostgreSQL:
- Вы планируете queue mode. Документация n8n пишет, что queue mode с SQLite не рекомендуется, а распределённая работа поверх SQLite не поддерживается.
- База SQLite стала большой, и простой на VACUUM при старте вам неудобен. n8n в это время недоступен.
Если ни одна причина к вам не относится, SQLite нормально работает для одного сервера с десятками сценариев. Тип базы задаётся переменной DB_TYPE: sqlite (по умолчанию) или postgresdb. Проще выбрать базу сразу при установке. В нашей инструкции по установке PostgreSQL поднимается в соседнем контейнере с первого дня.
Учтите память: PostgreSQL работает отдельным процессом, и его расход виден в docker stats отдельной строкой. На VPS с 1 ГБ это ощутимо, поэтому для связки n8n и PostgreSQL закладывайте 2 ГБ.
Когда queue mode оправдывает лишнюю память
В queue mode основной экземпляр n8n обрабатывает таймеры и вызовы вебхуков. Он создаёт запуски, но сам их не выполняет. Выполняют их воркеры, и каждый воркер является отдельным экземпляром Node.js. Redis служит брокером сообщений между ними, а PostgreSQL хранит данные. На одном VPS вы платите памятью за основной процесс, за каждый воркер, за Redis и за PostgreSQL.
Это оправдано, когда один процесс n8n уже не успевает и ядер больше одного. Наша планка: от 2 vCPU. На одном ядре воркеры делят тот же процессор, и выигрыша почти нет. Число параллельных задач на воркер задаёт флаг --concurrency, по умолчанию 10. n8n рекомендует ставить 5 или больше. Причина в базе: много воркеров с низким --concurrency могут исчерпать пул соединений с базой данных.
Два ограничения queue mode касаются памяти и диска. В queue mode бинарные данные по умолчанию хранятся в database. Режим filesystem требует, чтобы основной экземпляр, воркеры и обработчики вебхуков, работающие с бинарными данными, имели доступ к одному общему тому по одинаковому пути. Внешнее хранилище S3 или Azure Blob Storage доступно на self-hosted планах Business и Enterprise с соответствующей лицензией. Второе ограничение относится к Redis: переменная N8N_WEBHOOK_RESPONSE_RELAY_SIZE_MAX задаёт максимальный размер сообщения с ответом вебхука, который передаётся через Redis, в МиБ (по умолчанию 64). Redis держит несколько копий ответа, пока тот в обработке, поэтому на каждый такой ответ закладывайте в памяти Redis примерно 1,5 значения этой переменной, то есть около 96 МиБ при значении по умолчанию. С n8n 2.34.0 параметр N8N_WEBHOOK_RESPONSE_RELAY_OFFLOAD_ENABLED=true позволяет вынести тело ответа сверх лимита в хранилище бинарных данных, доступное всем экземплярам; сначала обновите все основные экземпляры и обработчики вебхуков до этой версии или новее. Без выгрузки ответ сверх лимита приводит к ошибке узла.
Нужен ли swap для n8n
Swap (файл или раздел подкачки на диске) полезен как запас, но не заменяет оперативную память. Он даёт ядру место, куда можно вынести редко используемые страницы памяти, и короткий пик не приводит к Out of memory: Killed process. Но диск намного медленнее RAM. Если n8n постоянно работает с памятью, вынесенной в swap, сценарии сильно замедляются. Именно поэтому документация Node.js советует ставить лимит кучи так, чтобы не уходить в swap.
Проверить, используется ли swap прямо сейчас:
free -h
vmstat 1 5В выводе vmstat смотрите столбцы si и so: это объём памяти, который читается из swap и записывается в него за секунду. Нули или редкие небольшие значения означают, что swap работает как запас. Постоянные ненулевые значения означают, что памяти не хватает, и нужно добавить RAM или снизить нагрузку. Как выбрать размер, описано в статье нужен ли VPS swap и какого размера.
Короткий порядок действий
- Начните с 1 ГБ для пробы или с 2 ГБ для рабочих сценариев.
- Сразу ограничьте историю запусков переменными
EXECUTIONS_DATA_*. - Включите
N8N_DEFAULT_BINARY_DATA_MODE=filesystem, если сценарии работают с файлами и вы не используете queue mode. - Замерьте
docker stats --no-streamво время пиковой нагрузки иdocker system df -vчерез неделю работы. - При
JavaScript heap out of memoryподнимите--max-old-space-size, приOut of memory: Killed processдобавьте RAM или снизьте нагрузку.
FAQ
Сколько оперативной памяти нужно n8n на VPS?
n8n публикует только пример на основе n8n Cloud: память от 320 МБ до 2 ГБ, и прямо называет его иллюстрацией, а не требованием для своего сервера. Для пробы достаточно 1 ГБ RAM, для реальных сценариев закладывайте 2 ГБ, особенно если на том же сервере работает PostgreSQL. Точную цифру для своей нагрузки получите командой docker stats --no-stream, запущенной во время самого тяжёлого сценария.
Почему база n8n занимает так много места на диске?
По умолчанию n8n сохраняет данные каждого запуска, а пороги очистки составляют 14 дней (336 часов) или 10 000 запусков. Это не жёсткие пределы: запуски с аннотациями никогда не очищаются автоматически, статусы new, running и waiting исключены, а удаление учитывает защитный интервал, по умолчанию 1 час. Если запуски несут большие ответы API, база быстро растёт. Отключите сохранение успешных и ручных запусков через EXECUTIONS_DATA_SAVE_ON_SUCCESS=none и EXECUTIONS_DATA_SAVE_MANUAL_EXECUTIONS=false и сократите срок через EXECUTIONS_DATA_MAX_AGE. На SQLite файл после очистки не уменьшается: для этого нужен VACUUM через DB_SQLITE_VACUUM_ON_STARTUP=true на один перезапуск.
Хватит ли SQLite, или n8n нужен PostgreSQL?
Для одного сервера с десятками сценариев SQLite, база по умолчанию, работает. PostgreSQL рекомендован для queue mode: работа этого режима с SQLite не рекомендуется, а распределённая работа поверх SQLite не поддерживается. Он также удобнее, если база стала большой и простой при VACUUM на старте вам мешает. Выбрать базу проще при установке, через переменную DB_TYPE=postgresdb.
Что делать с ошибкой «JavaScript heap out of memory» в n8n?
Эта ошибка означает, что Node.js дошёл до своего лимита кучи. Задайте NODE_OPTIONS=--max-old-space-size=1536 (значение в МиБ, его документация Node.js советует для машины с 2 ГиБ памяти) и уменьшите нагрузку: обрабатывайте данные частями, избегайте узла Code и больших ручных запусков. Если в dmesg видно Out of memory: Killed process, закончилась память всего сервера, и поднятие лимита не поможет.