N8n setup

Полное руководство по установке и настройке n8n

n8n — это инструмент для автоматизации рабочих процессов с открытым исходным кодом, использующий парадигму workflow-as-code. Он позволяет соединять различные приложения, базы данных и API через визуальный редактор, основанный на узлах (nodes). В отличие от многих других платформ, n8n может быть развернут на собственном сервере, что обеспечивает полный контроль над данными и процессами. Данная статья представляет собой исчерпывающее техническое руководство по установке, базовой настройке, администрированию и оптимизации n8n в production-среде.

Выбор метода установки и системные требования

Перед началом установки необходимо определить метод развертывания, соответствующий вашим техническим навыкам и инфраструктурным требованиям. Каждый метод имеет свои преимущества и подходит для разных сценариев использования.

Метод установки	Рекомендуется для	Сложность	Управление
Docker (рекомендуемый)	Всех окружений, особенно production	Средняя	Проще обновление, изоляция, контейнеризация
npm (пакетный менеджер Node.js)	Разработки, быстрого тестирования	Низкая	Прямое управление процессом Node.js
Предустановленный образ (DigitalOcean, AWS)	Быстрого старта в облаке	Очень низкая	Зависит от платформы
Ручная установка на сервер	Полного контроля над окружением	Высокая	Полный контроль, высокая ответственность

Минимальные системные требования:

Операционная система: Linux (Ubuntu 20.04/22.04, Debian 10+, CentOS 7+), macOS, Windows (для разработки).
Процессор: 2+ ядра (рекомендуется 4 для production).
Оперативная память: 4 ГБ (рекомендуется 8+ ГБ для production с множеством workflow).
Дисковое пространство: 10 ГБ для системы и зависимостей, плюс место для хранения данных workflow и логов.
Сетевой доступ: исходящие соединения к используемым API (GitHub, Slack, Notion и т.д.).
Программное обеспечение: Node.js версии 18.x или 20.x, Docker и Docker Compose (для контейнерного метода), база данных (SQLite, PostgreSQL, MySQL).

Пошаговая установка n8n с использованием Docker

Использование Docker является наиболее надежным и предпочтительным методом для production-развертывания, так как обеспечивает изоляцию, простоту обновления и воспроизводимость окружения.

1. Подготовка сервера и установка Docker

На сервере под управлением Ubuntu/Debian выполните следующие команды для установки Docker Engine и Docker Compose plugin:

Обновите индекс пакетов: sudo apt update
Установите необходимые зависимости: sudo apt install -y apt-transport-https ca-certificates curl software-properties-common
Добавьте официальный GPG-ключ Docker: curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
Добавьте репозиторий Docker: echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
Установите Docker Engine и Compose: sudo apt update && sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin
Проверьте установку: sudo docker --version && docker compose version

2. Создание конфигурационного файла docker-compose.yml

Создайте отдельный каталог для n8n, например, /opt/n8n, и в нем файл docker-compose.yml. Для production обязательно рекомендуется использовать внешнюю базу данных PostgreSQL вместо встроенной SQLite.

version: '3.8'

services:
  n8n:
    image: n8nio/n8n:latest
    container_name: n8n
    restart: unless-stopped
    ports:
      - "5678:5678"
    environment:
      - N8N_PROTOCOL=https
      - N8N_HOST=your_domain.com
      - N8N_PORT=5678
      - N8N_WEBHOOK_URL=https://your_domain.com/
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_PORT=5432
      - DB_POSTGRESDB_DATABASE=n8n
      - DB_POSTGRESDB_USER=n8n_user
      - DB_POSTGRESDB_PASSWORD=your_secure_password_here
      - N8N_ENCRYPTION_KEY=your_super_secret_encryption_key_32_chars
      - GENERIC_TIMEZONE=Europe/Moscow
      - N8N_METRICS=true
      - N8N_METRICS_INCLUDE_DEFAULT_METRICS=true
    volumes:
      - n8n_data:/home/node/.n8n
    depends_on:
      - postgres
    networks:
      - n8n_network

  postgres:
    image: postgres:15-alpine
    container_name: n8n_postgres
    restart: unless-stopped
    environment:
      - POSTGRES_USER=n8n_user
      - POSTGRES_PASSWORD=your_secure_password_here
      - POSTGRES_DB=n8n
    volumes:
      - postgres_data:/var/lib/postgresql/data
    networks:
      - n8n_network

volumes:
  n8n_data:
  postgres_data:

networks:
  n8n_network:
    driver: bridge

3. Запуск n8n и первоначальная настройка

В каталоге с файлом docker-compose.yml выполните команду для запуска в фоновом режиме: sudo docker compose up -d. Проверьте статус контейнеров: sudo docker compose ps. Логи можно просмотреть с помощью: sudo docker compose logs -f n8n. После успешного запуска откройте в браузере http://your_server_ip:5678. Вам будет предложено создать учетную запись первого пользователя, который станет администратором системы.

Базовая и расширенная конфигурация

Конфигурация n8n управляется через переменные окружения. Ключевые из них для production-среды:

Переменная	Назначение	Пример значения
N8N_ENCRYPTION_KEY	Ключ для шифрования учетных данных. Должен быть строго 32 символа. Критически важен, должен храниться в секрете.	my-super-secret-encryption-key-32
DB_TYPE	Тип базы данных. Для production используйте `postgresdb` или `mysqldb`.	postgresdb
EXECUTIONS_DATA_PRUNE	Включить автоматическую очистку старых данных выполнений.	true
EXECUTIONS_DATA_MAX_AGE	Максимальный возраст (в часах) данных выполнений перед удалением.	168 (7 дней)
N8N_DIAGNOSTICS_ENABLED	Отправка анонимных данных об ошибках и использовании. Может быть отключена.	false
N8N_USER_MANAGEMENT_DISABLED	Отключение встроенной системы управления пользователями (например, при использовании внешнего OAuth).	false
WEBHOOK_URL	Публичный URL, по которому доступен n8n. Необходим для корректной работы webhook-нод.	https://n8n.yourcompany.com

Настройка обратного прокси (Nginx) и SSL

Для безопасного доступа к n8n извне необходимо настроить веб-сервер Nginx в качестве обратного прокси и установить SSL-сертификат от Let’s Encrypt.

Установите Nginx и Certbot: sudo apt install -y nginx certbot python3-certbot-nginx
Создайте конфигурационный файл виртуального хоста /etc/nginx/sites-available/n8n:

server {
    server_name n8n.yourdomain.com;

    location / {
        proxy_pass http://localhost:5678;
        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_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }

    Увеличение лимита размера тела запроса, если необходимо
    client_max_body_size 100M;
}

Активируйте конфигурацию и получите SSL-сертификат:
sudo ln -s /etc/nginx/sites-available/n8n /etc/nginx/sites-enabled/
sudo certbot --nginx -d n8n.yourdomain.com
В файле docker-compose.yml убедитесь, что переменные N8N_PROTOCOL, N8N_HOST и N8N_WEBHOOK_URL установлены с использованием https и вашего доменного имени.

Управление пользователями, ролями и безопасностью

После входа с учетной записью администратора вы можете управлять пользователями в разделе «Settings» -> «Users». n8n поддерживает ролевую модель:

Owner: Полный доступ ко всем функциям, включая управление пользователями и настройками экземпляра.
Admin: Может управлять workflow, учетными данными и пользователями (но не настройками экземпляра).
Member: Может создавать и выполнять workflow, но не может управлять пользователями или глобальными настройками.

Рекомендации по безопасности:

Используйте сложные пароли или настройте OAuth-аутентификацию (например, через Google или GitHub).
Регулярно обновляйте n8n до последней стабильной версии.
Никогда не используйте значение N8N_ENCRYPTION_KEY по умолчанию. Сгенерируйте новый уникальный ключ при первой установке.
Ограничьте доступ к порту 5678 только с внутренних IP или через VPN, оставив публичный доступ только через Nginx с SSL.
Регулярно создавайте резервные копии тома данных PostgreSQL.

Резервное копирование и обновление

Резервное копирование: Самые важные данные — это база данных PostgreSQL и зашифрованные учетные данные, хранящиеся в ней. Для резервного копирования используйте команды pg_dump или создавайте снапшот тома Docker.

Дамп базы данных из контейнера
sudo docker exec n8n_postgres pg_dump -U n8n_user n8n > /path/to/backup/n8n_backup_$(date +%Y%m%d).sql

Обновление: При использовании Docker процесс обновления прост:

Остановите контейнеры: sudo docker compose down
Получите новый образ: sudo docker compose pull
Запустите контейнеры заново: sudo docker compose up -d
Проверьте логи на наличие ошибок: sudo docker compose logs -f n8n

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

Мониторинг и отладка

Для мониторинга производительности n8n используйте встроенные метрики Prometheus. Активируйте их, установив переменные N8N_METRICS=true и N8N_METRICS_INCLUDE_DEFAULT_METRICS=true. Метрики будут доступны по эндпоинту /metrics (например, https://yourdomain.com/metrics). Их можно собирать с помощью Prometheus и визуализировать в Grafana.

Для отладки workflow используйте встроенный режим выполнения: каждый узел можно запустить отдельно, проверить входные и выходные данные. Детальная информация о каждом выполнении хранится в разделе «Executions». Включите расширенное логирование, установив переменную N8N_LOG_LEVEL=debug (только для отладки, в production используйте info или error).

Ответы на часто задаваемые вопросы (FAQ)

Какой метод установки лучше всего подходит для начинающих?

Для быстрого знакомства и тестирования используйте облачный предустановленный образ (например, на DigitalOcean) или установку через npm на локальную машину. Для долгосрочного использования, даже для одного пользователя, предпочтительнее Docker, так как он упрощает дальнейшее обслуживание и масштабирование.

Почему важно заменить SQLite на PostgreSQL в production?

SQLite — встроенная файловая БД, не предназначенная для высоких параллельных нагрузок. При одновременном выполнении нескольких workflow или активной работе нескольких пользователей возможны блокировки и потеря данных. PostgreSQL обеспечивает надежность, конкурентный доступ, возможность репликации и Point-in-Time Recovery.

Как перенести данные и workflow с одного сервера n8n на другой?

Самый надежный способ — перенос на уровне базы данных. Остановите оба экземпляра n8n. Создайте дамп базы данных с исходного сервера с помощью pg_dump и восстановите его на целевом сервере. Убедитесь, что N8N_ENCRYPTION_KEY идентичен на обоих серверах, иначе расшифровать учетные данные не удастся.

Как настроить отправку email-уведомлений при сбое workflow?

Используйте узел «Error Trigger». Подключите его в начале вашего workflow. В случае ошибки в любом последующем узле, поток управления перейдет к ветке, исходящей из «Error Trigger». В этой ветке разместите узел для отправки email (например, SMTP) или сообщения в Slack/Telegram, который получит контекст ошибки.

Можно ли запускать n8n как сервис (systemd) без Docker?

Да, при установке через npm вы можете создать файл сервиса systemd. Пример /etc/systemd/system/n8n.service:

[Unit]
Description=n8n workflow automation server
After=network.target postgresql.service

[Service]
Type=simple
User=n8n
Environment="N8N_ENCRYPTION_KEY=your_key"
Environment="DB_TYPE=postgresdb"
ExecStart=/usr/bin/n8n start
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

Как ограничить доступ к n8n только для определенных IP-адресов?

Настройте правила брандмауэра (UFW или iptables) на вашем сервере, чтобы разрешить доступ к порту 5678 (или 443, если используете Nginx) только с доверенных IP-адресов. Альтернативно, настройте ограничения на уровне Nginx с помощью директив allow и deny внутри блока location /.

Как добавить собственные узлы (custom nodes) в n8n?

Создайте каталог для пользовательских узлов, например, custom-nodes, внутри директории данных n8n (том Docker или ~/.n8n). Установите необходимые npm-пакеты узлов в этот каталог. Укажите путь к этому каталогу через переменную окружения N8N_CUSTOM_EXTENSIONS (например, /home/node/.n8n/custom-nodes). После перезапуска n8n узлы появятся в интерфейсе.