Хотите автоматизировать рутину — пересылать заявки с сайта в 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.
Важно знать перед началом
Что нужно подготовить
-
- приобрести надежный 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
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 можно приглашать других пользователей.
Проверка: тестовый вебхук
Создадим простейший воркфлоу, который принимает запрос и возвращает полученные данные.
-
- Создайте новый воркфлоу и добавьте узел Webhook.
- Укажите метод
POSTи путь, напримерincoming-webhook. - В параметре Respond выберите When Last Node Finishes — тогда узел вернет данные из последнего выполненного узла.
- Нажмите 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).
- Страница не открывается по адресу http\://IP:5678 — это ожидаемо: порт привязан к
Если воркфлоу будут работать круглосуточно и обрабатывать много запросов, стоит сразу подобрать VPS с запасом оперативной памяти и быстрым SSD/NVMe-диском: от этого зависит скорость выполнения узлов и база данных выполнений.
