Искусственный интеллект

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).

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *