Как запустить n8n

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

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

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

Перед началом установки необходимо выбрать метод, который наилучшим образом соответствует вашим техническим навыкам и инфраструктуре. Основные варианты: запуск с помощью npm (Node.js Package Manager), использование Docker, установка настольного приложения или развертывание в облачных сервисах. Минимальные системные требования для работы n8n: процессор с частотой 1 ГГц или выше, не менее 2 ГБ оперативной памяти, 1 ГБ свободного места на диске и установленная операционная система (Linux, Windows, macOS) или возможность запуска контейнеров.

Метод установки	Сложность	Гибкость	Рекомендуется для
npx (npm)	Средняя	Высокая	Разработчиков, быстрого тестирования
Docker	Низкая/Средняя	Очень высокая	Продакшн-сред, изоляции окружения
Настольное приложение	Очень низкая	Низкая	Новичков, локального использования
Облачный хостинг	Низкая	Зависит от провайдера	Команд без своей инфраструктуры

Установка и запуск с помощью npm/npx

Этот метод предполагает наличие установленной среды Node.js (версии 18 или выше).

Убедитесь, что Node.js и npm установлены, выполнив в терминале команды node --version и npm --version.
Установите n8n глобально, используя npm: npm install n8n -g. Флаг -g указывает на глобальную установку, делая команду n8n доступной из любого места в системе.
Для запуска выполните команду: n8n start. По умолчанию веб-интерфейс будет доступен по адресу http://localhost:5678.

Для большей гибкости рекомендуется использовать npx, который позволяет запускать n8n без глобальной установки: npx n8n start. Это полезно для тестирования разных версий.

Установка и запуск с помощью Docker

Docker обеспечивает изолированное и воспроизводимое окружение, что является лучшей практикой для продакшн-сред.

Установите Docker Engine и Docker Compose на ваш сервер.
Для быстрого старта выполните команду: docker run -it --rm --name n8n -p 5678:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n. Эта команда создает и запускает контейнер, пробрасывает порт 5678 и монтирует том для сохранения данных.
Для продакшн-использования создайте файл docker-compose.yml.

Пример файла docker-compose.yml для n8n:


version: '3.8'
services:
  n8n:
    image: n8nio/n8n
    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
      - N8N_WEBHOOK_URL=https://your_domain.com/
      - GENERIC_TIMEZONE=Europe/Moscow
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=postgres
      - DB_POSTGRESDB_PORT=5432
      - DB_POSTGRESDB_DATABASE=n8n_db
      - DB_POSTGRESDB_USER=n8n_user
      - DB_POSTGRESDB_PASSWORD=db_password
    volumes:
      - n8n_data:/home/node/.n8n
    depends_on:
      - postgres
  postgres:
    image: postgres:15
    container_name: n8n_postgres
    restart: unless-stopped
    environment:
      - POSTGRES_USER=n8n_user
      - POSTGRES_PASSWORD=db_password
      - POSTGRES_DB=n8n_db
    volumes:
      - postgres_data:/var/lib/postgresql/data
volumes:
  n8n_data:
  postgres_data:

Для запуска стека выполните команду docker-compose up -d в директории с файлом docker-compose.yml.

Установка настольного приложения

Самый простой способ для локального использования и обучения.

Перейдите на страницу релизов n8n на GitHub или на официальный сайт.
Скачайте установщик для вашей операционной системы (Windows, macOS, Linux).
Запустите скачанный файл и следуйте инструкциям установщика.
После установки запустите приложение через меню «Пуск» или из списка программ. Интерфейс откроется в вашем браузере по стандартному адресу.

Базовая настройка после первого запуска

После успешного запуска и перехода по адресу http://localhost:5678 или вашему домену, вы увидите стартовую страницу.

Создание первого пользователя: При первом запуске без базовой аутентификации вам будет предложено создать учетную запись. Укажите имя, email и пароль. Этот пользователь станет владельцем экземпляра.
Настройка базовой аутентификации (Basic Auth): Для защиты экземпляра обязательно настройте переменные окружения N8N_BASIC_AUTH_ACTIVE, N8N_BASIC_AUTH_USER и N8N_BASIC_AUTH_PASSWORD, как показано в примере Docker Compose выше.
Настройка внешнего URL (Webhook URL): Критически важный параметр для работы триггеров, основанных на вебхуках. Указывается через переменную N8N_WEBHOOK_URL. Должен быть публичным доменным именем или адресом с пробросом портов.

Конфигурация базы данных

По умолчанию n8n использует SQLite для хранения рабочих процессов, учетных данных и данных выполнения. Для продакшн-среды настоятельно рекомендуется перейти на PostgreSQL, MySQL или MariaDB.

Переменная окружения	Описание	Пример для PostgreSQL
DB_TYPE	Тип СУБД (postgresdb, mysqldb, sqlite)	postgresdb
DB_POSTGRESDB_HOST	Хост базы данных	postgres (или localhost)
DB_POSTGRESDB_PORT	Порт базы данных	5432
DB_POSTGRESDB_DATABASE	Имя базы данных	n8n
DB_POSTGRESDB_USER	Пользователь БД	n8n_user
DB_POSTGRESDB_PASSWORD	Пароль пользователя БД	strong_password
DB_POSTGRESDB_SSL_ENABLED	Включение SSL	true

Настройка режима выполнения (Execution Mode)

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

Regular: Рабочий процесс выполняется в основном процессе. Подходит для большинства сценариев.
Queue: Основной режим для горизонтального масштабирования. Задачи ставятся в очередь (например, Redis), а затем выполняются отдельными воркерами. Требует настройки брокера сообщений.
Main: Специальный процесс, который только запускает воркеры и не выполняет workflows сам.

Для настройки режима Queue необходимо задать переменные окружения, такие как EXECUTIONS_MODE=queue, QUEUE_BULL_REDIS_HOST, QUEUE_BULL_REDIS_PORT.

Развертывание в облаке и использование образа

n8n можно развернуть на любом облачном провайдере (AWS, Google Cloud, Azure, DigitalOcean, Heroku) с помощью Docker или используя готовые шаблоны.

DigitalOcean: Используйте готовый Droplet с Docker или разверните через App Platform, указав образ n8nio/n8n и настроив переменные окружения.
AWS (EC2/ECS): Запустите EC2-инстанс, установите Docker и запустите контейнер, как описано выше. Для ECS создайте определение задачи (Task Definition) с образом n8n.
Heroku: Используйте кнопку «Deploy to Heroku» из официального репозитория, предварительно настроив Add-on для базы данных (например, Postgres).

Обновление n8n

Регулярное обновление важно для получения новых функций и исправлений уязвимостей.

Для Docker: Остановите контейнер, удалите его, обновите образ (docker pull n8nio/n8n) и запустите заново с теми же томами и настройками.
Для npm: Выполните команду npm update n8n -g.
Для настольного приложения: Приложение обычно уведомляет о доступных обновлениях и предлагает их установить.

Перед любым обновлением обязательно создайте резервную копию данных (файл SQLite или дамп базы данных).

Безопасность и мониторинг

Базовые меры безопасности для продакшн-экземпляра:

Всегда включайте Basic Auth или OAuth аутентификацию.
Настройте работу через HTTPS, используя обратный прокси (Nginx, Traefik) с SSL-сертификатом от Let’s Encrypt.
Ограничьте доступ к порту 5678 с помощью брандмауэра (например, UFW, AWS Security Groups).
Регулярно обновляйте n8n и базовый образ ОС/контейнера.
Используйте отдельные, сложные учетные данные для базы данных.
Настройте логирование и мониторинг (например, отправку логов в ELK-стек или мониторинг здоровья через endpoint /healthz).

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

Как сбросить пароль в n8n?

Если вы используете SQLite, можно воспользоваться встроенной командой: n8n user:reset --email=your-email@example.com. Для других баз данных может потребоваться прямой SQL-запрос для обновления поля password в таблице user.

Как перенести данные с SQLite на PostgreSQL?

1. Создайте дамп вашей SQLite базы (файл database.sqlite).
2. Настройте n8n на подключение к новой PostgreSQL базе через переменные окружения.
3. Запустите n8n. Он автоматически создаст схему. Данные workflows и credentials, однако, не мигрируются автоматически. Для их переноса может потребоваться использовать инструменты миграции или экспорт/импорт workflows через интерфейс.

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

Убедитесь, что переменная окружения N8N_WEBHOOK_URL установлена корректно и указывает на ваш публичный домен (например, https://n8n.yourdomain.com). Проверьте настройки обратного прокси (Nginx/Apache) и проброс портов в брандмауэре.

Как увеличить лимит памяти или времени выполнения для workflow?

Используйте переменные окружения: EXECUTIONS_DATA_MAX_TIMEOUT для увеличения максимального времени выполнения (в минутах) и EXECUTIONS_DATA_PRUNE_MAX_COUNT для контроля за количеством хранимых записей о выполнении. Для управления памятью в Docker используйте флаги -m или настройки mem_limit в docker-compose.

Как настроить кастомные узлы (Custom Nodes)?

1. Разработайте свой узел в соответствии с документацией n8n.
2. В Docker-развертывании смонтируйте директорию с узлами в контейнер по пути /home/node/.n8n/custom с помощью volumes.
3. Установите переменную окружения N8N_CUSTOM_EXTENSIONS=/home/node/.n8n/custom.
4. Перезапустите n8n. Кастомные узлы появятся в интерфейсе.

Как организовать высокую доступность (High Availability)?

Для HA требуется развернуть несколько экземпляров n8n в режиме queue. Необходимы: общая база данных (PostgreSQL), общий брокер очередей (Redis) и общее хранилище файлов (например, S3, задаваемое через N8N_BINARY_DATA_STORE). Все экземпляры должны указывать на одни и те же ресурсы. Балансировщик нагрузки (Load Balancer) распределяет HTTP-запросы между экземплярами.