Глава 1. Знакомство с n8n

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

Что такое n8n?

Представьте задачу: каждый день в 9:00 нужно забирать данные из Google Sheets, фильтровать строки и отправлять часть из них в Slack. Написать это «руками» — скрипт, планировщик, обработка ошибок — займёт несколько часов. В n8n — пятнадцать минут.

n8n (произносится «n-eight-n») позволяет соединять сервисы и API через визуальный редактор. Каждый шаг — это нода (узел), ноды соединяются стрелками, образуя воркфлоу (рабочий поток).

Чем n8n отличается от Zapier и Make?

n8n можно развернуть на собственном сервере — ваши данные никуда не уходят. Кроме того, в любой ноде доступен полноценный JavaScript, а не только визуальный конструктор.

Ключевые концепции

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

Понятие	Что это
Воркфлоу Workflow	Полный сценарий автоматизации — набор нод и соединений. Можно активировать или запускать вручную.
Нода Node	Один шаг: запрос к API, трансформация данных, отправка письма. У каждой ноды есть вход и выход.
Триггер Trigger	Специальная нода, с которой начинается воркфлоу: расписание, webhook, новое письмо.
Коннектор Connection	Стрелка между нодами. Определяет, куда передаются данные. Возможно ветвление.

Установка

Есть три способа запустить n8n. Docker — самый простой и рекомендуемый.

Docker (рекомендуется)

Запустите контейнер одной командой. Данные воркфлоу сохранятся в домашней директории:

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

После запуска откройте http://localhost:5678 в браузере.

Совет

Флаг --rm удаляет контейнер после остановки, но данные остаются в ~/.n8n на хосте. Для продакшена используйте docker compose с настройкой restart: unless-stopped.

Пример docker-compose.yml для постоянного запуска:

version: "3.8"
services:
  n8n:
    image: n8nio/n8n
    restart: unless-stopped
    ports:
      - "5678:5678"
    volumes:
      - ~/.n8n:/home/node/.n8n
    environment:
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=yourpassword

npm / npx

Если Docker недоступен, запустить n8n можно через Node.js версии 18 и выше:

# Однократный запуск без установки
npx n8n

# Или установить глобально
npm install -g n8n
n8n start

n8n Cloud

Если не хочется заниматься инфраструктурой, на n8n.io доступен управляемый облачный хостинг. Бесплатный пробный период — 14 дней.

Интерфейс редактора

После первого входа вы окажетесь на холсте (canvas) — рабочей области, где строятся воркфлоу:

• Левая панель — список воркфлоу, credentials, настройки.
• Холст — область нод. Перетаскивайте ноды, соединяйте их мышью.
• Кнопка + — добавить ноду. Появляется при клике на холст или при протягивании соединения.
• Панель выполнения — внизу экрана. Показывает историю запусков, ошибки и время каждой ноды.

Первый вход

При первом запуске n8n попросит создать учётную запись администратора. Используйте надёжный пароль — через этот аккаунт управляются все credentials и API-ключи.

---

В следующей главе мы построим первый реальный воркфлоу: запросим погоду и отправим её в Telegram.