Перейти к содержимому

Статья 84 из 141

Гайды

Установка n8n на VPS: Docker Compose, домен и HTTPS

n8n — конструктор автоматизаций: связывает Telegram, Google Таблицы, CRM, почту и API в цепочки без кода. Своя копия на VPS не ограничивает число запусков и хранит данные у вас.

  • VPS с 2 ГБ RAM и больше. На 1 ГБ n8n запустится, но тяжёлые сценарии будут падать по памяти.
  • Домен или поддомен, например n8n.example.com, с A-записью на IP сервера (настройка DNS).
  • Docker и Docker Compose: установка Docker.

Домен с HTTPS обязателен: без него не будут работать вебхуки от внешних сервисов, а браузер не даст войти из-за защищённых cookie.

Создайте каталог и файл:

Окно терминала
mkdir -p /opt/n8n && cd /opt/n8n
nano docker-compose.yml
services:
n8n:
image: docker.n8n.io/n8nio/n8n
restart: unless-stopped
ports:
- "127.0.0.1:5678:5678"
environment:
- N8N_HOST=n8n.example.com
- N8N_PROTOCOL=https
- WEBHOOK_URL=https://n8n.example.com/
- GENERIC_TIMEZONE=Europe/Moscow
- TZ=Europe/Moscow
volumes:
- n8n_data:/home/node/.n8n
volumes:
n8n_data:

Замените n8n.example.com на свой домен. Порт привязан к 127.0.0.1: снаружи n8n доступен только через Nginx с HTTPS.

Запуск:

Окно терминала
docker compose up -d
docker compose logs -f n8n

Установка Nginx: Nginx на VPS. Конфиг /etc/nginx/sites-available/n8n:

server {
listen 80;
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 "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_buffering off;
proxy_read_timeout 300s;
}
}

Заголовки Upgrade и Connection нужны для обновления интерфейса в реальном времени. Без них редактор открывается, но запуски сценариев «зависают».

Окно терминала
ln -s /etc/nginx/sites-available/n8n /etc/nginx/sites-enabled/
nginx -t && systemctl reload nginx
certbot --nginx -d n8n.example.com

Сертификат: Let’s Encrypt.

Откройте https://n8n.example.com. При первом входе n8n попросит создать аккаунт владельца: email, имя, фамилию и пароль (от 8 символов, с цифрой и заглавной буквой). Сделайте это сразу: пока аккаунта нет, первый открывший страницу станет владельцем.

Создание аккаунта владельца n8n

Интерфейс n8n на английском. После создания владельца n8n покажет короткую анкету о компании и задачах, после неё откроется рабочее пространство.

URL вебхука n8n показывает в узле Webhook. Он строится из переменной WEBHOOK_URL. Если в узле видно localhost:5678, значит переменная не задана: исправьте docker-compose.yml и выполните docker compose up -d.

У узла есть два адреса: тестовый работает, пока открыт редактор, рабочий — только когда сценарий активирован переключателем.

Окно терминала
cd /opt/n8n
docker compose pull
docker compose up -d

Перед обновлением на новую мажорную версию прочитайте заметки к выпуску: иногда меняются узлы.

Все сценарии, учётные данные и история лежат в томе n8n_data. Ключ шифрования учётных данных хранится там же, в файле config. Без него сохранённые пароли и токены не расшифровать.

Окно терминала
docker run --rm -v n8n_n8n_data:/data -v /root:/backup alpine \
tar -czf /backup/n8n-$(date +%F).tar.gz -C /data .

Имя тома смотрите командой docker volume ls. Архив скачайте за пределы сервера: бэкапы.

Дополнительно можно выгружать сценарии в JSON через меню каждого workflow.

Симптом Причина
Белый экран или ошибка cookie при входе открываете по http://, нужен HTTPS
Вебхук указывает на localhost не задан WEBHOOK_URL
Запуск «висит» в редакторе в Nginx нет заголовков Upgrade и Connection
Контейнер перезапускается нехватка памяти: free -h, docker stats
После переустановки не расшифровываются учётные данные потерян том с ключом шифрования