Как развернуть 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](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](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](https://n8n.example.com)
DOMAIN_NAME=example.com
SUBDOMAIN=n8n

\# Часовой пояс для узлов с расписанием (cron и т. д.)
GENERIC_TIMEZONE=Europe/Kyiv

\# Почта для регистрации сертификата Let's Encrypt
SSL_EMAIL=admin\@example.com
Вместо 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](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](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](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](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-диском: от этого зависит скорость выполнения узлов и база данных выполнений.

Прокрутить вверх