N8n install

Установка n8n: Полное руководство по развертыванию платформы автоматизации

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

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

Перед началом установки n8n необходимо убедиться, что ваша система соответствует минимальным требованиям. n8n построен на Node.js и использует базу данных для хранения рабочих процессов, учетных данных и информации о выполнении.

• Операционная система: Linux (рекомендуется), macOS, Windows (для разработки). Для продакшн-сред предпочтительны Linux-серверы (Ubuntu 20.04/22.04 LTS, Debian, CentOS) или контейнеризированные среды (Docker).
• Node.js: Версия 18.x или выше. Версия 20.x рекомендуется для продакшн. Необходим также менеджер пакетов npm (обычно поставляется с Node.js).
• База данных (обязательно для продакшн): n8n требует внешнюю базу данных для надежной работы. Поддерживаются PostgreSQL (рекомендуется), MySQL, MariaDB, SQLite (только для тестирования).
• Ресурсы системы: Минимум 2 ГБ ОЗУ, 2 ядра CPU, 10 ГБ свободного места на диске. Требования растут в зависимости от сложности и количества параллельно выполняемых рабочих процессов.
• Сетевой доступ: Возможность исходящих HTTP/HTTPS запросов к внешним API. Для вебхуков необходим входящий доступ на выбранный порт (обычно 5678).

Метод 1: Установка с помощью npm (менеджер пакетов Node.js)

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

Шаг 1: Установка Node.js и npm

Загрузите и установите Node.js версии 18 или выше с официального сайта. После установки проверьте версии в терминале:

• node --version
• npm --version

Шаг 2: Глобальная установка n8n

Выполните следующую команду в терминале (на Linux/macOS может потребоваться sudo):

• npm install n8n -g

Флаг -g устанавливает пакет глобально, делая команду n8n доступной из любого места в системе.

Шаг 3: Запуск n8n

Для запуска в простейшем режиме (с встроенной базой SQLite) выполните:

• n8n start

После запуска веб-интерфейс будет доступен по адресу: http://localhost:5678. Первый запуск создаст файл конфигурации ~/.n8n/n8n-config.

Шаг 4: Настройка внешней базы данных (опционально, но рекомендуется)

Остановите n8n (Ctrl+C). Создайте базу данных, например, в PostgreSQL:

• CREATE DATABASE n8n;

Запустите n8n с переменными окружения, указывающими на вашу БД:

• export DB_TYPE=postgresdb
• export DB_POSTGRESDB_HOST=localhost
• export DB_POSTGRESDB_PORT=5432
• export DB_POSTGRESDB_DATABASE=n8n
• export DB_POSTGRESDB_USER=ваш_пользователь
• export DB_POSTGRESDB_PASSWORD=ваш_пароль
• n8n start

Метод 2: Установка с помощью Docker (рекомендуемый для продакшн)

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

Шаг 1: Установка Docker и Docker Compose

Установите Docker Engine и Docker Compose согласно официальной документации для вашей ОС.

Шаг 2: Запуск n8n с помощью Docker CLI

Самый простой способ запустить контейнер n8n с SQLite:

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

Для использования PostgreSQL с Docker создайте пользовательскую сеть и запустите контейнеры:

• docker network create n8n-network
• docker run -d --name n8n-postgres --network n8n-network -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=пароль -e POSTGRES_DB=n8n -v pgdata:/var/lib/postgresql/data postgres:13
• docker run -d --name n8n --network n8n-network -p 5678:5678 -e DB_TYPE=postgresdb -e DB_POSTGRESDB_HOST=n8n-postgres -e DB_POSTGRESDB_PORT=5432 -e DB_POSTGRESDB_DATABASE=n8n -e DB_POSTGRESDB_USER=postgres -e DB_POSTGRESDB_PASSWORD=пароль -e N8N_BASIC_AUTH_ACTIVE=true -e N8N_BASIC_AUTH_USER=admin -e N8N_BASIC_AUTH_PASSWORD=секрет -v n8n_data:/home/node/.n8n n8nio/n8n

Шаг 3: Использование Docker Compose (оптимальный способ)

Создайте файл docker-compose.yml:

version: '3.8'

services:
  postgres:
    image: postgres:13
    container_name: n8n_postgres
    restart: unless-stopped
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: ваш_надежный_пароль
      POSTGRES_DB: n8n
    volumes:
      - postgres_data:/var/lib/postgresql/data
    networks:
      - n8n_network

  n8n:
    image: n8nio/n8n
    container_name: n8n
    restart: unless-stopped
    ports:
      - "5678:5678"
    environment:
      N8N_PROTOCOL: https
      N8N_HOST: ваш_домен.ru
      N8N_PORT: 5678
      N8N_BASIC_AUTH_ACTIVE: true
      N8N_BASIC_AUTH_USER: admin
      N8N_BASIC_AUTH_PASSWORD: ваш_надежный_пароль_админа
      DB_TYPE: postgresdb
      DB_POSTGRESDB_HOST: postgres
      DB_POSTGRESDB_PORT: 5432
      DB_POSTGRESDB_DATABASE: n8n
      DB_POSTGRESDB_USER: postgres
      DB_POSTGRESDB_PASSWORD: ваш_надежный_пароль
      N8N_METRICS: true
      N8N_METRICS_INCLUDE_DEFAULT_METRICS: true
      EXECUTIONS_DATA_PRUNE: true
      EXECUTIONS_DATA_MAX_AGE: 168
      GENERIC_TIMEZONE: Europe/Moscow
    volumes:
      - n8n_data:/home/node/.n8n
    networks:
      - n8n_network
    depends_on:
      - postgres
    links:
      - postgres

volumes:
  postgres_data:
  n8n_data:

networks:
  n8n_network:
    driver: bridge

Запустите стек командой docker-compose up -d. Остановка: docker-compose down.

Метод 3: Установка на сервер с помощью Systemd (Продвинутый продакшн)

Этот метод подразумевает установку n8n как системного сервиса на Linux-сервере (например, Ubuntu) для автоматического запуска и управления.

Шаг 1: Установка Node.js, npm и n8n

• curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
• sudo apt-get install -y nodejs
• sudo npm install n8n -g

Шаг 2: Настройка базы данных PostgreSQL

• sudo apt-get install postgresql postgresql-contrib
• sudo -u postgres psql -c "CREATE USER n8n WITH PASSWORD 'надежный_пароль';"
• sudo -u postgres psql -c "CREATE DATABASE n8n OWNER n8n;"

Шаг 3: Создание пользователя и директории для n8n

• sudo useradd -m -d /home/n8n -s /bin/bash n8n
• sudo mkdir /home/n8n/.n8n
• sudo chown -R n8n:n8n /home/n8n/.n8n

Шаг 4: Создание файла переменных окружения

Создайте файл /etc/systemd/system/n8n.service.env с содержимым:

DB_TYPE=postgresdb
DB_POSTGRESDB_HOST=localhost
DB_POSTGRESDB_PORT=5432
DB_POSTGRESDB_DATABASE=n8n
DB_POSTGRESDB_USER=n8n
DB_POSTGRESDB_PASSWORD=надежный_пароль
N8N_BASIC_AUTH_ACTIVE=true
N8N_BASIC_AUTH_USER=admin
N8N_BASIC_AUTH_PASSWORD=надежный_пароль_админа
WEBHOOK_URL=https://ваш_домен.ru
N8N_PROTOCOL=https
N8N_HOST=ваш_домен.ru
GENERIC_TIMEZONE=Europe/Moscow

Установите права: sudo chmod 600 /etc/systemd/system/n8n.service.env

Шаг 5: Создание Systemd сервиса

Создайте файл /etc/systemd/system/n8n.service:

[Unit]
Description=n8n - workflow automation tool
Documentation=https://docs.n8n.io
After=network.target postgresql.service

[Service]
Type=simple
User=n8n
EnvironmentFile=/etc/systemd/system/n8n.service.env
ExecStart=/usr/bin/n8n start
Restart=on-failure
RestartSec=10
WorkingDirectory=/home/n8n

[Install]
WantedBy=multi-user.target

Шаг 6: Запуск и включение сервиса

• sudo systemctl daemon-reload
• sudo systemctl enable n8n.service
• sudo systemctl start n8n.service
• sudo systemctl status n8n.service (для проверки статуса)

Конфигурация и настройка безопасности

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

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

Переменная	Назначение	Пример значения
N8N_BASIC_AUTH_ACTIVE	Включает базовую HTTP аутентификацию для веб-интерфейса и API.	true
N8N_BASIC_AUTH_USER / N8N_BASIC_AUTH_PASSWORD	Логин и пароль для доступа.	admin / сложный_пароль
N8N_PROTOCOL, N8N_HOST, WEBHOOK_URL	Установка корректного публичного URL для генерации правильных ссылок на вебхуки.	https, ваш_домен.ru, https://ваш_домен.ru
N8N_ENCRYPTION_KEY	Ключ для шифрования учетных данных в базе данных. Должен быть длиной 32 символа и оставаться неизменным.	ваш_секретный_ключ_из_32_символов
EXECUTIONS_DATA_PRUNE	Включение автоматической очистки старых данных выполнений.	true
EXECUTIONS_DATA_MAX_AGE	Максимальный возраст данных выполнений в часах перед удалением.	168 (7 дней)

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

Для использования HTTPS и раздачи статики рекомендуется установить перед n8n веб-сервер Nginx. Пример конфигурации виртуального хоста:

server {
    listen 80;
    server_name ваш_домен.ru;
    return 301 https://$server_name$request_uri;
}

server {
    listen 443 ssl http2;
    server_name ваш_домен.ru;

    ssl_certificate /путь/к/вашему/ssl_certificate.crt;
    ssl_certificate_key /путь/к/вашему/ssl_certificate.key;

    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";
    }
}

Обновление n8n

Процесс обновления зависит от метода установки.

• Для npm: sudo npm update n8n -g
• Для Docker: Остановить контейнер, обновить образ (docker pull n8nio/n8n), пересоздать и запустить контейнер заново.
• Для Docker Compose: docker-compose pull n8n && docker-compose up -d
• Для Systemd: Обновить глобальный пакет npm и перезапустить сервис: sudo npm update n8n -g && sudo systemctl restart n8n

ВАЖНО: Перед обновлением в продакшн-среде обязательно создайте резервную копию базы данных и директории .n8n.

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

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

• Резервная копия базы данных: Используйте встроенные утилиты БД (например, pg_dump -U n8n n8n > n8n_backup_$(date +%Y%m%d).sql для PostgreSQL).
• Резервная копия директории .n8n: Скопируйте содержимое тома Docker или директории пользователя (например, /home/n8n/.n8n или ~/.n8n).
• Восстановление: Разверните резервную копию БД в новую БД, настройте n8n на подключение к ней и скопируйте содержимое директории .n8n на новое место.

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

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

Для продакшн-среды рекомендуется использование Docker Compose в связке с PostgreSQL. Этот метод обеспечивает изоляцию сервисов, простоту масштабирования, легкое обновление и управление конфигурацией через файл docker-compose.yml. Альтернативой является установка через Systemd на выделенном сервере, что дает больше контроля над ресурсами.

Почему n8n не запускается после установки?

Наиболее распространенные причины:

• Неверная версия Node.js. Убедитесь, что используется версия 18.x или выше.
• Порт 5678 уже занят другим приложением. Измените порт с помощью переменной N8N_PORT.
• Ошибки подключения к внешней базе данных. Проверьте хост, порт, имя пользователя, пароль и права доступа к БД.
• Отсутствие прав на запись в домашнюю директорию пользователя, от которого запускается n8n.

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

1. На старом сервере: создайте дамп базы данных PostgreSQL/MySQL. Скопируйте директорию .n8n (или соответствующий Docker volume).
2. На новом сервере: установите n8n выбранным способом. Восстановите дамп базы данных в новую БД.
3. Настройте n8n на подключение к новой БД, указав правильные параметры в переменных окружения.
4. Скопируйте содержимое директории .n8n в соответствующее место на новом сервере, сохранив права доступа.
5. Запустите n8n.

Как настроить HTTPS для n8n?

Наиболее правильный способ — использование обратного прокси (Nginx или Apache) с SSL-терминацией. Разместите SSL-сертификаты на веб-сервере и настройте проксирование запросов на локальный порт n8n (например, 5678). Убедитесь, что в настройках n8n установлены переменные N8N_PROTOCOL=https и WEBHOOK_URL=https://ваш_домен.

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

Это можно сделать на уровне обратного прокси (Nginx) с помощью директивы allow/deny или на уровне брандмауэра (например, ufw в Ubuntu). Например, в Nginx внутри блока location / добавьте: allow 192.168.1.0/24; allow 10.0.0.1; deny all;.

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

1. Используйте внешнюю БД PostgreSQL с оптимизированными настройками.
2. Увеличьте ресурсы сервера (CPU, ОЗУ).
3. Настройте переменную EXECUTIONS_DATA_PRUNE для регулярной очистки старых данных.
4. Для высоконагруженных сценариев рассмотрите возможность запуска нескольких экземпляров n8n в режиме «main» и «worker» с использованием очереди сообщений (Redis). Это требует продвинутой конфигурации.

Где хранятся логи n8n и как их просмотреть?

При запуске через Docker логи выводятся в stdout контейнера. Их можно просмотреть командой docker logs n8n. При запуске через Systemd логи управляются journald: sudo journalctl -u n8n.service -f. Уровень детализации логов можно настроить с помощью переменной окружения N8N_LOG_LEVEL (значения: debug, info, warn, error).