Установка и обновление n8n

Есть несколько способов начать пользоваться n8n. Перечислю основные из них

  • Использование облачной версии на сайте n8n.cloud
  • Запуск (с установкой или без) на вашем компьютере
  • Установка на ваш сервер (рекомендую этот вариант, понадобится аренда VPS — читайте далее)

Облачная версия — самая простая для начала, но она платная. Запуск на устройстве немного сложнее, но зато бесплатен — правда, вы ограничены режимом работы вашего устройства. Установка n8n на сервер — самый продуктивный способ работать с n8n, поскольку тогда он будет обрабатывать ваши события 24/7. В этом случае вы оплачиваете работу VPS-сервера, обычно 200-300 руб. в месяц.

Установка на сервер может вызывать значительные затруднения у человека, далекого от ОС Linux. Поэтому в курсе вы найдете подробный гайд по установке.

Работа в облаке

Это самый простой способ начать работать с n8n. Просто зарегистрируйтесь на n8n.cloud. Технически он мало чем отличается от регистрации в приложениях Notion или AirTable.

Преимущества:

  • Нет необходимости устанавливать ваш экземпляр n8n
  • Простой апгрейд до самой последней версии n8n

У n8n.cloud нет бесплатной версии, только испытательный период. Поэтому для работы в приложении будет необходимо платить по тарифу — минимум €20.

Как обновить свой облачный n8n — смотри справку (англ.)

Запуск на компьютере

Подробное описание на английском языке находится здесь. Я не рекомендую этот способ, кроме как для этого курса n8n. Дело в том, что тогда n8n будет работать не 24/7, а лишь когда включен ваш компьютер и запущен процесс через командную строку. Каждый запуск нужно начинать из командной строки, о которой вы узнаете далее.

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

  • Установка настольной версии для Windows и Мак, которую вы можете найти на официальном сайте n8n.io
  • Запуск без установки с помощью инструмента npx. При каждом запуске скачиваются файлы приложения и потом удаляются
  • Установка на устройство с помощью инструмента npm. Файлы приложения скачиваются лишь один раз, при установке

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

Настольный клиент устанавливается очень легко и проблем с этим возникнуть не должно. Это самый простой способ начать работать с n8n. Однако ваши процессы зависят от того, включен ли компьютер и запущено ли приложение.

Установка на сервер

Самый лучший вариант — установить n8n на свой сервер, хотя бы VPS. Тогда ваше приложение n8n сможет реагировать на всевозможные триггеры в режиме 24/7. Такие серверы расшифровываются как Virtual Private Server (виртуальный частный сервер), и для наших нужд не отличаются от выделенных физических серверов.

Обратите внимание — вам не подойдет Shared-хостинг, который обычно дешевле покупки VPS. При таком хостинге у вас нет администраторского доступа и вы не сможете установить необходимые утилиты для работы n8n.

Приобрести эту услугу можно у многих провайдеров, тем более, известных:

Такая услуга может стоить от 150 р. в месяц, при этом у многих сервисов почасовая или подневная оплата. То есть если вы попользуетесь сервером 3 дня и удалите его, то и заплатите только за 3 дня. На Beget, которым пользуется автор курса, стоимость аренды самого доступного VPS — 11 рублей в день (330-341 рубль в месяц).

Процесс установки

Вкратце, установка делится на несколько шагов

  • Аренда VPS-сервера
  • Покупка доменного имени (например, example.com)
  • Подключение к серверу через интерфейс командной строки
  • Установка через командную строку программ “docker” и “docker-compose”
  • Создание в ручном режиме системных файлов и папок для работы n8n
  • Загрузка и запуск n8n через docker-compose

А теперь рассмотрим установку в подробностях

Аренда VPS-сервера

Рекомендую выбрать провайдера с доступом к файловому менеджеру, чтобы с его помощью создавать и редактировать файлы. Через командную строку человеку без знания Linux это сделать намного сложнее. Я для этого использую провайдера Beget.

Выберите ОС Ubuntu версии 18 или 20, остальные настройки выбирайте минимальные. Вам не понадобится много ресурсов для n8n.

При покупке VPS вы получите его IP-адрес. Он вам пригодится для root-доступа, что означает доступ от имени администратора. Также вы получите пароль для входа на сервер, сохраните его.

Покупка домена

Ваш будущий сервер с n8n в конечном итоге получит адрес вида n8n.my.domain, где my.domain — ваш собственный домен, например, ilovecatsanddogs.ru. Поэтому вам надо выбрать провайдера доменных имен и купить себе доменное имя, если еще у вас его еще нет. Здесь я также использую Beget, и доменное имя в ru-зоне у них стоит 200-300 рублей на год.

Подключение по SSH к серверу

Теперь вам надо подключиться через так называемое безопасное SSH-соединение к своему серверу. Как это сделать с вашей операционной системой, надо уточнять в справке у хостера вашего VPS.

Например, в моем случае хостер Beget, а операционная система — Windows. Для этого случая есть специальная статья. Необходимо установить программу PuTTy и запустить соединение с хостом вида root@ipadress, где ipadress – это IP-адрес вашего VPS-сервера.

Если у вас macOS или Linux, процесс соединения с сервером будет, очевидно, иным

Логин на сервер через командную строку

Теперь вы находитесь в интерфейсе командной строки. Скорее всего, вам понадобится ввести пароль из п.1 про VPS. При вводе пароля в командной строке символы не отражаются. Проще всего скопировать его оттуда, где он записан, и вставить в командную строку через комбинацию клавиш Shift + Ins.

Вы залогинитесь как root-пользователь, то есть пользователь с правами администратора. Кроме того, вы окажетесь в папке root корневого каталога.

Теперь мы переходим непосредственно к установке всех пакетов, необходимых для работы с n8n.

Для актуальных команд перейдите на страницу руководства и используйте его код. Весь код, который вы увидите ниже в этом разделе, может устареть — его стоит использовать только для ориентирования в процессе.

Оставляем нумерацию как в руководстве.

В руководстве строчки кода везде начинаются с sudo. Это терминология Linux и означает роль суперпользователя. Если вы являетесь пользователем Linux, то эта команда имеет смысле. Если вы заходите через PuTTy, вы являетесь root-пользователем и у вас уже есть все необходимые права.

1. Установка пакета docker

Приложение docker позволит как бы поместить ваше приложение в контейнер, со своей средой для каждого “контейнизированного” приложения. Оно необходимо для установки n8n на сервер.

Напомню, что в PuTTy, как и в командной строке, вставка производится с помощью Shift+Ins.

Поскольку мы выбрали в качестве ОС нашего сервера Ubuntu, то мы сначала выполняем следующие команды:

apt update
apt install apt-transport-https ca-certificates curl software-properties-common -y
curl -fsSL <https://download.docker.com/linux/ubuntu/gpg> | sudo apt-key add -

Далее, в зависимости от версии Ubuntu:

Для 18.04:

add-apt-repository "deb [arch=amd64] <https://download.docker.com/linux/ubuntu> bionic stable"

Для 20.04

add-apt-repository "deb [arch=amd64] <https://download.docker.com/linux/ubuntu> focal stable"

Затем вводим следующие строчки

apt update
apt upgrade -y
apt install docker-ce -y

2. Если надо запускать не от root-пользователя

Пропускаем — так как мы root-пользоваль.

3. Установка пакета docker-compose

Это дальнейшее развитие темы “контейнеризации”. Если докер позволяет создавать один контейнер, то docker-compose — уже несколько. В случае n8n нам понадобится два контейнера, поэтому без docker-compose не обойтись.

Важно! Ниже текст для Ubuntu. Кроме того, надо по ссылке посмотреть последнюю версию и подставить вместо 1.27.4

curl -L <https://github.com/docker/compose/releases/download/1.27.4/docker-compose-`uname> -s`-`uname -m` -o /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

4. Установка DNS

Обычно адрес для приложения n8n делают в виде n8n.my.domain, где my.domain — это домен, которым вы владеете.

Чтобы вы смогли заходить на адрес n8n.my.domain, вам надо перейти к регистратору, у которого вы держите свой домен, и в режиме редактирования DNS добавить A-запись со следующими параметрами:

Name (имя) n8n (или любое другое, если угодно, например app для app.my.domain)

IP-address (IP-адрес): здесь надо написать IP-адрес вашего VPS-сервера

5. Создание файла для docker-compose

Мы создадим специальный файл, который укажет docker-compose, какое именно приложение (n8n) и в каком виде мы хотим получить. Этот файл будет использован как “чертеж” для сборки нашего приложения.

Здесь нам пригодится файловый менеджер нашего сервера. Конечно, создавать и редактировать файлы можно и через командную строку, но это намного неудобнее.

Открываем файловый менеджер вашего VPS. Например, у Beget он находится здесь:

Проходим в папку root и создаем файл docker-compose.yml. Открываем редактирование и вставляем текст, на момент записи курса он выглядит так:

version: "3"

services:
  traefik:
    image: "traefik"
    restart: always
    command:
      - "--api=true"
      - "--api.insecure=true"
      - "--providers.docker=true"
      - "--providers.docker.exposedbydefault=false"
      - "--entrypoints.websecure.address=:443"
      - "--certificatesresolvers.mytlschallenge.acme.tlschallenge=true"
      - "--certificatesresolvers.mytlschallenge.acme.email=${SSL_EMAIL}"
      - "--certificatesresolvers.mytlschallenge.acme.storage=/letsencrypt/acme.json"
    ports:
      - "443:443"
    volumes:
      - ${DATA_FOLDER}/letsencrypt:/letsencrypt
      - /var/run/docker.sock:/var/run/docker.sock:ro

  n8n:
    image: n8nio/n8n
    restart: always
    ports:
      - "127.0.0.1:5678:5678"
    labels:
      - traefik.enable=true
      - traefik.http.routers.n8n.rule=Host(`${SUBDOMAIN}.${DOMAIN_NAME}`)
      - traefik.http.routers.n8n.tls=true
      - traefik.http.routers.n8n.entrypoints=websecure
      - traefik.http.routers.n8n.tls.certresolver=mytlschallenge
      - traefik.http.middlewares.n8n.headers.SSLRedirect=true
      - traefik.http.middlewares.n8n.headers.STSSeconds=315360000
      - traefik.http.middlewares.n8n.headers.browserXSSFilter=true
      - traefik.http.middlewares.n8n.headers.contentTypeNosniff=true
      - traefik.http.middlewares.n8n.headers.forceSTSHeader=true
      - traefik.http.middlewares.n8n.headers.SSLHost=${DOMAIN_NAME}
      - traefik.http.middlewares.n8n.headers.STSIncludeSubdomains=true
      - traefik.http.middlewares.n8n.headers.STSPreload=true
    environment:
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER
      - N8N_BASIC_AUTH_PASSWORD
      - N8N_HOST=${SUBDOMAIN}.${DOMAIN_NAME}
      - N8N_PORT=5678
      - N8N_PROTOCOL=https
      - NODE_ENV=production
      - WEBHOOK_TUNNEL_URL=https://${SUBDOMAIN}.${DOMAIN_NAME}/
      - GENERIC_TIMEZONE=${GENERIC_TIMEZONE}
    volumes:
      - ${DATA_FOLDER}/.n8n:/home/node/.n8n

Здесь еще два момента

Чтение и запись файлов. В дальнейшем вы можете захотеть работать с файлами — загружать их в рабочие процессы, и сохранять файлы после их обработки. Вы можете привлекать сторонние приложения вроде Google Drive. А можете использоваться хранилище своего сервера. Тогда вам понадобится специальная папка на сервере, где n8n сможет увидеть эти файлы.

Например, пусть это будет корневая папка сервера local-files. Тогда:

  • Создайте эту папку на сервере
  • Разрешите чтение и запись в неё. Например, через ПКМ на название папки в файловом менеджере → Изменить атрибуты
  • Добавьте эту строчку под volumes: - /local-files:/files
  • Теперь файлы доступны в n8n, перед названием файлов надо будет указать системный путь, прописанный в n8n: /files/:

Если вы хотите использовать папку внутри вашей папки с n8n, например, в .n8n, то можно сделать такую запись:

- ${DATA_FOLDER}/.n8n/local-files:/files

Далее, если вы не root-пользователь, то строчку надо добавить такую:

- /home/<YOUR USERNAME>/n8n-local-files:/files

В этом случае файлы будут доступны по адресу /home/<YOUR USERNAME>/n8n-local-files.

6. Создание .env-файла

Теперь, тоже через менеджер файлов, надо завести файл .env. Да, у него пустое имя, есть только расширение. Это специальный файл среды, где прописаны параметры вашей установки n8n: логин, пароль, веб-адрес и т. д. Замените параметры на свои

# папка, где будут лежать ваши сохраненные данные. Можно не менять
DATA_FOLDER=/root/n8n/

# высший домен - надо заменить на ваш домен
DOMAIN_NAME=example.com

# поддомен для n8n. Можно так и оставить, чтобы адрес был n8n.example.com
SUBDOMAIN=n8n

# DOMAIN_NAME and SUBDOMAIN combined decide where n8n will be reachable from
# above example would result in: <https://n8n.example.com>

# ваш логин - обязательно придуймайте свой!
N8N_BASIC_AUTH_USER=user

# ваш пароль - обязательно придуймайте свой!
N8N_BASIC_AUTH_PASSWORD=password

# Замените на ваш часовой пояс для работ по расписанию. Для Москвы это Europe/Moscow
# Список можно посмотреть здесь: <https://docs.trifacta.com/display/DP/Supported+Time+Zone+Values>
# Если не установлено, будет Нью-Йорк
GENERIC_TIMEZONE=Europe/Berlin

# Почтовый адрес для создания SSL-сертификата - пропишите свой контактный емейл
SSL_EMAIL=user@example.com

7. Создание папки для сохраненных данных

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

8. Запустите установку docker-compose

Финальный этап. Запускаем закачку и настройку n8n по вашим настроечным файлам из п. 5 и 6.

docker-compose up -d

Вы можете посмотреть, сколько сейчас контейнеров активно:

docker-compose ps

Должно быть два контейнера.

Если работу n8n надо по какой-то причине остановить, то используйте

docker-compose stop

9. Готово!

После установочного процесса n8n будет доступен по адресу https://n8n.my.domain. С вашим доменом вместо my.domain, конечно.

Обратите внимание. Если вас будет ошибка по этому адресу, проверьте, что написано именно https, а не http. Работа с сервером возможна только по безопасному протоколу https.

Обновление серверной установки

Когда выходит новая версия пакета, имеет смысл обновиться до неё. Вам придется делать это самостоятельно, в ручном режиме.

Способ 1

Этот способ рекомендован для версии, установленной через Docker Compose (есть и другие способы установки). Выполните по очереди три команды:

Подтяните последнюю версию

docker-compose pull

Остановите и удалите контейнеры с более старой версией

docker-compose down

Запустите контейнеры заново

docker-compose up -d

Если по каким-то причинам вам не удалось обновиться с помощью этих команд, попробуйте следующий способ.

Способ 2

Сначала подтяните новую версию n8n

docker pull n8nio/n8n

Затем остановите docker-compose, а значит, и n8n

docker-compose stop

удалите контейнеры

docker-compose rm

и запустите снова

docker-compose up -d
Следующий урок → Интерфейс редактора
Предыдущий урок → Знакомство с n8n
К курсу → Вводный курс по сервису автоматизации n8n