Як розгорнути n8n на VPS з Ubuntu, Debian чи AlmaLinux через Docker Compose

Хочете автоматизувати рутину — пересилати заявки з сайту в CRM, надсилати сповіщення в Telegram, збирати дані з різних сервісів — і не платити за кожну виконану задачу? n8n можна встановити на власний сервер. У цій статті розглянемо, як розгорнути n8n на VPS з Ubuntu, Debian чи AlmaLinux через Docker Compose, з автоматичним HTTPS від Let’s Encrypt, і перевіримо роботу на тестовому вебхуку. Для роботи підійде навіть недорогий VPS на NVMe дисках.

Що таке n8n

n8n — це платформа для автоматизації робочих процесів з візуальним редактором, яку можна запустити на власному сервері. Ідея схожа на Zapier чи Make: ви з’єднуєте сервіси «блоками» (вузлами), і дані автоматично переходять від одного до іншого. Різниця в тому, що n8n працює у вас, тому дані лишаються під вашим контролем.

n8n поширюється за fair-code-ліцензією: вихідний код доступний, але умови відрізняються від класичних open-source ліцензій, тож перед комерційним використанням варто прочитати ліцензію проєкту.

Типові сценарії:

  • вебхук із форми на сайті → обробка даних → запис у CRM чи таблицю;
  • за розкладом (cron) → запит до API → сповіщення в Slack чи Telegram;
  • подія в базі даних → лист або повідомлення відповідальній людині;
  • замовлення в платіжній системі → формування документа → лист клієнту;
  • власні конвеєри перенесення даних між системами.

Складну логіку (розгалуження, цикли, обробку помилок) можна описувати вбудованим вузлом Code, у якому підтримуються JavaScript і Python.

Важливо знати перед початком

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

Що потрібно підготувати

  • придбати надійнйи VPS з Ubuntu 22.04/24.04, Debian 12 або AlmaLinux 8/9 і доступом sudo;
  • домен і окремий піддомен для n8n (наприклад, n8n.ваш-домен.com);
  • вільні порти 80 і 443 (їх використовує Traefik для HTTPS-сертифіката);
  • реальна електронна пошта для реєстрації сертифіката Let’s Encrypt.

Крок 1. Встановіть Docker і Docker Compose

Debian / Ubuntu:

curl -fsSL https://get.docker.com | sudo sh
sudo usermod -aG docker $USER

AlmaLinux:

sudo dnf install -y dnf-plugins-core nano wget
sudo dnf -y remove httpd
sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo dnf install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
sudo systemctl enable --now docker
sudo usermod -aG docker $USER

Перелогіньтесь (або виконайте newgrp docker) і перевірте версії:

docker --version
docker compose version

Крок 2. Створіть DNS-запис

У панелі керування доменом додайте A-запис для піддомену:

Тип Ім’я Значення
A n8n (або інший піддомен) IP-адреса вашого сервера

Дочекайтесь, поки запис почне працювати: без нього Let’s Encrypt не видасть сертифікат.

Крок 3. Підготуйте каталог і файл .env

cd /home/
mkdir n8n-compose
cd n8n-compose
mkdir local-files
nano .env

Каталог local-files призначений для обміну файлами між n8n і сервером (наприклад, для вузла читання й запису файлів). Створіть його вручну, щоб він мав правильні права.

У файл .env впишіть свої значення:

# Домен і піддомен разом дають адресу https://n8n.example.com
DOMAIN_NAME=example.com
SUBDOMAIN=n8n

# Часовий пояс для вузлів з розкладом (cron тощо)
GENERIC_TIMEZONE=Europe/Kyiv

# Пошта для реєстрації сертифіката Let's Encrypt
[email protected]
Замість example.com  використовуйте Ваш реальний домен

Крок 4. Створіть файл compose.yaml

nano compose.yaml

Вставте конфігурацію з офіційної документації n8n:

services:
  traefik:
    image: "traefik"
    restart: always
    command:
      - "--api.insecure=true"
      - "--providers.docker=true"
      - "--providers.docker.exposedbydefault=false"
      - "--entrypoints.web.address=:80"
      - "--entrypoints.web.http.redirections.entryPoint.to=websecure"
      - "--entrypoints.web.http.redirections.entrypoint.scheme=https"
      - "--entrypoints.websecure.address=:443"
      - "--certificatesresolvers.mytlschallenge.acme.tlschallenge=true"
      - "--certificatesresolvers.mytlschallenge.acme.email=${SSL_EMAIL}"
      - "--certificatesresolvers.mytlschallenge.acme.storage=/letsencrypt/acme.json"
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - traefik_data:/letsencrypt
      - /var/run/docker.sock:/var/run/docker.sock:ro

  n8n:
    image: n8nio/n8n
    restart: always
    ports:
      - "127.0.0.1:5678:5678"
    labels:
      - traefik.enable=true
      - traefik.http.routers.n8n.rule=Host(`${SUBDOMAIN}.${DOMAIN_NAME}`)
      - traefik.http.routers.n8n.tls=true
      - traefik.http.routers.n8n.entrypoints=web,websecure
      - traefik.http.routers.n8n.tls.certresolver=mytlschallenge
      - traefik.http.middlewares.n8n.headers.SSLRedirect=true
      - traefik.http.middlewares.n8n.headers.STSSeconds=315360000
      - traefik.http.middlewares.n8n.headers.browserXSSFilter=true
      - traefik.http.middlewares.n8n.headers.contentTypeNosniff=true
      - traefik.http.middlewares.n8n.headers.forceSTSHeader=true
      - traefik.http.middlewares.n8n.headers.SSLHost=${DOMAIN_NAME}
      - traefik.http.middlewares.n8n.headers.STSIncludeSubdomains=true
      - traefik.http.middlewares.n8n.headers.STSPreload=true
      - traefik.http.routers.n8n.middlewares=n8n@docker
    environment:
      - N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true
      - N8N_HOST=${SUBDOMAIN}.${DOMAIN_NAME}
      - N8N_PORT=5678
      - N8N_PROTOCOL=https
      - NODE_ENV=production
      - N8N_WEBHOOK_URL=https://${SUBDOMAIN}.${DOMAIN_NAME}/
      - GENERIC_TIMEZONE=${GENERIC_TIMEZONE}
      - TZ=${GENERIC_TIMEZONE}
      - N8N_RESTRICT_FILE_ACCESS_TO=/files
    volumes:
      - n8n_data:/home/node/.n8n
      - ./local-files:/files

volumes:
  n8n_data:
  traefik_data:

Що тут важливо:

  • Конфігурація запускає два контейнери: n8n і Traefik — проксі, який керує HTTPS-сертифікатами та маршрутизацією.
  • Порт n8n прив’язано до 127.0.0.1:5678, тобто напряму ззовні він недоступний — лише через Traefik.
  • Змінна N8N_WEBHOOK_URL доступна з версії n8n 2.30.0. На ранніх версіях замість неї використовуйте WEBHOOK_URL.
  • Том n8n_data зберігає базу даних SQLite та ключ шифрування n8n, а traefik_data — дані сертифікатів.

Крок 5. Відкрийте порти фаєрвола

Переконайтесь, що порти 80 і 443 доступні ззовні.

Ubuntu/Debian (UFW):

sudo ufw allow 80/tcp
sudo ufw allow 443/tcp

AlmaLinux (firewalld):

sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo firewall-cmd --reload
AlmaLinux і зона docker. Якщо порти відкриті, а сайт не відкривається, перевірте, до якої зони firewalld прив’язані інтерфейси: sudo firewall-cmd --get-active-zones. Коли там значиться docker, правила із зони public до вхідного трафіку не застосовуються — відкрийте порти в зоні docker: sudo firewall-cmd --zone=docker --add-port=80/tcp --permanent && sudo firewall-cmd --zone=docker --add-port=443/tcp --permanent && sudo firewall-cmd --reload.

Крок 6. Запустіть n8n

docker compose up -d
docker compose ps

Обидва сервіси мають бути в стані running. Для перевірки логів:

docker compose logs -f

Через хвилину-дві відкрийте в браузері https://n8n.ваш-домен.com. Перший запуск може бути трохи повільнішим: у цей час Traefik отримує сертифікат.

Важливо: Якщо docker compose up -d видає помилку “cannot allocate memory” виконайте спочатку docker pull n8nio/n8n, а потім знову  docker compose up -d

Крок 7. Створіть обліковий запис власника

Під час першого входу n8n покаже екран реєстрації:

Введіть свої дані та пароль: він має містити щонайменше вісім символів, серед яких принаймні одна цифра й одна велика літера. Після натискання Next ви автоматично увійдете як власник (owner) інстансу. Далі в налаштуваннях у розділі Users можна запрошувати інших користувачів.

Перевірка: тестовий вебхук

Створимо найпростіший воркфлоу, який приймає запит і повертає отримані дані.

  1. Створіть новий воркфлоу й додайте вузол Webhook.
  2. Вкажіть метод POST та шлях, наприклад incoming-webhook.
  3. У параметрі Respond оберіть When Last Node Finishes — тоді вузол поверне дані з останнього виконаного вузла.
  4. Натисніть Listen for Test Event (або виконайте воркфлоу) і надішліть тестовий запит на тестову адресу:
curl -X POST https://n8n.ваш-домен.com/webhook-test/incoming-webhook \
  -H "Content-Type: application/json" \
  -d '{"name":"Test","project":"Webhook check"}'

У відповіді ви побачите дані запиту, а в редакторі — виконання вузла. Коли все працює, опублікуйте (активуйте) воркфлоу — після цього стане доступною виробнича адреса:

curl -X POST https://n8n.ваш-домен.com/webhook/incoming-webhook \
  -H "Content-Type: application/json" \
  -d '{"name":"Test","project":"Webhook check"}'
Різниця між адресами: тестова (/webhook-test/...) реєструється лише поки ви слухаєте тестову подію в редакторі й показує дані у воркфлоу. Виробнича (/webhook/...) реєструється після публікації воркфлоу й дані в редакторі не показує — їх видно у вкладці виконань (Executions). У зовнішніх сервісах завжди вказуйте виробничу адресу.

Параметр Respond впливає на відповідь: режим Immediately повертає лише повідомлення Workflow got started, а Using ‘Respond to Webhook’ Node дозволяє сформувати відповідь окремим вузлом Respond to Webhook.

Резервне копіювання

Усі воркфлоу, облікові дані та налаштування лежать у томі n8n_data: там зберігаються база SQLite і ключ шифрування n8n. Тому резервна копія має містити весь том. Для узгодженості бази на час копіювання краще зупинити n8n:

docker volume ls | grep n8n_data
docker compose stop n8n
docker run --rm -v n8n-compose_n8n_data:/data -v $(pwd):/backup alpine tar czf /backup/n8n-backup.tar.gz -C /data .
docker compose start n8n

Назва тому складається з імені каталогу проєкту та назви тому (n8n-compose_n8n_data), якщо ви розгортали n8n в каталозі n8n-compose. Точну назву покаже команда docker volume ls. Зберігайте архів поза сервером.

Оновлення n8n

Розробники випускають нову мінорну версію n8n майже щотижня. У документації розрізняються версії stable (для продакшену) та beta (найновіша, може бути нестабільною). Перед оновленням завжди робіть резервну копію, а потім:

docker compose pull
docker compose up -d

Типові помилки

  • Сторінка не відкривається за http://IP:5678 — це очікувано: порт прив’язано до 127.0.0.1, а n8n у цій схемі працює лише через HTTPS. Використовуйте https://n8n.ваш-домен.com.
  • failed to bind host port 0.0.0.0:80/tcp: address already in use – на порту 80 вже є запущений процесс. Перевірити можна командами sudo ss -ltnp | grep ':80 ' або sudo lsof -i :80 . Найчастіше це системний Nginx або Apache (httpd).
  • contact email has forbidden domain “example.org” — у SSL_EMAIL залишилась пошта-заглушка. Вкажіть справжню адресу й перестворіть контейнер Traefik.
  • Сертифікат не видається — перевірте DNS-запис піддомену, відкриті порти 80 і 443 та логи Traefik: docker compose logs traefik.
  • 404 на виробничому вебхуку — воркфлоу не опубліковано, або ви використовуєте тестову адресу поза режимом прослуховування.
  • У відповіді вебхука лише «Workflow got started» — у параметрі Respond вибрано Immediately. Змініть на When Last Node Finishes або Respond to Webhook.
  • Налаштування N8N_BASIC_AUTH_* не діють — Basic Auth прибрано з n8n 1.0, використовується обліковий запис власника.
  • Сайт не відкривається на AlmaLinux при відкритих портах — перевірте зону docker у firewalld (див. Крок 5).

Якщо воркфлоу працюватимуть цілодобово й оброблятимуть багато запитів, варто одразу підібрати VPS із запасом оперативної пам’яті та швидким SSD/NVMe-диском: від цього залежить швидкість виконання вузлів і база даних виконань.

Прокрутка до верху