N8n how to use

Полное руководство по использованию n8n: от установки до сложных сценариев

N8n — это инструмент с открытым исходным кодом для оркестрации рабочих процессов (workflow automation), который использует парадигму низкого кода (low-code). Его отличительная черта — архитектура, основанная на узлах (nodes). Каждый узел выполняет определенную функцию, например, получает данные из приложения, обрабатывает их или отправляет в другую систему. Узлы соединяются между собой, образуя рабочий процесс (workflow). N8n поддерживает более 350 встроенных узлов для популярных сервисов (Google Sheets, Slack, Telegram, Notion, HTTP-запросы и т.д.), а также позволяет создавать собственные узлы.

Установка и начальная настройка n8n

N8n можно развернуть несколькими способами. Выбор зависит от ваших технических навыков и требований к инфраструктуре.

• Docker (рекомендуемый способ): Самый простой и быстрый вариант для начала работы. Убедитесь, что у вас установлен Docker, и выполните команду: docker run -it --rm --name n8n -p 5678:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n. После этого n8n будет доступен по адресу http://localhost:5678.
• npm/npx: Для разработчиков, предпочитающих npm. Установка выполняется командой: npm install n8n -g. Запуск: n8n start.
• Развертывание на собственном сервере (VPS): Требует настройки обратного прокси (например, Nginx), SSL-сертификата и, часто, менеджера процессов (PM2). Это оптимальный вариант для постоянного использования в продакшене.
• Облачный хостинг n8n: Официальный облачный сервис от создателей n8n с управляемой инфраструктурой, обновлениями и резервным копированием.

После первого входа в веб-интерфейс (обычно по адресу http://localhost:5678) вы увидите пустой холст (canvas) для создания рабочих процессов. Рекомендуется сразу настроить базовые параметры, такие как путь к данным, шифрование учетных данных и переменные окружения, через файл конфигурации .n8n/config или переменные среды Docker.

Архитектура и ключевые концепции

Понимание основных элементов n8n критически важно для эффективной работы.

• Рабочий процесс (Workflow): Основная единица автоматизации. Представляет собой последовательность узлов, выполняющих задачи.
• Узел (Node): Базовый строительный блок. Каждый узел имеет тип (триггер, действие, логика), входы и выходы. Узлы соединяются между собой связями (connections).
• Триггерный узел (Trigger Node): Запускает рабочий процесс. Примеры: Schedule Trigger (по расписанию), Webhook Trigger, Google Sheets Trigger.
• Узел действия (Action Node): Выполняет конкретную операцию: получение, отправку или преобразование данных.
• Данные (Items): Информация, которая передается между узлами. Обычно представляет собой массив объектов JSON. Каждый элемент массива — отдельный «item».
• Выражения (Expressions): Механизм для динамического доступа к данным и вычислений. Использует синтаксис двойных фигурных скобок {{ }}. Например, {{ $json["field_name"] }}.

Создание первого рабочего процесса: пошаговый пример

Рассмотрим создание простого рабочего процесса, который каждое утро в 9:00 получает случайную цитату с публичного API и отправляет ее в канал Slack.

1. Добавление триггера: Перетащите на холст узел «Schedule Trigger». Откройте его настройки. Установите правило (Rule) на «Every Day» и время (Hour) на 9, (Minute) на 0. Этот узел будет запускать весь процесс ежедневно в 9:00.
2. Добавление узла для получения данных: Перетащите узел «HTTP Request». Соедините выход Schedule Trigger с входом HTTP Request. Настройте узел:
   • Method: GET
   • URL: https://api.quotable.io/random

   Этот узел сделает запрос к API и получит цитату в формате JSON.

3. Обработка данных (опционально): Добавьте узел «Set». С его помощью можно переформатировать данные. Например, создать новое поле message со значением выражения {{ $json.content }} — {{ $json.author }}.
4. Отправка результата в Slack: Перетащите узел «Slack». Выберите действие «Send Message». При первом использовании вам потребуется создать учетные данные (Credentials) для Slack, добавив токен доступа (Bot User OAuth Token). Настройте узел:
   • Channel: выберите или введите ID канала (например,
     

     general).

   • Text: Используйте выражение {{ $json.message }} (если использовали узел Set) или {{ $json.content }} — {{ $json.author }}.
5. Активация и тестирование: В правом верхнем углу нажмите кнопку «Activate» (требуется в облачной версии или при использовании внешнего вебхука). Для немедленного тестирования нажмите кнопку «Execute Workflow» на узле триггера. Результат выполнения каждого узла можно просмотреть, кликнув на него.

Продвинутые техники и логика

N8n позволяет создавать сложные, ветвящиеся рабочие процессы с использованием логических узлов.

Узел	Назначение	Пример использования
IF	Разделяет поток данных на две ветки (true/false) на основе условия.	Если сумма заказа > 10000, отправить уведомление менеджеру, иначе — обычное подтверждение.
Switch	Разделяет поток на множество веток в зависимости от значения поля (аналог switch/case в программировании).	Маршрутизация тикетов по отделам в зависимости от категории: «billing», «technical», «general».
Merge	Объединяет несколько потоков данных в один. Есть несколько режимов: «Append», «Merge By Index», «Merge By Key».	Объединение данных из Google Sheets и ответа от HTTP-запроса перед отправкой в отчет.
Loop Over Items	Последовательно обрабатывает каждый элемент массива (item) внутри подпотока (loop).	Для каждого нового email из триггера проверить контакт в CRM и создать карточку задачи.
Code (JavaScript/ Python)	Позволяет выполнить произвольный код для сложных преобразований или логики, которую невозможно реализовать стандартными узлами.	Парсинг сложного HTML, специальные математические вычисления, работа с буферами данных.

Управление данными и выражения

Выражения — мощный инструмент для работы с данными внутри узлов. Они позволяют ссылаться на выходные данные предыдущих узлов, переменные окружения и выполнять функции.

• Доступ к данным:
  • $json — данные, полученные от предыдущего узла (например, $json["email"]).
  • $input — данные с входа узла (полезно в узлах типа Code).
  • $node — доступ к выходным данным других узлов по имени (например, $node["HTTP Request"].json["quote"]).
  • $env — переменные окружения (например, $env.API_KEY).
  • $now — текущая дата и время.
• Функции: В выражениях доступен широкий набор встроенных функций для работы со строками, датами, числами и массивами.
  • {{ $json.title.toUpperCase() }} — преобразует строку в верхний регистр.
  • {{ new Date().toISOString().split('T')[0] }} — получает текущую дату в формате YYYY-MM-DD.
  • {{ Math.random() > 0.5 ? "Да" : "Нет" }} — условный (тернарный) оператор.

Обработка ошибок и отладка

Надежный рабочий процесс должен корректно обрабатывать сбои. N8n предоставляет для этого несколько механизмов.

• Встроенная отладка: Каждый узел после выполнения показывает детальную информацию: входные/выходные данные, статус выполнения, время. Клик на узел открывает панель просмотра.
• Узел «Error Trigger»: Специальный триггер, который активирует подпоток (ветку) в случае ошибки в любом месте основного рабочего процесса. Это позволяет централизованно логировать ошибки или отправлять уведомления.
• Настройка повторных попыток (Retry): Для каждого узла можно задать политику повторных попыток при временных сбоях (например, при ошибках сети).
• Ручное тестирование: Рабочий процесс можно запустить вручную с любого узла, используя кнопку «Execute Node». Это позволяет тестировать отдельные части сценария.

Администрирование и продакшен-использование

При промышленной эксплуатации необходимо решить ряд задач.

• Управление учетными данными (Credentials): Все ключи API и пароли хранятся в зашифрованном виде. Доступ к ним можно ограничивать на уровне рабочего пространства (workspace).
• Переменные окружения (Environment Variables): Используются для хранения конфиденциальных данных (ключей, URL) и параметров, зависящих от окружения (dev/prod). Доступны в выражениях через $env.
• Версионирование и миграция: Рабочие процессы можно экспортировать в виде JSON-файла и импортировать в другую инстанцию n8n. Это основной способ переноса и бэкапа.
• Мониторинг и логи: В журнале выполнения (Execution History) сохраняются все запуски, их статус и данные. Для облачной версии доступны расширенные метрики. Для self-hosted можно настроить внешние системы мониторинга через webhooks или отправку логов.
• Масштабирование: Self-hosted версию можно запустить в режиме «webhook» и «worker» на разных серверах для распределения нагрузки, используя внешнюю очередь (например, Redis) и базу данных (PostgreSQL).

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

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

N8n — это open-source решение с возможностью self-hosting, что дает полный контроль над данными и инфраструктурой. Оно предлагает более гибкую модель ценообразования (бесплатно при самостоятельном хостинге) и более мощные возможности для программистов благодаря узлу Code и детальному контролю над потоком данных. Zapier и Make — это проприетарные облачные сервисы с более простым интерфейсом, но менее гибкие и с ограничениями по тарифам.

Можно ли использовать n8n без программирования?

Да, для большинства стандартных интеграций (например, «при получении письма создать задачу в Trello») программирование не требуется. Интерфейс drag-and-drop и предварительно настроенные узлы позволяют создавать рабочие процессы. Однако для сложных преобразований данных или интеграции с системами, не имеющими готового узла, могут потребоваться базовые навыки работы с JSON и JavaScript/Python в узле Code.

Как организовать взаимодействие между несколькими рабочими процессами?

Есть несколько способов:

1. Использовать узел «Webhook» для запуска одного рабочего процесса из другого.
2. Использовать общее хранилище данных (например, базу данных, Google Sheets), из которого будут читать разные процессы.
3. В enterprise-версии n8n есть специальные возможности для вызова подпроцессов (Sub-workflow).

Где хранятся данные, обрабатываемые в n8n?

При использовании self-hosted версии все данные остаются на вашем сервере. По умолчания метаданные рабочих процессов и журнал выполнения хранятся во встроенной SQLite базе данных. Для продакшена рекомендуется переключиться на PostgreSQL. Данные, передаваемые между узлами во время выполнения, по умолчанию не сохраняются на диск (кроме журнала ошибок), если не настроено специальное логирование.

Как обеспечить безопасность n8n при развертывании на собственном сервере?

• Обязательно настройте обратный прокси (Nginx, Apache) с SSL-сертификатом (HTTPS).
• Используйте сложный пароль для базовой аутентификации или настройте OAuth (доступно в настройках).
• Регулярно обновляйте n8n до последней версии.
• Используйте переменные окружения для хранения секретов, не храните их в самом рабочем процессе.
• Ограничьте доступ к порту, на котором работает n8n, с помощью брандмауэра.

Что делать, если для нужного мне сервиса нет готового узла?

Вы можете:

1. Использовать универсальные узлы «HTTP Request» или «Webhook» для взаимодействия с API сервиса напрямую.
2. Создать собственный узел на TypeScript/JavaScript. Документация n8n предоставляет подробное руководство по разработке custom nodes.
3. Поискать community-узлы в официальном репозитории или на форуме n8n.

Как организовать запуск рабочего процесса по событию из внешней системы?

Для этого используется узел «Webhook Trigger». В его настройках генерируется уникальный URL. Этот URL необходимо указать в настройках внешней системы (например, в разделе «Webhooks» вашего приложения). При наступлении события внешняя система отправит HTTP-запрос на этот URL, и n8n запустит связанный рабочий процесс.