Установка n8n на Ubuntu: Полное руководство для DevOps и разработчиков

Представь, что тебе нужно автоматизировать рутинные задачи: синхронизацию данных между сервисами, обработку webhook'ов или создание сложных бизнес-процессов. n8n — это инструмент автоматизации с доступным исходным кодом и условиями Sustainable Use License для создания workflow'ов, который можно развернуть на собственном сервере. Давай разберем, как выполнить установку n8n на Ubuntu правильно и безопасно.

Подготовка сервера Ubuntu

В этом примере используем новую Ubuntu 24.04 LTS. Для размещения n8n можно выбрать VPS, в том числе Timeweb Cloud (партнёрская ссылка): сравни ресурсы, резервные копии и стоимость. Понадобятся sudo, домен с правильными DNS A/AAAA и консоль восстановления. Выбери один метод установки: два экземпляра не должны занимать один порт.

Обновление системы и установка зависимостей

# Обновляем пакеты системы
sudo apt update && sudo apt upgrade -y

# Устанавливаем необходимые утилиты
sudo apt install -y curl wget gnupg git build-essential

# Для работы с Docker (если будем использовать)
sudo apt install -y apt-transport-https ca-certificates software-properties-common

Способ 1: Установка n8n через Node.js и PM2

npm/PM2 — альтернативный способ для версии n8n, которая поддерживает npm-установку. Перед установкой проверь её требования Node.js и release notes; не считай PM2 автоматически более подходящим для production. Для нового self-hosting основной выбор ниже — Docker Compose.

Установка Node.js и npm

# Установи поддерживаемую выбранной версией n8n Node.js
# по официальной инструкции nodejs.org, затем проверь:
node --version
npm --version

Проверь текущий диапазон Node.js в документации n8n; на момент проверки он указан как 20.19–24.x. Выбери поддерживаемый LTS внутри диапазона. npm-установки помечены deprecated начиная с n8n 3.0: для такой версии выбирай Docker, а не этот вариант.

Установка и настройка n8n

mkdir -p ~/n8n && cd ~/n8n
npm init -y
# Замени X.Y.Z на выбранную поддерживаемую npm-версию n8n
npm install --save-exact n8n@X.Y.Z
npm install --save-exact pm2

Настройка PM2 для управления процессом

cd ~/n8n
umask 077
cat > ecosystem.config.js << 'EOF'
module.exports = {
  apps: [{
    name: 'n8n',
    script: './node_modules/n8n/bin/n8n',
    args: 'start',
    cwd: __dirname,
    env: {
      N8N_LISTEN_ADDRESS: '127.0.0.1',
      N8N_PROTOCOL: 'https',
      N8N_HOST: 'n8n.example.com',
      N8N_PORT: 5678,
      N8N_PROXY_HOPS: 1,
      N8N_ENCRYPTION_KEY: 'REPLACE_WITH_RANDOM_SECRET',
      WEBHOOK_URL: 'https://n8n.example.com/',
      N8N_EDITOR_BASE_URL: 'https://n8n.example.com/',
      DB_TYPE: 'sqlite',
      N8N_METRICS: 'false'
    }
  }]
};
EOF
chmod 600 ecosystem.config.js
# Сначала замени домен и секрет, затем:
./node_modules/.bin/pm2 start ecosystem.config.js
./node_modules/.bin/pm2 save

Способ 2: Установка n8n через Docker

Docker Compose позволяет описать n8n и PostgreSQL вместе. Контейнеры не заменяют обновления, контроль доступа и резервные копии. Не запускай одновременно с PM2 на том же порту.

Установка Docker и Docker Compose

# Установи Docker Engine и Compose plugin из официального
# apt-репозитория по docs.docker.com/engine/install/ubuntu/
sudo docker version
sudo docker compose version

Создай ~/n8n-docker и в нём файл .env с правами 600. Задай N8N_VERSION (точную стабильную версию), POSTGRES_PASSWORD и N8N_ENCRYPTION_KEY (разные случайные значения, например openssl rand -hex 32), N8N_HOST=n8n.example.com. В примерах WEBHOOK_URL оставлен для совместимости: начиная с n8n 2.30.0 доступно имя N8N_WEBHOOK_URL, а с 2.35.0 старое помечено deprecated. Для выбранной версии 2.30.0+ замени имя на N8N_WEBHOOK_URL в обоих вариантах; не задавай оба. Сохрани ключ шифрования вместе с бэкапом: смена ключа делает старые credentials нечитаемыми. Не публикуй .env и вывод compose config. POSTGRES_PASSWORD инициализирует только новую базу, не меняет пароль существующего volume.

Docker Compose конфигурация для n8n

services:
  postgres:
    image: postgres:15-alpine
    restart: unless-stopped
    environment:
      POSTGRES_USER: n8n_user
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:?Set POSTGRES_PASSWORD}
      POSTGRES_DB: n8n
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U n8n_user -d n8n"]
      interval: 10s
      timeout: 5s
      retries: 10
  n8n:
    image: docker.n8n.io/n8nio/n8n:${N8N_VERSION:?Set N8N_VERSION}
    restart: unless-stopped
    ports:
      - "127.0.0.1:5678:5678"
    environment:
      N8N_PROTOCOL: https
      N8N_HOST: ${N8N_HOST:?Set N8N_HOST}
      WEBHOOK_URL: https://${N8N_HOST}/
      N8N_EDITOR_BASE_URL: https://${N8N_HOST}/
      N8N_PROXY_HOPS: 1
      N8N_ENCRYPTION_KEY: ${N8N_ENCRYPTION_KEY:?Set N8N_ENCRYPTION_KEY}
      DB_TYPE: postgresdb
      DB_POSTGRESDB_HOST: postgres
      DB_POSTGRESDB_PORT: 5432
      DB_POSTGRESDB_DATABASE: n8n
      DB_POSTGRESDB_USER: n8n_user
      DB_POSTGRESDB_PASSWORD: ${POSTGRES_PASSWORD:?Set POSTGRES_PASSWORD}
      N8N_METRICS: "false"
      GENERIC_TIMEZONE: Europe/Moscow
      TZ: Europe/Moscow
    volumes:
      - n8n_data:/home/node/.n8n
    depends_on:
      postgres:
        condition: service_healthy
volumes:
  postgres_data:
  n8n_data:

mkdir -p ~/n8n-docker && cd ~/n8n-docker
umask 077
nano .env  # Заполни переменные, описанные выше
chmod 600 .env
nano compose.yaml  # Вставь YAML выше
sudo docker compose config --quiet
sudo docker compose up -d
sudo docker compose ps
sudo docker compose logs --tail=100 n8n

Настройка Nginx в качестве reverse proxy

Для внешнего доступа используем Nginx с HTTPS. До публикации разреши фактический SSH-порт в firewall и проверь второй сеанс, затем 80/443; подготовь откат через консоль провайдера. Не открывай5678 наружу. На этапе первого владельца временно разреши доступ только своему публичному IP в Nginx, как показано ниже.

Установка и базовая настройка Nginx

sudo apt install -y nginx
sudo systemctl status nginx

Конфигурация виртуального хоста для n8n

server {
    listen 80;
    listen [::]:80;
    server_name n8n.example.com;
    location ^~ /.well-known/acme-challenge/ {
        root /var/www/html;
        try_files $uri =404;
    }
    location = /metrics { deny all; }
    location / {
        # Замени адрес своим публичным IP до активации
        allow 203.0.113.10;
        deny all;
        proxy_pass http://127.0.0.1:5678;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $remote_addr;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_read_timeout 600s;
        proxy_send_timeout 600s;
    }
}

Сохрани конфигурацию в /etc/nginx/sites-available/n8n, замени домен и IP, создай ссылку в sites-enabled. Выполни sudo nginx -t и только при успехе sudo systemctl reload nginx. Не вводи пароль по HTTP. Сначала выпусти сертификат; для домена должны работать DNS и доступ к80. После выдачи сертификата проверь сохранение временного IP-ограничения, открой HTTPS и создай owner-аккаунт с уникальным паролем/MFA. Только затем убери allow/deny из location / и снова проверь/reload Nginx.

Получение SSL сертификата через Certbot

sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d n8n.example.com
sudo certbot renew --dry-run
systemctl list-timers --all

Сравнение методов установки n8n

Базовые команды управления n8n

Часто задаваемые вопросы (FAQ)

cd ~/n8n-docker
umask 077
mkdir -p ~/n8n-backups
sudo docker compose stop n8n
sudo docker compose exec -T postgres pg_dump -U n8n_user -d n8n -Fc > ~/n8n-backups/n8n-$(date +%Y%m%d-%H%M%S).dump
# Проверь успех pg_dump и скопируй n8n_data, .env и compose.yaml
# согласованным способом, затем верни n8n в работу:
sudo docker compose start n8n

Оптимизация производительности

После успешной установки n8n на Ubuntu, рассмотрим несколько советов по оптимизации:

• Настройка лимитов памяти: Для PM2 укажите max_memory_restart: '1G' в ecosystem.config.js
• Оптимизация PostgreSQL: Настройте shared_buffers и work_mem в postgresql.conf
• Очередь: Redis используется в queue mode как брокер, а не как универсальный кэш workflow; переход требует отдельной настройки workers, БД и ключа шифрования
• Мониторинг: Настройте метрики через N8N_METRICS=true и подключите Prometheus только через защищённую внутреннюю сеть; пример Nginx блокирует публичный /metrics
• Логирование: Настройте ротацию логов через logrotate

После проверки HTTPS, входа, тестового workflow и восстановления бэкапа можно оценить готовность установки n8n на Ubuntu. Ты можешь начать создавать автоматизации, подключать сервисы и оптимизировать бизнес-процессы. Помни про безопасность: регулярно обновляй систему, настраивай бэкапы и мониторинг. Удачи в автоматизации!