N8n docker

N8n в Docker: Полное руководство по развертыванию и управлению

N8n (произносится как «n-eight-n») — это инструмент для автоматизации рабочих процессов с открытым исходным кодом, который позволяет соединять различные приложения, API и сервисы между собой. Он функционирует по принципу «if-this-then-that» (IFTTT), но с гораздо большей гибкостью и мощностью, ориентированной на профессиональное использование. Docker — это платформа для контейнеризации, которая упаковывает приложение и все его зависимости в стандартизированный образ, гарантируя идентичную работу в любой среде. Сочетание N8n и Docker является стандартом де-факто для промышленного развертывания этого инструмента, обеспечивая простоту установки, масштабируемость, изоляцию и управление конфигурацией.

Архитектура и ключевые компоненты N8n

N8n построен на основе узлов (Nodes). Каждый узел представляет собой предварительно сконфигурированный блок, который выполняет определенную операцию: триггер (например, «новое письмо в Gmail»), действие («создать запись в Google Таблице») или логическую операцию («если-иначе»). Пользователи соединяют узлы в рабочие процессы (Workflows), определяя поток данных между ними. Данные передаются между узлами в формате JSON. N8n поддерживает сотни встроенных узлов для популярных сервисов (HTTP-запросы, базы данных, Slack, Telegram, Notion и т.д.), а также позволяет создавать собственные узлы.

Преимущества запуска N8n в Docker

• Изоляция и переносимость: Контейнер N8n включает в себя само приложение, среду выполнения Node.js и все системные зависимости. Это исключает конфликты версий и проблемы с окружением («на моей машине работало»).
• Упрощенное развертывание и обновление: Запуск сводится к одной команде docker run. Обновление до новой версии требует лишь загрузки нового образа и перезапуска контейнера.
• Управление конфигурацией и данными: Используя Docker Volumes и переменные окружения, вы можете отделить конфигурацию и сохраненные рабочие процессы от самого контейнера, что делает их устойчивыми к пересозданию контейнера.
• Интеграция с оркестраторами: Docker-контейнеры легко управляются такими системами, как Docker Compose, Kubernetes или Docker Swarm, что позволяет строить отказоустойчивые и масштабируемые кластеры N8n.
• Безопасность: Контейнеры обеспечивают уровень изоляции на уровне операционной системы, что позволяет ограничивать ресурсы (CPU, память) и доступ к сети.

Базовое развертывание N8n с помощью Docker

Минимальная команда для запуска N8n:

docker run -it --rm 
  --name n8n 
  -p 5678:5678 
  n8nio/n8n

Эта команда создаст и запустит контейнер из официального образа n8nio/n8n, пробросит порт 5678 контейнера на порт 5678 хоста и удалит контейнер после его остановки (флаг --rm). Однако такая конфигурация не сохраняет данные.

Продвинутая конфигурация с Docker Compose и томами

Для production-среды рекомендуется использовать Docker Compose и тома для сохранения данных. Пример файла docker-compose.yml:

version: '3.8'

services:
  n8n:
    image: n8nio/n8n:latest
    container_name: n8n
    restart: unless-stopped
    ports:
      - "5678:5678"
    environment:
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=secure_password
      - N8N_PROTOCOL=https
      - N8N_HOST=your_domain.com
      - N8N_PORT=5678
      - NODE_ENV=production
      - WEBHOOK_URL=https://your_domain.com/
      - GENERIC_TIMEZONE=Europe/Moscow
      - N8N_ENCRYPTION_KEY=your_super_secret_key_32_chars
    volumes:
      - n8n_data:/home/node/.n8n
      - ./local_files:/files
volumes:
  n8n_data:

Ключевые аспекты этой конфигурации:

• Том n8n_data: Сохраняет все данные N8n (рабочие процессы, учетные данные, настройки) вне контейнера. Это критически важно для обновлений и восстановления.
• Переменные окружения: Позволяют гибко настраивать N8n без изменения образа.
• Restart Policy: unless-stopped гарантирует автоматический перезапуск контейнера после перезагрузки сервера или сбоя.

Критически важные переменные окружения для Production

Переменная	Назначение	Пример значения
N8N_BASIC_AUTH_ACTIVE	Включает базовую HTTP-аутентификацию для веб-интерфейса.	true
N8N_BASIC_AUTH_USER / N8N_BASIC_AUTH_PASSWORD	Логин и пароль для доступа к интерфейсу.	admin / ваш_пароль
N8N_ENCRYPTION_KEY	Ключ для шифрования учетных данных в базе данных. Должен быть строкой длиной ровно 32 символа. Обязателен для production.	supersecretkey_32_chars_long_abc
N8N_PROTOCOL, N8N_HOST, WEBHOOK_URL	Настройки публичного URL. Необходимы для корректной генерации ссылок вебхуков.	https, your_domain.com, https://your_domain.com/
DB_TYPE	Тип внешней базы данных (по умолчанию SQLite). Для production обязателен переход на PostgreSQL или MySQL.	postgresdb
DB_POSTGRESDB_HOST, DB_POSTGRESDB_DATABASE, DB_POSTGRESDB_USER, DB_POSTGRESDB_PASSWORD	Параметры подключения к внешней СУБД PostgreSQL.	postgres, n8n, n8n_user, db_password
EXECUTIONS_DATA_PRUNE	Включает автоматическую очистку старых данных выполнений.	true
EXECUTIONS_DATA_MAX_AGE	Максимальный возраст (в часах) данных выполнений перед удалением.	168 (7 дней)

Интеграция с внешней базой данных (PostgreSQL)

Использование встроенной SQLite не подходит для production из-за проблем с производительностью и надежностью при параллельном доступе. Полный пример docker-compose.yml с PostgreSQL:

version: '3.8'

services:
  postgres:
    image: postgres:15-alpine
    container_name: n8n_postgres
    restart: unless-stopped
    environment:
      - POSTGRES_USER=n8n_user
      - POSTGRES_PASSWORD=db_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: 5

  n8n:
    image: n8nio/n8n:latest
    container_name: n8n
    restart: unless-stopped
    depends_on:
      postgres:
        condition: service_healthy
    ports:
      - "5678:5678"
    environment:
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_PORT=5432
      - DB_POSTGRESDB_DATABASE=n8n
      - DB_POSTGRESDB_USER=n8n_user
      - DB_POSTGRESDB_PASSWORD=db_password
      - N8N_ENCRYPTION_KEY=your_super_secret_key_32_chars
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=secure_password
    volumes:
      - n8n_data:/home/node/.n8n

volumes:
  postgres_data:
  n8n_data:

Управление и обслуживание

• Обновление: Остановите контейнеры (docker-compose down), обновите образ (docker-compose pull), запустите заново (docker-compose up -d). Данные в томах останутся нетронутыми.
• Резервное копирование: Необходимо регулярно создавать резервные копии томов Docker (каталогов на хосте, куда смонтированы тома postgres_data и n8n_data) и/или делать дамп базы данных PostgreSQL.
• Мониторинг: Используйте логи Docker (docker logs n8n). Для интеграции с внешними системами мониторинга настройте экспорт логов в JSON и используйте метрики состояния N8n API.
• Масштабирование: Горизонтальное масштабирование (несколько экземпляров N8n) требует использования внешней очереди сообщений (Redis) и базы данных. Это настраивается через переменные QUEUE_BULL_REDIS_HOST и другие.

Безопасность

• Всегда меняйте значения переменных окружения по умолчанию (логин, пароль, ключ шифрования).
• Используйте обратный прокси (например, Nginx или Traefik) для терминации SSL/TLS, настройки HTTPS, ограничения скорости запросов и дополнительной аутентификации.
• Ограничивайте сетевой доступ к порту N8n (5678) только с доверенных IP-адресов или обратного прокси.
• Регулярно обновляйте образы N8n и PostgreSQL для получения исправлений уязвимостей.
• Храните секреты (пароли, ключи API) в переменных окружения или специальных системах (HashiCorp Vault), а не в файлах конфигурации.

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

Как перенести данные из SQLite в PostgreSQL при переходе на Docker?

Сначала запустите N8n в Docker с томом, содержащим вашу старую директорию .n8n с SQLite-файлом. Используйте встроенную функцию миграции N8n: в настройках интерфейса (Settings > Database) выберите «Migrate to another database». Укажите параметры вашего PostgreSQL. N8n автоматически перенесет все рабочие процессы и учетные данные.

Почему вебхуки не работают после переноса N8n за обратный прокси?

Вероятно, неправильно настроены переменные N8N_PROTOCOL, N8N_HOST и WEBHOOK_URL. Они должны отражать публичный URL, по которому пользователи и внешние сервисы обращаются к N8n, а не внутренний адрес контейнера. Убедитесь, что обратный прокси корректно передает заголовки, особенно X-Forwarded-Proto и X-Forwarded-Host.

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

Используйте переменные окружения для настройки почтового клиента:
N8N_EMAIL_MODE=smtp,
N8N_SMTP_HOST=smtp.gmail.com,
N8N_SMTP_PORT=587,
N8N_SMTP_USER=your_email@gmail.com,
N8N_SMTP_PASSWORD=your_app_specific_password,
N8N_SMTP_SENDER=your_email@gmail.com.
После этого в настройках рабочего процесса можно включить опцию «Send Alert on Failure».

Можно ли запустить несколько независимых экземпляров N8n на одном сервере?

Да. Для этого необходимо:
1. Использовать разные имена контейнеров и сетей.
2. Пробросить каждый экземпляр на уникальный порт хоста (например, 5678, 5679).
3. Использовать отдельные тома данных для каждого экземпляра.
4. При использовании внешней БД — либо создать отдельные базы данных, либо использовать разные схемы в одной базе (если поддерживается).

Как ограничить потребление ресурсов (CPU, RAM) контейнером N8n?

В Docker Compose используйте директивы deploy.resources.limits (в Swarm/Compose v3) или параметры командной строки --cpus, --memory. Пример в docker-compose.yml:

services:
  n8n:
    ...
    deploy:
      resources:
        limits:
          cpus: '2.0'
          memory: 4G

Как добавить собственные узлы (Custom Nodes) в N8n, запущенный в Docker?

Существует два основных метода:
1. Сборка собственного образа Docker: Создайте Dockerfile на основе официального образа и скопируйте директорию с вашими узлами в /usr/local/lib/node_modules/n8n-nodes-base/dist/nodes или установите их через npm.
2. Монтирование через том: Смонтируйте локальную директорию с узлами в соответствующую папку внутри контейнера. Это требует точного знания структуры путей и может быть менее надежным.

Как решить проблему с ошибкой «ERR_OSSL_EVP_UNSUPPORTED» в новых версиях Node.js?

Эта ошибка возникает из-за изменений в политике шифрования OpenSSL. Решается добавлением переменной окружения в конфигурацию Docker:
NODE_OPTIONS=--openssl-legacy-provider.