SSD Nodes Learn Hosting plans →
Посібники Matt ConnorВід Matt Connor

Чому n8n переходить в автономний стан на VPS

Чотири різні збої виглядають як автономний режим n8n: банер websocket, цикл перезапусків, завершення через нестачу пам’яті або зламаний розклад.

Чому n8n постійно переходить в автономний стан: чотири причини, один симптом

Фраза «n8n постійно переходить в автономний стан» може означати чотири різні проблеми, і для кожної потрібне окреме рішення. Редактор показує повідомлення про втрату з’єднання, хоча контейнер працює нормально. Контейнер самостійно перезапускається. Ядро завершує процес Node.js через надмірне споживання пам’яті. Або з процесом усе гаразд, але активний workflow просто не запускається. Якщо змінити неправильний параметр, можна витратити всі вихідні на проблему, якої насправді не існує.

Тому спочатку визначте, яка саме проблема виникла, і лише потім змінюйте конфігурацію. n8n запускає основний процес Node.js, зазвичай усередині Docker-контейнера, за reverse proxy, який завершує TLS (transport layer security). Code nodes також використовують процеси task runner: internal mode запускає дочірній процес, а external mode запускає їх окремо, зазвичай в окремому sidecar-контейнері. Кожен із цих рівнів може виходити з ладу по-своєму, але браузер повідомляє про помилки з’єднання однаковим повідомленням.

Діагностика в такому порядку

Виконайте ці команди на VPS (virtual private server) і прочитайте значення, які виводить саме ваша машина. Не порівнюйте їх із числами з допису на форумі. Важливі тут значення описують ваш сервер, а не чужий.

docker ps -a --filter name=n8n
docker logs --tail 200 --timestamps n8n
docker inspect n8n | grep -iE 'Status|Running|RestartCount|OOMKilled|ExitCode'
docker stats --no-stream

Стовпець STATUS у docker ps -a показує, як довго контейнер перебуває в поточному стані. Порівняйте це значення з моментом початку проблеми. Якщо контейнер працює ще від задовго до появи банера, це виключає перезапуск контейнера в той момент, але не доводить, що n8n залишався доступним. Перевірте /healthz, щоб підтвердити доступність, і /healthz/readiness, щоб підтвердити підключення до бази даних і виконану міграцію, перш ніж переходити до websocket-шляху, описаного в наступному розділі.

RestartCount показує, скільки разів Docker перезапускав цей контейнер. Запишіть число, зачекайте хвилину, а потім прочитайте його ще раз. Якщо під час спостереження число зростає, це цикл перезапусків. Рядки журналу безпосередньо перед кожним перезапуском містять причину.

OOMKilled — це прапорець зі значенням true або false. Значення true означає, що Docker зафіксував завершення процесу в контейнері через нестачу пам’яті. Перегляньте це значення разом із журналами та повідомленнями ядра, щоб визначити, який процес було завершено і чи виник тиск через ліміт контейнера, чи через нестачу пам’яті на всій машині.

ExitCode показує код, з яким контейнер завершив роботу востаннє. Вам не потрібно запам’ятовувати значення кожного коду. Прочитайте свій код, а потім перегляньте кінець docker logs за тією самою часовою позначкою. Кінець журналу та прапорець завершення через нестачу пам’яті разом показують, що сталося. Окремо кожне з цих значень може ввести в оману.

docker stats показує поточне використання пам’яті поруч із чинним лімітом. Залиште команду запущеною в другому терміналі, запустіть workflow, який спричиняє проблему, і спостерігайте, як змінюється значення під час збою.


Банер про втрату з’єднання зазвичай означає проблему з reverse proxy

Редактор n8n підтримує одне довготривале push-з’єднання з бекендом, щоб передавати перебіг виконання на canvas. Типово це WebSocket; його вибирає N8N_PUSH_BACKEND, а значення за замовчуванням — websocket. WebSocket починається як звичайний HTTP-запит із заголовками Connection: Upgrade і Upgrade: websocket. Сервер відповідає 101 Switching Protocols, після чого обидві сторони використовують той самий TCP-сокет у двох напрямках.

Це з’єднання можуть розірвати дві проблеми з проксі. Проксі використовує upstream HTTP/1.0 або видаляє заголовки upgrade, тому перемикання не відбувається, а редактор безперервно підключається повторно. Або перемикання відбувається успішно, але проксі пізніше закриває сокет через відсутність трафіку, оскільки WebSocket без повідомлень виглядає як звичайне неактивне з’єднання. Сам n8n також відхиляє push-з’єднання через помилки автентифікації або перевірки запиту, зокрема через відсутній pushRef або недійсне джерело. Банер означає, що браузер втратив канал. Він не підтверджує справність контейнера.

Перш ніж щось змінювати, перевірте це в браузері. Відкрийте інструменти розробника, перейдіть на вкладку Network, виберіть фільтр WS і перезавантажте редактор. Push-запит має досягти 101 Switching Protocols і залишатися відкритим. Якщо push-запит повертає звичайний код стану або з’являється знову кожні кілька секунд, перевірте його відповідь і журнали n8n на наявність помилок проксі, автентифікації або джерела.

Налаштування nginx, які підтримують підключення редактора

nginx не пересилає upgrade-запит, якщо це явно не налаштувати. Connection і Upgrade — це hop-by-hop заголовки, які nginx видаляє під час пересилання, тому потрібно додати обидва знову. Версія протоколу між nginx і upstream залежить від версії nginx: починаючи з 1.29.7 (March 2026), proxy_pass за замовчуванням використовує HTTP/1.1 для підключення до бекенду, а раніше використовував HTTP/1.0, який взагалі не підтримує upgrade. Виконайте nginx -v, щоб перевірити встановлену версію. Наведена нижче конфігурація явно задає proxy_http_version 1.1, тому працює в обох випадках; у версії 1.29.7 або новішій цей рядок лише повторює значення за замовчуванням. Блок map потрібно розмістити в контексті http, а не всередині server. Якщо решта наведеного нижче server block незрозуміла, у покроковому розборі server block nginx пояснено призначення кожної директиви.

map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}
server {
    listen 443 ssl;
    http2 on;
    server_name n8n.example.com;

    location / {
        proxy_pass http://127.0.0.1:5678;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_read_timeout 3600s;
        proxy_send_timeout 3600s;
        proxy_buffering off;
    }
}

proxy_read_timeout за замовчуванням має значення 60 секунд і також застосовується до WebSocket після upgrade; відлік ведеться між читаннями даних від бекенду. n8n надсилає push ping кожні 60 секунд, тому відсутність активності у workflow instance не означає, що через socket не передаються дані. Збільшення timeout дає цим ping достатньо часу для надходження й запобігає конфлікту зі стандартним timeout; періодичні ping frames також скидають його.

sudo nginx -t && sudo systemctl reload nginx
sudo nginx -T | grep -iE 'proxy_http_version|upgrade|proxy_read_timeout'

nginx -T перевіряє та виводить конфігураційні файли разом із підключеними файлами, а не перевіряє конфігурацію, яку вже завантажив запущений процес. Також переконайтеся, що reload завершився успішно. Якщо конфігурація зберігається у файлі, який не підхоплює рядок include, правильне виправлення не дасть результату.

Потім повідомте n8n, що він працює за proxy, оскільки n8n формує URL на основі цих значень.

environment:
  - N8N_HOST=n8n.example.com
  - N8N_PROTOCOL=https
  - N8N_PORT=5678
  - N8N_PROXY_HOPS=1
  - N8N_WEBHOOK_URL=https://n8n.example.com/

N8N_PROXY_HOPS за замовчуванням має значення 0. Це означає, що n8n вважає адресу підключення адресою клієнта та ігнорує X-Forwarded-For. Встановіть це значення відповідно до кількості proxy перед контейнером. Станом на October 2026 поточною назвою є N8N_WEBHOOK_URL, а старіша WEBHOOK_URL ще працює, але під час запуску виводить попередження про застарілу назву.

Traefik автоматично проксирує WebSocket

Traefik автоматично передає запит на оновлення WebSocket без middleware і додаткових labels. Стандартні HTTP-тайм-аути не встановлюють тайм-аут для WebSocket після оновлення протоколу. Наведені нижче параметри належать до entryPoint: станом на October 2026 у Traefik v3 параметр idleTimeout за замовчуванням має значення 180 seconds для idle HTTP keep-alive-з’єднань, а readTimeout — 60 seconds для читання запиту разом із його body. Тайм-аут запису відповіді явно не поширюється на оновлення протоколу. Цей приклад змінює HTTP-тайм-аути, але не є перевіреним виправленням для WebSocket banner.

entryPoints:
  websecure:
    address: ":443"
    transport:
      respondingTimeouts:
        readTimeout: 0
        idleTimeout: 3600s

Caddy автоматично обробляє оновлення протоколу в reverse_proxy і не потребує для цього жодної директиви. Якщо ви взагалі не можете змінити проксі, оскільки ним керує інша особа, перемкніть push-канал за допомогою N8N_PUSH_BACKEND=sse. SSE (server-sent events) — це звичайна HTTP-відповідь, яку сервер утримує відкритою, тому вона працює через проксі, що відхиляє оновлення протоколу, хоча надто короткий idle timeout усе одно перерве з’єднання. Вибір самого проксі — окреме рішення, а порівняння nginx, Caddy і Traefik описує операційні витрати для кожного з них.

Коли контейнер справді перезапускається

Якщо RestartCount зростає, контейнер завершується з помилкою, а Docker запускає його знову. Зіставте часові позначки в журналі з кожним перезапуском і прочитайте, що відбулося безпосередньо перед ним. Поширені причини: помилка конфігурації, яка перешкоджає запуску, база даних, до якої n8n не може підключитися, аварійне завершення вже запущеного процесу та завершення через нестачу пам’яті.

Почніть із тому, оскільки проблеми з правами доступу часто залишаються непомітними. Офіційний image запускається від непривілейованого користувача node і зберігає дані в /home/node/.n8n. Якщо користувач не має права запису до bind mount, процес завершується з помилкою, коли намагається записати дані, а політика перезапуску може перетворити цю помилку на цикл.

docker compose config
docker run --rm -it --entrypoint sh docker.n8n.io/n8nio/n8n -c 'id'
docker exec n8n ls -ld /home/node/.n8n

Новий named volume успадковує власника каталогу image, коли Docker заповнює його; для наявного тому все одно потрібно перевірити права доступу. Якщо потрібен bind mount, chown каталог на хості до числового ідентифікатора користувача, який вивела команда id. Відповідність власників між хостом і контейнером варто зрозуміти один раз; у поясненні PUID і PGID описано, як ці image визначають, хто записує файли.

Витіснення процесу через нестачу пам’яті, яке виглядає як збій

Для процесу n8n діють дві окремі межі пам’яті, і в разі перевищення вони поводяться по-різному. Ліміт контрольної групи контейнера застосовує ядро: якщо використання досягає ліміту й зменшити його неможливо, ядро викликає OOM killer. Використання пам’яті може тимчасово перевищувати цей ліміт. У разі OOM kill процес не встигає записати фінальний рядок у журнал, а Docker фіксує подію в OOMKilled. Ліміт купи V8 застосовується всередині Node.js: його вичерпання спричиняє критичну помилку купи, і процес завершується без OOM kill з боку ядра. У браузері ці ситуації виглядають однаково. Перегляньте docker inspect разом із журналами, щоб розрізнити їх.

Установіть межу купи Node нижче за ліміт контейнера, залишивши місце для нативних виділень пам’яті, буферів, інших областей купи та інших процесів у контейнері. Вища межа купи збільшує ризик OOM kill з боку ядра до того, як V8 досягне власного ліміту, але не гарантує його: пам’ять може бути звільнена або переміщена у swap, а робоче навантаження може не вичерпати жодну з меж. Нижча межа купи також не гарантує виникнення помилки купи до OOM kill контейнера.

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n
    restart: unless-stopped
    environment:
      - NODE_OPTIONS=--max-old-space-size=<MiB, below the container limit>
    deploy:
      resources:
        limits:
          memory: <your container limit>

Замініть заповнювач межі купи числовим значенням у MiB, використовуючи форму --max-old-space-size=SIZE. Виберіть обидва числа на основі фактичного обсягу пам’яті вашого VPS і залиште запас для бази даних, проксі та операційної системи. docker stats --no-stream виводить поточне використання поруч із чинним лімітом, щоб ви могли перевірити, що встановлений вами ліміт застосував Docker. У розділі Як застосовуються ліміти пам’яті Compose пояснюється, який параметр має перевагу, якщо задано кілька параметрів.

Дані виконання накопичуються під час роботи

Одне виконання містить результат роботи кожного вузла, поки запуск триває. Після цього n8n зберігає ці дані відповідно до параметрів збереження виконань. З цього випливають два наслідки. Обсяг даних і операції, які виконує кожен вузол, впливають на пікове споживання пам’яті. Тому workflow, який одночасно обробляє десять тисяч рядків, відрізняється від такого самого workflow, що обробляє по двісті рядків за раз. Збережена копія також продовжує збільшуватися, доки її не буде видалено.

Очищення вирішує другу проблему. Станом на жовтень 2026 року за замовчуванням очищення увімкнене, EXECUTIONS_DATA_MAX_AGE має значення 336 годин (14 днів), а EXECUTIONS_DATA_PRUNE_MAX_COUNT — 10000. Це достатньо великі значення для невеликого VPS із SQLite, де все зберігається в одному файлі, а той самий процес, який обслуговує редактор, має читати й записувати цей файл.

environment:
  - EXECUTIONS_DATA_PRUNE=true
  - EXECUTIONS_DATA_MAX_AGE=72
  - EXECUTIONS_DATA_PRUNE_MAX_COUNT=1000
  - EXECUTIONS_DATA_SAVE_ON_SUCCESS=none
  - EXECUTIONS_DATA_SAVE_MANUAL_EXECUTIONS=false

EXECUTIONS_DATA_SAVE_ON_SUCCESS=none — агресивний параметр. Він вимикає збереження успішних виконань. Невдалі виконання зберігаються, якщо EXECUTIONS_DATA_SAVE_ON_ERROR залишається зі стандартним значенням all. Окремі параметри workflow можуть змінювати ці налаштування. Визначте потрібну поведінку свідомо. Якщо workflow сформував неправильний результат без помилки, вам не залишиться даних для перевірки. Під час очищення записи спочатку позначаються як видалені, а видаляються під час наступного проходу. SQLite повторно використовує звільнені сторінки, а не повертає їх операційній системі. Тому файл на диску не зменшується одразу після зміни параметра.

Щоб зменшити пікове споживання пам’яті, а не лише обсяг збережених даних, передавайте менше даних за одне виконання. Великі завдання розділяйте на sub-workflow, які повертають батьківському workflow невеликі результати. Для пакетної обробки використовуйте вузол Loop Over Items. Не завантажуйте цілі набори даних у вузол Code.

Бінарні файли не мають зберігатися в пам’яті

N8N_DEFAULT_BINARY_DATA_MODE має значення за замовчуванням default. За такого режиму бінарні дані зберігаються в пам’яті запущеного виконання. Файли, які завантажує workflow, збільшують використання пам’яті. Один workflow, що отримує кілька великих вкладень, може перевищити ліміт, до якого звичайна робота з JSON ніколи не наближається. Тому збій пов’язаний із конкретним workflow, а не з часом роботи процесу.

environment:
  - N8N_DEFAULT_BINARY_DATA_MODE=filesystem

Якщо використовується filesystem, бінарні дані записуються в N8N_BINARY_DATA_STORAGE_PATH. За замовчуванням цей каталог розташований у папці користувача n8n, тому дані потрапляють на той самий том, що й решта файлів. Перед перемиканням перевірте, чи достатньо вільного місця на томі. N8N_PAYLOAD_SIZE_MAX визначає максимальний розмір вхідного payload webhook у MiB (мебібайтах); значення за замовчуванням — 16. Збільшення цього значення дозволяє приймати більші запити, але потребує додаткової пам’яті, яку ви свідомо виділяєте.

Усі інші процеси та сервіси на сервері використовують ту саму оперативну пам’ять. Якщо OOM-завершення почалися після додавання контейнера бази даних, запуск бази даних у Docker або на хості — це компроміс, який тепер потрібно враховувати.

Політика перезапуску та відновлення після перезавантаження

Контейнер без політики перезапуску залишається зупиненим після завершення роботи та після перезавантаження хоста. restart: unless-stopped запускає його знову в обох випадках, але не запускає контейнер, який ви зупинили вручну. restart: always також перезапускає контейнер, зупинений навмисно, під час наступного запуску Docker.

n8n надає health endpoint, назву якого визначає N8N_ENDPOINT_HEALTH. Типове значення — healthz. Спочатку перевірте його з хоста, щоб переконатися, що шлях правильний у вашому екземплярі.

curl -fsS http://127.0.0.1:5678/healthz
docker exec n8n which wget curl
sudo systemctl is-enabled docker

Сам по собі healthcheck нічого не перезапускає. Compose позначає контейнер як unhealthy і на цьому зупиняється; політика перезапуску реагує на завершення роботи контейнера, а для перезапуску контейнера саме через його стан unhealthy потрібен зовнішній watcher. У розділах Створення healthcheck, який справді виконує дію і повторний запуск stack після перезавантаження описано обидві частини.

Воркер, який не запускається, хоча n8n працює

Цей сценарій не створює банер і не запускає перезапуск. Контейнер працює, редактор відкривається, але очікуваний запуск відсутній у списку виконань. Перевірте чотири речі.

  • Workflow не опублікований. Збережіть і опублікуйте workflow із Schedule Trigger, щоб запустити його production-розклад.
  • Вибрано неправильний часовий пояс. Schedule Trigger спочатку використовує часовий пояс workflow, а якщо його не задано — часовий пояс інстансу. GENERIC_TIMEZONE за замовчуванням використовує America/New_York; задайте часовий пояс workflow або змініть часовий пояс інстансу на потрібний.
  • Запуск пропустив grace period. Durable scheduler за замовчуванням увімкнений починаючи з n8n 2.45.0 і записує майбутні запуски в базу даних. Записані запуски виконуються із затримкою після перезапуску, якщо він відбувся в межах grace period; після його завершення політика misfire визначає, чи пропустити запуск, чи створити catch-up запуск. Старий in-memory scheduler пропускає запуски, заплановані під час простою.
  • Workflow було деактивовано автоматично. N8N_WORKFLOW_AUTODEACTIVATION_ENABLED за замовчуванням вимкнений. Якщо його увімкнути, workflow, який постійно завершується з помилкою, буде скасовано, після чого він виглядатиме так само, як workflow, який ніхто ніколи не активував.

Відкрийте список виконань і відфільтруйте його за цим workflow. Запис із помилкою вказує на проблему у workflow. Якщо запуск завершився помилкою 429 під час звернення до іншого сервісу, розміщеного на тому самому сервері, обмеження належить цьому сервісу, а не n8n. У інструкції з діагностики помилки 429 у SearXNG показано, як відрізнити власний rate limiter від механізмів рушіїв, які блокують IP-адресу вашого сервера. Відсутність запису також можлива, якщо збереження виконань вимкнено або запис видалено під час очищення, тому перевірте ці параметри, перш ніж вважати проблему пов’язаною з тригером.

Що змінити спочатку

  1. Перед редагуванням будь-якого файлу прочитайте STATUS, RestartCount і OOMKilled у власному контейнері.
  2. Якщо контейнер залишився запущеним, перевірте доступність n8n і готовність бази даних, а потім перегляньте push-з’єднання на наявність помилок проксі, автентифікації, origin або тайм-ауту.
  3. Якщо OOMKilled має значення true, встановіть ліміт контейнера свідомо, залиште запас нижче цього ліміту під час налаштування граничного розміру heap для Node і перемкніть бінарні дані на filesystem.
  4. Якщо нічого не спрацювало, перевірте, чи опубліковано workflow, чи відповідає його фактичний часовий пояс вашому, а також чи відповідають налаштування планувальника та пропущених запусків вашим очікуванням.

Більшість цих параметрів налаштовують один раз і більше не змінюють поверх робочої інсталяції. Якщо ви ще збираєте цю інсталяцію, інструкція зі встановлення n8n у Docker з HTTPS є базою для цих налаштувань.

FAQ

Чому в редакторі n8n з’являється повідомлення про втрату з’єднання, хоча контейнер працює?

Редактор підтримує відкрите WebSocket-з’єднання для передавання перебігу виконання. Якщо reverse proxy не передає заголовки Connection: Upgrade і Upgrade: websocket або не використовує HTTP/1.1 для upstream-з’єднання, upgrade не завершується, і браузер безперервно повторює підключення, хоча n8n працює нормально. У nginx потрібні обидва рядки proxy_set_header, а також proxy_http_version 1.1 у версіях до 1.29.7 (у новіших версіях HTTP/1.1 використовується за замовчуванням). Збільшення proxy_read_timeout понад стандартне значення 60 секунд дає змогу періодичним ping-запитам n8n вчасно надходити. Самі неактивні workflow не роблять з’єднання idle. n8n також відхиляє некоректні push-запити та помилки автентифікації, тому перевірте відповідь і журнали застосунку. Перевірте конфігураційні файли за допомогою sudo nginx -T і переконайтеся, що reload виконано успішно.

Як відрізнити завершення через нестачу пам’яті від звичайного аварійного завершення?

Виконайте docker inspect n8n | grep -iE 'OOMKilled|ExitCode|RestartCount' і перевірте прапорець OOMKilled. Значення True означає, що Docker зафіксував завершення через нестачу пам’яті. Процес, який було завершено, не встигає записати фінальний рядок у журнал, але попередні журнали контейнера все ще можуть допомогти. Значення False разом із критичною помилкою heap наприкінці docker logs вказує, що Node.js вичерпав heap V8. Задайте NODE_OPTIONS=--max-old-space-size=SIZE числовим значенням у MiB, меншим за ліміт контейнера, і залиште запас для іншого використання пам’яті. Це обмежує old space V8, але не гарантує появу помилки heap до завершення процесу ядром через OOM.

Чи звільняє очищення даних виконань місце на диску одразу?

Ні. EXECUTIONS_DATA_PRUNE позначає старі виконання для видалення, а наступний прохід видаляє їх за розкладом, заданим у EXECUTIONS_DATA_PRUNE_HARD_DELETE_INTERVAL. У SQLite файл також повторно використовує звільнені сторінки, а не повертає їх файловій системі, тому його розмір на диску певний час не змінюється після видалення рядків. Задайте EXECUTIONS_DATA_MAX_AGE і EXECUTIONS_DATA_PRUNE_MAX_COUNT відповідно до ресурсів вашого сервера, а потім перевірте результат наступного дня, а не одразу.

Чому запланований workflow не запустився, коли n8n перезапускався?

Стійкий scheduler, увімкнений за замовчуванням починаючи з n8n 2.45.0, зберігає майбутні запуски в базі даних. Зафіксовані запуски виконуються із запізненням, якщо n8n повертається до роботи протягом дозволеного періоду. Після завершення цього періоду політика misfire тригера визначає, чи пропустити накопичені запуски, чи виконати catch-up запуск. Перевірте версію, конфігурацію scheduler і параметри Schedule Trigger. Примірники, що використовують старіший scheduler у пам’яті, пропускають запуски, заплановані на час простою.

Чи перезапустить healthcheck n8n, якщо він перестане відповідати?

Ні, не сам по собі. healthcheck у Compose лише позначає контейнер як healthy або unhealthy. Політика restart діє, коли контейнер завершує роботу, тому restart: unless-stopped запускає його знову після завершення та після перезавантаження хоста, якщо контейнер не було навмисно зупинено і Docker запущено. Перевірте це за допомогою sudo systemctl is-enabled docker. Щоб реагувати саме на стан unhealthy, потрібен watcher поза Docker, який читає стан і перезапускає сервіс.

Чи була ця стаття корисною?