Docker run n8n

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

n8n — это инструмент с открытым исходным кодом для оркестрации рабочих процессов (workflow automation), который позволяет соединять различные приложения, API и сервисы без необходимости писать код. Использование Docker для его запуска обеспечивает изолированную, воспроизводимую и легко управляемую среду развертывания, что упрощает процесс установки, обновления и масштабирования. Данная статья детально рассматривает все аспекты запуска n8n с помощью контейнеров Docker.

Предварительные требования и установка Docker

Перед запуском n8n необходимо убедиться, что в системе установлен Docker Engine и, опционально, Docker Compose. Процесс установки зависит от операционной системы.

• Для Linux (Ubuntu/Debian): Официальный репозиторий Docker — предпочтительный метод. Необходимо обновить индексы пакетов, установить зависимости и добавить репозиторий Docker, после чего установить сам Docker Engine и Docker Compose как плагин.
• Для Windows/macOS: Рекомендуется установить Docker Desktop, который включает в себя все необходимые компоненты: Docker Engine, CLI, Compose и графический интерфейс для управления.

После установки следует проверить корректность установки, выполнив в терминале команду docker --version и docker compose version. Убедитесь, что служба Docker запущена.

Базовый запуск n8n с помощью команды Docker run

Самый простой способ запустить n8n — использовать официальный образ с Docker Hub. Базовая команда для запуска одноразового контейнера выглядит следующим образом:

docker run -it --rm --name n8n -p 5678:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n

Разберем ключевые параметры этой команды:

• -it: Запуск контейнера в интерактивном режиме с псевдо-TTY, что позволяет видеть логи в реальном времени.
• --rm: Автоматическое удаление контейнера после его остановки. Полезно для тестирования, но не для production.
• --name n8n</code: Присваивает контейнеру понятное имя.
• -p 5678:5678: Публикация порта. Первое значение (5678) — порт на хостовой машине, второе (5678) — порт внутри контейнера, на котором работает n8n.
• -v ~/.n8n:/home/node/.n8n: Монтирование тома (volume). Это критически важный параметр для сохранения данных. Он связывает локальную директорию ~/.n8n на хосте с директорией /home/node/.n8n внутри контейнера, где хранятся все workflows, учетные данные, настройки и база данных SQLite.
• n8nio/n8n: Имя официального образа из Docker Hub.

После выполнения команды контейнер запустится, и вы сможете открыть веб-интерфейс n8n по адресу http://localhost:5678. Первым шагом будет создание учетной записи администратора.

Расширенная конфигурация с переменными окружения

Для настройки n8n под конкретные нужды используются переменные окружения. Они передаются в контейнер с помощью флага -e в команде docker run. Ниже приведены наиболее важные переменные.

Переменная окружения	Описание и назначение	Пример значения
N8N_BASIC_AUTH_ACTIVE	Включает HTTP Basic аутентификацию для всего интерфейса n8n.	true
N8N_BASIC_AUTH_USER	Имя пользователя для Basic аутентификации.	admin
N8N_BASIC_AUTH_PASSWORD	Пароль для Basic аутентификации.	secure_password
N8N_PROTOCOL	Протокол, используемый для генерации ссылок в webhook (важно при работе за reverse proxy).	https
N8N_HOST	Публичное имя хоста (домен) для генерации корректных URL webhook.	n8n.yourdomain.com
N8N_WEBHOOK_URL	Полный URL, который будет использоваться для webhook (переопределяет N8N_PROTOCOL и N8N_HOST).	https://n8n.yourdomain.com/
N8N_ENCRYPTION_KEY	Ключ для шифрования учетных данных в базе данных. Должен быть длиной 32 символа и оставаться неизменным.	my_super_secure_key_32_chars_long
GENERIC_TIMEZONE	Часовой пояс, используемый n8n.	Europe/Moscow
DB_TYPE	Тип внешней базы данных (если не используется встроенная SQLite).	postgresdb
DB_POSTGRESDB_HOST	Хост для подключения к PostgreSQL.	postgres

Пример команды запуска с расширенными настройками:

docker run -d --name n8n
-p 5678:5678
-v ~/.n8n:/home/node/.n8n
-e N8N_BASIC_AUTH_ACTIVE=true
-e N8N_BASIC_AUTH_USER=admin
-e N8N_BASIC_AUTH_PASSWORD=secret
-e N8N_PROTOCOL=https
-e N8N_HOST=n8n.yourdomain.com
-e GENERIC_TIMEZONE=Europe/Moscow
n8nio/n8n

Использование Docker Compose для оркестрации

Для production-развертывания, особенно с использованием внешней базы данных, Docker Compose является более предпочтительным и управляемым методом. Он позволяет описать весь стек приложения в одном YAML-файле.

Пример файла docker-compose.yml для запуска n8n с PostgreSQL и настроенной аутентификацией:


version: '3.8'
services:
postgres:
image: postgres:15-alpine
restart: unless-stopped
environment:
POSTGRES_USER: n8n
POSTGRES_PASSWORD: n8n_password
POSTGRES_DB: n8n
volumes:
- postgres_data:/var/lib/postgresql/data
healthcheck:
test: ["CMD-SHELL", "pg_isready -U n8n"]
interval: 10s
timeout: 5s
retries: 5

n8n:
image: n8nio/n8n
restart: unless-stopped
ports:
- "5678:5678"
environment:
DB_TYPE: postgresdb
DB_POSTGRESDB_HOST: postgres
DB_POSTGRESDB_PORT: 5432
DB_POSTGRESDB_USER: n8n
DB_POSTGRESDB_PASSWORD: n8n_password
DB_POSTGRESDB_DATABASE: n8n
N8N_BASIC_AUTH_ACTIVE: true
N8N_BASIC_AUTH_USER: admin
N8N_BASIC_AUTH_PASSWORD: ${N8N_ADMIN_PASSWORD}
N8N_PROTOCOL: https
N8N_HOST: ${N8N_PUBLIC_URL}
N8N_ENCRYPTION_KEY: ${N8N_ENCRYPTION_KEY}
WEBHOOK_URL: https://${N8N_PUBLIC_URL}/
GENERIC_TIMEZONE: Europe/Moscow
volumes:
- n8n_data:/home/node/.n8n
depends_on:
postgres:
condition: service_healthy
links:
- postgres

volumes:
postgres_data:
n8n_data:


Для запуска этого стека необходимо создать файл .env в той же директории и определить в нем переменные:


N8N_ADMIN_PASSWORD=your_strong_admin_password
N8N_PUBLIC_URL=n8n.yourdomain.com
N8N_ENCRYPTION_KEY=your_32_character_long_encryption_key_here


Затем выполнить команду docker compose up -d. Docker Compose создаст две именованных тома (postgres_data и n8n_data) для сохранения данных, запустит контейнер PostgreSQL, дождется его готовности и только после этого запустит контейнер n8n с правильными настройками подключения к БД.

Настройка внешнего хранилища данных и резервное копирование

При использовании Docker Volumes данные контейнеров хранятся в управляемой Docker области. Для большей прозрачности и контроля можно использовать bind mounts, которые монтируют конкретную директорию хоста в контейнер. В примерах выше уже показано использование volumes. Для резервного копирования данных n8n, развернутого в Docker, необходимо копировать содержимое соответствующих томов.

• Для данных PostgreSQL: Резервное копирование осуществляется с помощью утилиты pg_dump, которую можно запустить внутри контейнера: docker exec [postgres_container_id] pg_dump -U n8n n8n > backup.sql.
• Для данных n8n (при использовании SQLite): Достаточно скопировать файл базы данных из смонтированного тома. Если используется внешняя PostgreSQL, в томе n8n хранятся только файлы workflows, учетные данные и прочие настройки, которые также необходимо архивировать.

Обновление n8n в Docker

Процесс обновления до новой версии n8n при использовании Docker прост и безопасен при условии, что данные сохранены в томах.

1. Остановите текущий контейнер: docker stop n8n (или docker compose down).
2. Удалите старый контейнер: docker rm n8n (не затрагивает тома).
3. Получите новую версию образа: docker pull n8nio/n8n:latest (или конкретной версии, например, n8nio/n8n:1.24.0).
4. Запустите контейнер заново с теми же параметрами томов и переменными окружения. При использовании Docker Compose достаточно выполнить docker compose pull и затем docker compose up -d.

Развертывание за Reverse Proxy (Nginx)

Для безопасного доступа к n8n извне рекомендуется размещать его за reverse proxy с SSL-терминацией. Пример конфигурации Nginx:


server {
listen 80;
server_name n8n.yourdomain.com;
return 301 https://$server_name$request_uri;
}

server {
listen 443 ssl http2;
server_name n8n.yourdomain.com;

ssl_certificate /path/to/your/fullchain.pem;
ssl_certificate_key /path/to/your/privkey.pem;

location / {
proxy_pass http://localhost:5678;
proxy_set_header Connection '';
proxy_http_version 1.1;
chunked_transfer_encoding off;
proxy_buffering off;
proxy_cache off;
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;
}
}


Критически важно передавать заголовки X-Forwarded-Proto и Host, а также отключать буферизацию для корректной работы webhook. В переменных окружения n8n (N8N_PROTOCOL, N8N_HOST) должны быть указаны внешние адреса.

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

Как сохранить мои workflows и настройки при перезапуске контейнера?

Все данные n8n по умолчанию хранятся в директории /home/node/.n8n внутри контейнера. Для их сохранения необходимо примонтировать том (volume) или bind mount к этой директории, используя флаг -v в команде docker run или опцию volumes в Docker Compose. Например, -v n8n_data:/home/node/.n8n. Это гарантирует, что данные останутся на хосте и будут доступны новому контейнеру после пересоздания.

Какую базу данных лучше использовать: SQLite или PostgreSQL?

SQLite подходит для тестирования, персонального использования или небольших нагрузок. Для production-среды, особенно при работе в кластере (несколько воркеров) или при необходимости высокой надежности, настоятельно рекомендуется использовать внешнюю базу данных, такую как PostgreSQL или MySQL. Она обеспечивает лучшую производительность, стабильность и возможности для резервного копирования.

Как настроить планировщик (schedule) для workflows в Docker?

n8n использует встроенный планировщик, который работает "из коробки". Однако в среде с несколькими контейнерами (например, при масштабировании) это может привести к дублированию выполнения задач. Для решения этой проблемы необходимо запустить один экземпляр n8n в режиме "webhook" (EXECUTIONS_MODE=queue), а остальные — в режиме "worker" (EXECUTIONS_MODE=queue и N8N_QUEUE_BULL_REDIS_HOST), подключив их к общей очереди на основе Redis. Подробности конфигурации описаны в официальной документации n8n.

Как решить проблему с webhook, которые не работают после настройки reverse proxy?

Наиболее частые причины: неправильно настроенные заголовки прокси или переменные окружения n8n. Убедитесь, что:

1. В конфигурации Nginx/Apache корректно передаются заголовки X-Forwarded-Proto (должен быть "https") и Host.
2. В переменных окружения контейнера n8n установлены N8N_PROTOCOL=https и N8N_HOST=n8n.yourdomain.com (или используется WEBHOOK_URL).
3. Порт 5678 не открыт публично, а доступ идет только через reverse proxy.