n8n¶

В этой статье

• n8n. Основные возможности
• Особенности сборки
• Начало работы после развертывания n8n
• Создание учетной записи администратора n8n
• Изменение монтирования томов для n8n
• Конфигурирование Traefik для доступа к n8n
• Перенос Docker-контейнеров под непривилегированного пользователя (опционально)
• Самостоятельная установка n8n на Ubuntu
• Простая настройка с помощью Bash-скрипта (развёртывание через SSH и Invapi)
• Заказ сервера с n8n с помощью API

n8n. Основные возможности¶

• Гибкость: n8n позволяет создавать сложные сценарии автоматизации. Интеграция различных приложений и сервисов через API позволяет настроить рабочие процессы и упростить рутинную работу.
• Простота использования: библиотека готовых модулей значительно упрощает создание новых рабочих процессов.
• Удобство: n8n предоставляет возможность запуска и тестирования рабочих процессов непосредственно из интерфейса, что позволяет быстро проверять корректность работы сценария и устранять ошибки.
• Надежность: n8n обеспечивает надежность выполнения рабочих процессов, позволяя настраивать повторное выполнение задач в случае неудачного завершения.
• Расширяемость: благодаря открытому исходному коду, n8n может быть легко расширен за счет создания новых модулей интеграции с другими сервисами.

Особенности сборки¶

• Время на установку 15-20 минут вместе с OS;
• Контейнеризированная установка в зоне hostkey.in;
• Веб-интерфейс будет доступен по url: https://n8n{Server_ID_from_Invapi}.hostkey.in;
• Используется контейнер Traefik для управления маршрутизацией и SSL-сертификатами;
• Конфигурационный файл находится в директории /root/n8n-compose-file/compose.yml.

Начало работы после развертывания n8n¶

После оплаты заказа на указанную при регистрации электронную почту придет уведомление о готовности сервера к работе. В нем будет указан IP-адрес VPS, а также логин и пароль для подключения. Управление оборудованием клиенты нашей компании осуществляют в панели управления серверами и API — Invapi.

Данные для авторизации, которые можно найти или во вкладке Информация >> Тэги панели управления сервером или в присланном e-mail:

• Ссылка для доступа к панели управления n8n с веб-интерфейсом: в теге webpanel;
• Логин и Пароль для управления сервером: приходят в письме на вашу электронную почту при готовности сервера к работе после развертывания ПО.

Создание учетной записи администратора n8n¶

После установки Docker-контейнера с n8n необходимо выполнить первоначальную настройку через веб-интерфейс. При первом посещении веб-интерфейса n8n вам будет предложено создать учетную запись владельца:

• Введите ваш email-адрес;
• Укажите имя и фамилию;
• Создайте надежный пароль (минимум 8 символов, как минимум 1 цифра и 1 заглавная буква);
• При желании можно включить получение уведомлений о безопасности и обновлениях продукта;
• Нажмите кнопку Next.

Затем будет открыто окно для настройки персонализации:

• "What best describes your company?" (Что лучше всего описывает вашу компанию?);
• "Which role best describes you?" (Какая роль лучше всего описывает вас?);
• "Who will your automations mainly be for?" (Для кого в основном будут создаваться автоматизации?);
• "How big is your company?" (Какого размера ваша компания?);
• "How did you hear about n8n?" (Как вы узнали о n8n?).

После заполнения всех полей необходимо нажать кнопку Get started.

Активация бесплатной лицензии (опционально)

n8n предлагает бесплатную активацию некоторых премиум-функций:

• Возможность просмотра истории рабочих процессов (за последние 24 часа);
• Расширенные возможности отладки для исправления ошибок в рабочих процессах;
• Поиск и тегирование для организации выполненных рабочих процессов.

Для получения бесплатного ключа лицензии:

• Введите ваш email в соответствующее поле;
• Нажмите кнопку Send me a free license key или пропустите этот шаг, нажав Skip. Если выбран вариант с отправкой улюча, то он придет на указанную почту:

• Для активации ключа нажмите кнопку Activate License Key в письме или скопируйте ключ и введите его в соответствующем разделе настроек n8n.

Главный экран и уведомление о лицензии:

После завершения первоначальной настройки вы попадете на главный экран n8n:

• В верхней части экрана отображается обзор всех доступных вам рабочих процессов, учетных данных и выполнений;
• На главном экране вы можете выбрать, с чего начать: создать рабочий процесс с нуля или протестировать готовый пример с ИИ-агентом;
• В правом нижнем углу будет показано уведомление о том, что ваш лицензионный ключ находится в пути, и вам нужно проверить электронную почту (если ранее был выбран вариант с отправкой ключа).

Изменение монтирования томов для n8n¶

Правильное монтирование томов в Docker-контейнерах с n8n важно не только для сохранения данных между перезапусками, но и для обеспечения бесперебойной работы при обновлении версии n8n, миграции на другой сервер, создания резервных копий, упрощения отладки и диагностики, возможности внешнего редактирования workflows, интеграции с CI/CD процессами и надежного развертывания в кластерных средах.

1. Отредактируйте файл compose.yml:

   nano /root/n8n-compose-file/compose.yml
   

   Для проверки расположения файла можно использовать команду:

   find / -name "docker-compose.yml" -o -name "compose.yml" 2>/dev/null
   

   2. Измените строку монтирования тома для n8n:

   - /root/.n8n:/root/.n8n
   

   

2. Обновите образы контейнеров:

   cd /root/n8n-compose-file/
   

   docker compose pull
   

3. Перезапустите контейнеры:

   docker compose down
   

   docker compose up -d
   

Конфигурирование Traefik для доступа к n8n¶

Для обеспечения доступа к n8n через доменное имя необходимо настроить Traefik для перенаправления трафика.

1. Отредактируйте файл compose.yml:

   nano /root/n8n-compose-file/compose.yml
   

2. Добавьте или измените метки для контейнера n8n:

   labels:
     - "traefik.enable=true"
     - "traefik.http.routers.n8n.rule=Host(`ваш-домен.com`)"
     - "traefik.http.routers.n8n.entrypoints=websecure"
     - "traefik.http.routers.n8n.tls=true"
     - "traefik.http.services.n8n.loadbalancer.server.port=5678"
   

   

3. Обновите образы контейнеров:

   cd /root/n8n-compose-file/
   

   docker compose pull
   

4. Перезапустите контейнеры:

   docker compose down
   

   docker compose up -d
   

Перенос Docker-контейнеров под непривилегированного пользователя (опционально)¶

Для повышения безопасности рекомендуется запускать Docker-контейнеры не от имени root пользователя.

1. Создайте нового пользователя:

   adduser n8n_user
   

2. Добавьте пользователя в группу docker:

   usermod -aG docker n8n_user
   

3. Перенесите данные n8n:

   mkdir -p /home/n8n_user/n8n
   

   cp -r /root/.n8n/* /home/n8n_user/n8n/
   

   chown -R n8n_user:n8n_user /home/n8n_user/n8n
   

4. Скопируйте файлы конфигурации:

   cp -r /root/n8n-compose-file /home/n8n_user/
   

   chown -R n8n_user:n8n_user /home/n8n_user/n8n-compose-file
   

5. Измените путь монтирования в compose.yml:

   sed -i 's|/root/.n8n:/root/.n8n|/home/n8n_user/n8n:/root/.n8n|g' /home/n8n_user/n8n-compose-file/compose.yml
   

6. Обновите образы контейнеров:

   su - n8n_user
   

   cd ~/n8n-compose-file
   

   docker compose pull
   

7. Запустите контейнеры от имени нового пользователя:

   docker compose up -d
   

Самостоятельная установка n8n на Ubuntu¶

1. Обновите системные пакеты:

   sudo apt update && sudo apt upgrade -y 
   

2. Установите Docker Engine:

   sudo apt install docker.io -y
   

3. Проверьте установку Docker:

   docker version
   

4. Установите плагины Docker Compose

   mkdir -p ~/.docker/cli-plugins/
   curl -SL https://github.com/docker/compose/releases/download/v2.31.0/docker-compose-linux-x86_64 -o ~/.docker/cli-plugins/docker-compose
   chmod +x ~/.docker/cli-plugins/docker-compose
   

   Замените v2.31.0 на последнюю версию из GIT репозитория.
5. Создайте необходимые каталоги:

   mkdir /data && mkdir /root/n8n-compose-file
   chmod 700 /data && chmod 700 /root/n8n-compose-file
   

6. Сгенерируйте файл compose.yml: Создайте файл с именем compose.yml в каталоге /root/n8n-compose-file и вставьте в него следующее содержимое:

   version: "3"
   services:
   n8n:
       image: docker.n8n.io/n8nio/n8n:latest
       restart: always
       user: root
       ports:
       - "5678:5678" 
       environment:
       - N8N_HOST=<ваш-ip-сервера> 
       - N8N_PORT=5678
       - N8N_PROTOCOL=http
       - NODE_ENV=production
       - WEBHOOK_URL=http://<ваш-ip-сервера>/
       - GENERIC_TIMEZONE="Europe/Amsterdam"
       - N8N_SECURE_COOKIE=false
       volumes:
       - /root/.n8n:/home/node/.n8n
       - /root/local-files:/files
   

   Замените <ваш-ip-сервера> на фактический IP-адрес вашего сервера. Вы можете получить его через командную строку:

   hostname -I | awk '{print $1}'
   

7. Запустите n8n через Docker Compose:

   cd /root/n8n-compose-file
   docker compose up -d 
   

8. Подождите, пока n8n запустится: Подождите примерно 10 секунд, пока n8n инициализируется и начнёт прослушивание на порту 5678.
9. Получите доступ к веб-интерфейсу n8n: Откройте веб-браузер и перейдите по адресу https://ваш-ip-сервера:443. (Замените ваш-ip-сервера на фактический IP-адрес вашего сервера). Вам будет предложено выполнить начальную настройку и ввести учётные данные для входа.

Простая настройка с помощью Bash-скрипта (развёртывание через SSH и Invapi)¶

#!/bin/bash
# Обновление системы
sudo apt update -y
# Установка Docker Engine
sudo apt install docker.io -y
# Проверка установки Docker
docker version
# Установка плагинов Docker Compose
mkdir -p ~/.docker/cli-plugins/
curl -SL https://github.com/docker/compose/releases/download/v2.31.0/docker-compose-linux-x86_64 -o ~/.docker/cli-plugins/docker-compose
chmod +x ~/.docker/cli-plugins/docker-compose
# Создание необходимых каталогов
mkdir /data && mkdir /root/n8n-compose-file
chmod 700 /data && chmod 700 /root/n8n-compose-file
# Получение IP-адреса сервера
IP_ADDRESS=$(hostname -I | awk '{print $1}')
# Генерация файла compose.yml
cat > /root/n8n-compose-file/compose.yml <<EOF
version: "3"
services:
  n8n:
    image: docker.n8n.io/n8nio/n8n:latest
    restart: always
    user: root
    ports:
      - "5678:5678" 
    environment:
      - N8N_HOST=$IP_ADDRESS> 
      - N8N_PORT=5678
      - N8N_PROTOCOL=http
      - NODE_ENV=production
      - WEBHOOK_URL=http://$IP_ADDRESS/
      - GENERIC_TIMEZONE="Europe/Amsterdam"
      - N8N_SECURE_COOKIE=false
    volumes:
      - /root/.n8n:/home/node/.n8n
      - /root/local-files:/files
EOF
# Запуск n8n через Docker Compose
cd /root/n8n-compose-file
docker compose up -d 

Использование скрипта в командной строке BASH¶

• Подключитесь к вашему серверу через SSH.
• Сохраните скрипт в файле с расширением .sh (например, install.sh).
• Сделайте его исполняемым: chmod +x install.sh.
• Запустите скрипт на вашем сервере: ./install.sh.

• Используйте http://ваш-ip-сервера:5678 для подключения к веб-интерфейсу. Вы можете получить ваш IP через командную строку:

  hostname -I | awk '{print $1}'
  

  Использование скрипта при переустановке сервера¶

• Запустите конфигуратор переустановки, нажав на кнопку Переустановить сервер на вкладке Переустановка в карточке сервера Invapi.

• Выберите желаемую ОС на вкладке Операционная система.
• Вставьте скрипт для поддерживаемой ОС в поле Post-install script на вкладке Дополнительные настройки.
• Запустите переустановку, нажав кнопку Переустановить этот сервер

Заказ сервера с n8n с помощью API¶

Для установки данного ПО с использованием API следуйте этой инструкции.