n8n позволяет собирать автоматизации из готовых узлов: принимать вебхуки, обращаться к API, запускать Telegram-ботов, синхронизировать CRM и таблицы, обрабатывать документы и подключать AI-сервисы. Платформу можно разместить на собственном VPS и контролировать данные, обновления и доступ к интеграциям самостоятельно.
Но production-установка — это не просто контейнер, открытый на порту 5678. Публичному экземпляру нужны HTTPS, постоянное хранилище, резервное копирование, защищённая база данных и понятный порядок обновления.
В этой инструкции развернём n8n 2.x на Ubuntu 24.04 по следующей схеме:
Интернет
│
▼
Nginx: 80/443, HTTPS
│
▼
n8n: 127.0.0.1:5678
│
▼
PostgreSQL во внутренней сети Docker
Порт PostgreSQL не будет опубликован в интернет, а n8n будет доступен снаружи только через Nginx и HTTPS.
Важно: статья рассчитана на читателя, который умеет подключаться по SSH и понимает основы Linux. Перед вводом команд проверьте имена интерфейсов, SSH-порт, DNS и действующие правила firewall. Ошибка в сетевых настройках может закрыть доступ к серверу.
Какой VPS нужен для n8n
У n8n нет одной универсальной конфигурации: потребление ресурсов зависит от числа одновременных выполнений, используемых узлов, размера входных данных и наличия локальных AI-моделей или браузерной автоматизации.
Для личных сценариев без тяжёлой обработки обычно важнее не большое число ядер, а стабильная работа 24/7, запас оперативной памяти и NVMe-диск. Для production-развёртывания следует учитывать ресурсы не только n8n, но и PostgreSQL, Nginx, Docker и самой операционной системы.
Для описанной конфигурации подходит обычный VPS Start от Cheap-Host:
- 6 vCPU Intel Xeon;
- 8 ГБ RAM;
- 96 ГБ NVMe;
- выделенный IPv4;
- безлимитный трафик и канал 100 Мбит/с;
- локация — Москва.
Такой объём ресурсов оставляет запас для нескольких параллельных автоматизаций, базы данных и истории выполнений. Это не гарантированный предел нагрузки: реальную ёмкость сервера нужно определять по метрикам конкретных workflows.
Почему для production лучше VPS с выделенным IPv4
n8n часто принимает внешние webhook-запросы и OAuth callback от Telegram, GitHub, CRM, платёжных систем и других сервисов. Для этого удобнее домен, направленный на выделенный IPv4, и стандартный HTTPS-порт 443.
На NAT VPS используется общий IPv4 и выделенный диапазон входящих портов. Такой сервер может подойти для исходящих автоматизаций, тестов или сценариев по расписанию, но усложняет публикацию стандартного HTTPS endpoint. Подробное сравнение есть в статье «NAT VPS или обычный VPS».
Что понадобится
Перед началом подготовьте:
- VPS с Ubuntu 24.04 и доступом по SSH.
- Домен или поддомен, например
n8n.example.com. - DNS-запись типа
A, направленную на выделенный IPv4 сервера. - Открытые входящие порты
80/tcpи443/tcp. - Действующий SSH-доступ с правами
sudo.
Проверьте DNS с локального компьютера:
nslookup n8n.example.com
В ответе должен появиться IP вашего VPS. Выпуск TLS-сертификата стоит начинать только после обновления DNS.
Первичная подготовка Ubuntu
Подключитесь к серверу незащищённой учётной записью root только для первичной настройки либо используйте пользователя с sudo:
ssh username@SERVER_IP
Обновите пакеты:
sudo apt update
sudo apt upgrade -y
Перед дальнейшей настройкой рекомендуется выполнить базовый чек-лист: создать отдельного администратора, настроить вход по SSH-ключам, запретить парольный вход после проверки ключа и включить автоматические security-обновления. Эти действия разобраны в инструкции «Первые 10 шагов после покупки VPS».
Установка Docker Engine и Docker Compose
Для production лучше использовать официальный APT-репозиторий Docker. Скрипт get.docker.com удобен для тестов, но сама Docker Documentation не рекомендует convenience script для production-систем.
Удалите конфликтующие пакеты, если они установлены:
sudo apt remove -y docker.io docker-compose docker-compose-v2 docker-doc docker-buildx podman-docker containerd runc
Добавьте официальный ключ и репозиторий:
sudo apt update
sudo apt install -y ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
-o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
sudo tee /etc/apt/sources.list.d/docker.sources > /dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF
sudo apt update
Установите Docker Engine и Compose plugin:
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
Проверьте установку:
sudo systemctl status docker --no-pager
sudo docker run --rm hello-world
sudo docker compose version
В этой статье команды Docker выполняются через sudo. Добавление пользователя в группу docker фактически даёт ему привилегии уровня root, поэтому не делайте этого без понимания последствий.
Развёртывание n8n и PostgreSQL
Создайте отдельный каталог проекта:
sudo mkdir -p /opt/n8n/local-files
sudo chown -R "$USER":"$USER" /opt/n8n
cd /opt/n8n
Каталог local-files будет единственной директорией хоста, к которой файловые узлы n8n получат доступ.
Создание секретов
Сгенерируйте пароль PostgreSQL и ключ шифрования n8n:
openssl rand -hex 32
openssl rand -hex 32
Команды выведут две разные строки. Первую используйте как POSTGRES_PASSWORD, вторую — как N8N_ENCRYPTION_KEY.
Создайте /opt/n8n/.env:
N8N_VERSION=2.31.6
N8N_HOST=n8n.example.com
GENERIC_TIMEZONE=Europe/Moscow
POSTGRES_DB=n8n
POSTGRES_USER=n8n
POSTGRES_PASSWORD=ЗАМЕНИТЕ_ПЕРВОЙ_СЛУЧАЙНОЙ_СТРОКОЙ
N8N_ENCRYPTION_KEY=ЗАМЕНИТЕ_ВТОРОЙ_СЛУЧАЙНОЙ_СТРОКОЙ
На момент подготовки статьи актуальной stable-версией в официальной документации была 2.31.6. Перед установкой проверьте текущий stable-релиз и замените значение при необходимости. Для production лучше указывать конкретную версию, а не плавающий тег latest.
Ограничьте доступ к файлу:
chmod 600 /opt/n8n/.env
Критично: сохраните
N8N_ENCRYPTION_KEYв защищённом хранилище вне VPS. Если потерять ключ после аварии, восстановленная база может содержать credentials, которые n8n уже не сможет расшифровать.
Compose-конфигурация
Создайте /opt/n8n/compose.yaml:
services:
postgres:
image: postgres:17-alpine
restart: unless-stopped
environment:
POSTGRES_DB: ${POSTGRES_DB}
POSTGRES_USER: ${POSTGRES_USER}
POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
volumes:
- postgres_data:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
interval: 10s
timeout: 5s
retries: 10
networks:
- backend
n8n:
image: docker.n8n.io/n8nio/n8n:${N8N_VERSION}
restart: unless-stopped
ports:
- "127.0.0.1:5678:5678"
environment:
DB_TYPE: postgresdb
DB_POSTGRESDB_HOST: postgres
DB_POSTGRESDB_PORT: 5432
DB_POSTGRESDB_DATABASE: ${POSTGRES_DB}
DB_POSTGRESDB_USER: ${POSTGRES_USER}
DB_POSTGRESDB_PASSWORD: ${POSTGRES_PASSWORD}
N8N_HOST: ${N8N_HOST}
N8N_PORT: 5678
N8N_PROTOCOL: https
WEBHOOK_URL: https://${N8N_HOST}/
N8N_PROXY_HOPS: 1
NODE_ENV: production
GENERIC_TIMEZONE: ${GENERIC_TIMEZONE}
TZ: ${GENERIC_TIMEZONE}
N8N_ENCRYPTION_KEY: ${N8N_ENCRYPTION_KEY}
N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS: "true"
N8N_RESTRICT_FILE_ACCESS_TO: /files
N8N_SSRF_PROTECTION_ENABLED: "true"
EXECUTIONS_DATA_PRUNE: "true"
EXECUTIONS_DATA_MAX_AGE: 336
EXECUTIONS_DATA_PRUNE_MAX_COUNT: 10000
volumes:
- n8n_data:/home/node/.n8n
- ./local-files:/files
depends_on:
postgres:
condition: service_healthy
networks:
- backend
networks:
backend:
volumes:
n8n_data:
name: n8n_data
postgres_data:
name: n8n_postgres_data
Здесь важны несколько решений:
- PostgreSQL находится только во внутренней сети Docker — у него нет секции
ports. - n8n привязан к
127.0.0.1, поэтому порт5678недоступен напрямую извне. - Каталог
/home/node/.n8nсохраняется даже при использовании PostgreSQL: в нём остаются важные данные экземпляра. - Файловый доступ workflows ограничен каталогом
/files. - Включена SSRF-защита для исходящих HTTP-запросов.
- Старые записи выполнений автоматически очищаются по возрасту и количеству.
Проверьте итоговую конфигурацию без запуска:
cd /opt/n8n
sudo docker compose config --quiet
Запустите контейнеры:
sudo docker compose up -d
sudo docker compose ps
Посмотрите журналы n8n:
sudo docker compose logs --tail=100 n8n
Проверьте локальный endpoint:
curl -I http://127.0.0.1:5678
На этом этапе n8n работает, но публичный HTTPS ещё не настроен.
Настройка Nginx и HTTPS
Установите Nginx и Certbot:
sudo apt install -y nginx certbot python3-certbot-nginx
Если Nginx вам незнаком, сначала прочитайте отдельную инструкцию по установке и базовой настройке Nginx на Ubuntu 24.04.
Создайте /etc/nginx/sites-available/n8n и замените домен:
server {
listen 80;
listen [::]:80;
server_name n8n.example.com;
client_max_body_size 16m;
location / {
proxy_pass http://127.0.0.1:5678;
proxy_http_version 1.1;
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_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_read_timeout 300s;
proxy_send_timeout 300s;
proxy_buffering off;
}
}
Активируйте конфигурацию:
sudo ln -s /etc/nginx/sites-available/n8n /etc/nginx/sites-enabled/n8n
sudo nginx -t
sudo systemctl reload nginx
Если на сервере уже существует такая символическая ссылка, повторно создавать её не нужно.
Firewall без потери SSH-доступа
Сначала посмотрите, какой SSH-порт реально используется:
sudo sshd -T | grep '^port '
Разрешите этот порт до включения UFW. Для стандартного SSH это можно сделать так:
sudo ufw allow OpenSSH
sudo ufw allow 'Nginx Full'
sudo ufw enable
sudo ufw status verbose
Если SSH работает не на порту 22, создайте отдельное правило для фактического порта до команды ufw enable.
Docker предупреждает, что опубликованные контейнерные порты могут обходить обычные правила UFW. В нашей конфигурации n8n опубликован только на loopback-адресе, а PostgreSQL не опубликован вовсе. Не заменяйте привязку 127.0.0.1:5678:5678 на 5678:5678 без необходимости.
Получение сертификата
Убедитесь, что DNS уже указывает на VPS, затем запустите:
sudo certbot --nginx -d n8n.example.com
Certbot получит сертификат и обновит конфигурацию Nginx. Проверьте автоматическое продление:
sudo certbot renew --dry-run
После этого откройте:
https://n8n.example.com
Зарегистрируйте владельца экземпляра и используйте уникальный длинный пароль.
Проверка webhook
В интерфейсе n8n создайте тестовый workflow с узлом Webhook. У него есть два разных адреса:
- test URL — используется при ручной проверке в редакторе;
- production URL — работает у опубликованного workflow.
Проверьте, что production URL начинается с вашего публичного домена:
https://n8n.example.com/webhook/...
Если n8n показывает http, локальный адрес или неправильный домен, перепроверьте WEBHOOK_URL, N8N_HOST, N8N_PROTOCOL, N8N_PROXY_HOPS и заголовок X-Forwarded-Proto в Nginx.
Усиление безопасности n8n 2.x
n8n 2.x получил более строгие настройки по умолчанию. В частности, выполнение кода из Code node изолируется task runners, доступ к переменным окружения из Code node заблокирован по умолчанию, а потенциально опасные ExecuteCommand и LocalFileTrigger отключены.
Не отменяйте эти ограничения «на всякий случай». Если workflow требует опасной функции, сначала определите минимальное исключение и оцените, какой доступ получит пользователь такого workflow к серверу.
SSRF-защита
SSRF позволяет заставить сервер выполнить HTTP-запрос к внутреннему сервису, metadata endpoint или localhost. Начиная с n8n 2.12.0 доступна встроенная дополнительная защита:
N8N_SSRF_PROTECTION_ENABLED=true
Она уже включена в приведённом Compose-файле. По умолчанию блокируются loopback, частные, link-local и некоторые зарезервированные диапазоны.
Это может затронуть workflows, которым действительно нужен HTTP-доступ к внутренним контейнерам. Не отключайте защиту целиком: используйте точечный allowlist только для контролируемого hostname или диапазона. Помните, что hostname allowlist имеет приоритет над блокировкой IP, поэтому добавлять чужие или пользовательские домены туда нельзя.
Ограничение публичного API и узлов
Если публичный API n8n не используется, отключите его согласно актуальной документации. Для экземпляров с несколькими пользователями также следует:
- включить двухфакторную аутентификацию;
- выдавать доступ только тем, кому он необходим;
- запрещать неиспользуемые рискованные и community nodes;
- не сохранять секреты в Code node и обычных полях workflow;
- периодически просматривать активные credentials и удалять неиспользуемые.
Встроенный аудит
Запустите security audit из контейнера:
cd /opt/n8n
sudo docker compose exec n8n n8n audit
Отчёт проверяет credentials, SQL-выражения, файловые узлы, потенциально рискованные nodes, незащищённые webhooks, отсутствующие security-настройки и устаревшую версию экземпляра.
Аудит не заменяет firewall, обновления ОС, контроль доступа и анализ собственных workflows.
Как не заполнить NVMe историей выполнений
n8n хранит данные выполнений и может постепенно увеличивать PostgreSQL и файловое хранилище. В актуальной документации pruning включён по умолчанию. Стандартные ограничения — 336 часов, то есть 14 дней, и 10 000 завершённых выполнений.
В Compose-файле это задано явно:
EXECUTIONS_DATA_PRUNE: "true"
EXECUTIONS_DATA_MAX_AGE: 336
EXECUTIONS_DATA_PRUNE_MAX_COUNT: 10000
Эти значения нельзя считать универсальными. Если историю необходимо хранить дольше по бизнес-требованиям, оцените объём данных и увеличьте диск. Если важны только ошибки, настройте сохранение успешных выполнений на уровне workflow или через переменные окружения.
Выполнения в статусах new, running и waiting не удаляются как завершённые. Отслеживайте зависшие сценарии отдельно.
Полезные команды контроля:
df -h
sudo docker system df
sudo docker compose exec postgres psql -U n8n -d n8n -c "SELECT pg_size_pretty(pg_database_size('n8n'));"
Не запускайте автоматическую очистку Docker volumes: volume содержит рабочие данные.
Резервное копирование
Production-бэкап должен включать как минимум:
- дамп PostgreSQL;
- volume
n8n_data; - исходный
N8N_ENCRYPTION_KEY; - файлы
.env,compose.yamlи конфигурацию Nginx; - файлы из
/opt/n8n/local-files, если их используют workflows.
Создайте каталог, доступный только администратору:
sudo install -d -m 700 /var/backups/n8n
Дамп PostgreSQL
cd /opt/n8n
sudo docker compose exec -T postgres \
pg_dump -U n8n -d n8n \
| gzip | sudo tee "/var/backups/n8n/postgres-$(date +%F-%H%M).sql.gz" > /dev/null
Архив данных n8n
BACKUP_FILE="n8n-data-$(date +%F-%H%M).tar.gz"
sudo docker run --rm \
-v n8n_data:/source:ro \
-v /var/backups/n8n:/backup \
alpine \
tar -czf "/backup/${BACKUP_FILE}" -C /source .
Сохраните .env отдельно в зашифрованном хранилище. Простая копия файла в тот же каталог на том же VPS не защищает от компрометации или потери сервера.
Переносите резервные копии на независимое хранилище и настройте ограниченный срок хранения. Самое важное — регулярно проверять восстановление на отдельном тестовом VPS. Архив, который никто не пробовал восстановить, нельзя считать надёжным бэкапом.
Быстрая проверка дампа в отдельной базе
Создайте временную БД внутри того же PostgreSQL только для проверки синтаксической целостности дампа:
cd /opt/n8n
sudo docker compose exec -T postgres createdb -U n8n n8n_restore_test
sudo gunzip -c /var/backups/n8n/ИМЯ_ДАМПА.sql.gz \
| sudo docker compose exec -T postgres psql -U n8n -d n8n_restore_test
sudo docker compose exec -T postgres dropdb -U n8n n8n_restore_test
Такая проверка не доказывает полное восстановление n8n. Полный тест должен выполняться в изолированном окружении с копией n8n_data и тем же ключом шифрования.
Безопасное обновление n8n
Не обновляйте production автоматически сразу после появления нового образа. n8n выпускает minor-версии часто, а major-обновления могут менять поведение workflows.
Порядок обновления:
- Прочитать release notes и migration guide.
- Создать бэкап PostgreSQL и
n8n_data. - Проверить новую версию на тестовом экземпляре.
- Изменить
N8N_VERSIONв/opt/n8n/.env. - Скачать образ и пересоздать только нужные контейнеры.
- Проверить UI, журналы, webhooks, OAuth и ключевые workflows.
Команды:
cd /opt/n8n
sudo docker compose pull n8n
sudo docker compose up -d
sudo docker compose ps
sudo docker compose logs --tail=200 n8n
После обновления повторно запустите:
sudo docker compose exec n8n n8n audit
Простой возврат старого тега образа может не сработать после миграции базы данных. Для надёжного отката может потребоваться восстановление предварительного дампа.
Когда нужны Redis и queue mode
Описанная схема запускает один экземпляр n8n и подходит для небольших и средних workloads. Не стоит заранее усложнять её Redis и несколькими workers.
Queue mode нужен, когда один процесс перестаёт справляться с параллельными выполнениями или требуется горизонтальное масштабирование. В официальной архитектуре:
- основной экземпляр принимает triggers и webhooks;
- Redis хранит очередь идентификаторов выполнений;
- workers забирают задания;
- данные и результаты читаются и записываются в общую PostgreSQL;
- Redis уведомляет основной процесс о завершении.
Для queue mode n8n рекомендует PostgreSQL 13 или новее. Распределённая схема с SQLite не поддерживается. Все main, worker и webhook-процессы должны использовать один N8N_ENCRYPTION_KEY и иметь доступ к общей БД и Redis.
Не переходите к queue mode только потому, что он выглядит «более production». Сначала измерьте:
- среднее и пиковое число одновременных выполнений;
- время ожидания в очереди;
- загрузку CPU и RAM;
- число соединений PostgreSQL;
- объём binary data;
- задержку webhook-ответов.
Частые ошибки
n8n открывается по IP, но не по домену
Проверьте запись A, server_name в Nginx и доступность портов 80/443. DNS может обновляться не мгновенно.
Certbot не может выпустить сертификат
Обычно причина — неверный DNS, закрытый порт 80, другой сервис на порту или проксирование домена через внешнюю CDN с некорректным режимом TLS.
В webhook указан localhost
Проверьте WEBHOOK_URL=https://n8n.example.com/, N8N_HOST, N8N_PROTOCOL, N8N_PROXY_HOPS=1 и forwarded-заголовки Nginx.
PostgreSQL недоступен
Посмотрите состояние и healthcheck:
sudo docker compose ps
sudo docker compose logs --tail=100 postgres
Убедитесь, что DB_POSTGRESDB_HOST равен имени сервиса postgres, а не localhost.
Контейнер постоянно перезапускается
Проверьте журналы, права volume, .env и доступное место:
sudo docker compose logs --tail=200 n8n
df -h
Workflow не может обратиться к внутреннему HTTP-сервису
Возможная причина — SSRF-защита. Не выключайте её вслепую: добавьте минимальное разрешение для контролируемого адреса и убедитесь, что через него нельзя обращаться к произвольным внутренним ресурсам.
FAQ
Можно ли установить n8n без Docker?
Можно, но официальный проект рекомендует Docker для большинства self-hosted установок: контейнер упрощает изоляцию, обновления и управление зависимостями. Для VPS без графической оболочки достаточно Docker Engine и Compose plugin.
Обязательно ли использовать PostgreSQL?
Для первого теста n8n может работать с SQLite. Для экземпляра, который принимает production-webhooks и хранит важные credentials, PostgreSQL даёт более понятную основу для резервного копирования и дальнейшего масштабирования. Queue mode следует строить с PostgreSQL, а не SQLite.
Нужен ли домен?
Для локального теста — нет. Для публичных webhooks, OAuth и нормального HTTPS домен или поддомен практически необходим.
Можно ли открыть порт 5678 напрямую?
Технически можно, но для production безопаснее привязать его к 127.0.0.1 и публиковать n8n через reverse proxy с TLS. Это также упрощает работу внешних интеграций на стандартном порту 443.
Можно ли размещать n8n на NAT VPS?
Для исходящих задач и тестов — иногда да. Для публичного production-экземпляра с webhook и OAuth удобнее обычный VPS с выделенным IPv4 и стандартными портами.
Сколько workflows выдержит VPS?
По одному числу workflows определить нагрузку невозможно. Один сценарий может раз в день отправлять короткий запрос, другой — параллельно обрабатывать крупные файлы или запускать код. Ориентируйтесь на число одновременных выполнений, длительность, RAM, CPU, диск и скорость роста PostgreSQL.
Итог
Надёжная установка n8n на VPS состоит не из одного контейнера, а из нескольких обязательных слоёв:
- n8n 2.x с закреплённой версией;
- PostgreSQL без публичного порта;
- Nginx и HTTPS;
- постоянный volume и сохранённый ключ шифрования;
- SSRF-защита и ограниченный файловый доступ;
- pruning истории выполнений;
- внешние резервные копии и проверка восстановления;
- контролируемые обновления после чтения release notes.
Для такой схемы можно использовать VPS Start от Cheap-Host с выделенным IPv4, 8 ГБ RAM и 96 ГБ NVMe. Сервер выдаётся с root-доступом, поэтому конфигурацию Docker, Nginx, PostgreSQL и правила обновления можно контролировать самостоятельно.