N8n как пользоваться

N8n: Полное руководство по использованию

N8n — это инструмент для автоматизации рабочих процессов с открытым исходным кодом, использующий парадигму workflow-as-code. Его отличительная черта — нодная (узловая) архитектура, где каждый узел (нода) представляет собой отдельное действие: триггер, операцию или функцию. Платформа предназначена для соединения различных сервисов, баз данных и API между собой без необходимости писать код, хотя и предоставляет такую возможность для гибкой настройки.

Основные концепции и интерфейс

Рабочее пространство N8n организовано вокруг воркфлоу (рабочих процессов). Каждый воркфлоу — это цепочка узлов, соединенных между собой. Интерфейс состоит из нескольких ключевых областей:

• Панель навигации слева: Содержит разделы: Workflows (Воркфлоу), Executions (Запуски), Settings (Настройки).
• Центральная канва: Область для проектирования workflow путем перетаскивания узлов.
• Правая панель свойств: Отображает параметры выбранного узла или настройки всего воркфлоу.
• Верхняя панель управления: Кнопки для сохранения, запуска, активации триггера и экспорта/импорта воркфлоу.

Создание первого рабочего процесса (Workflow)

Процесс начинается с создания нового воркфлоу. Рассмотрим создание автоматизации, которая сохраняет вложения из новой почты Gmail в Google Диск.

1. Добавление триггерного узла: На канве нажмите кнопку «+» или начните вводить название узла. Найдите и добавьте узел «Gmail Trigger». Этот узел будет периодически проверять входящие письма. В его настройках необходимо пройти аутентификацию в сервисе Google, выбрав Scope для чтения писем, и настроить фильтр, например, «is:unread».
2. Добавление узла для обработки: Добавьте узел «Function» или «IF» для фильтрации писем по отправителю или теме, если это требуется. Это опциональный шаг для демонстрации логики.
3. Добавление узла-действия: Найдите и добавьте узел «Google Drive». Выберите операцию «Upload». Настройте аутентификацию с Google Диском. В поле «File Path» укажите путь для сохранения. Важный момент: для выбора файла для загрузки используйте выражение. Нажмите на иконку шестеренки рядом с полем «File Binary Data» и выберите «Expression».
4. Связывание узлов и передача данных: Соедините выход триггера Gmail с входом узла Google Drive. В редакторе выражений для «File Binary Data» найдите данные от предыдущего узла. Выражение будет выглядеть подобно {{ $node["Gmail Trigger"].json["attachments"][0]["content"] }}, где индекс [0] указывает на первое вложение. Для имени файла можно использовать выражение {{ $node["Gmail Trigger"].json["attachments"][0]["filename"] }}.
5. Тестирование и активация: Нажмите кнопку «Execute Workflow» для ручного тестового запуска. Проверьте Execution Log на правой панели. Если все работает, переключите воркфлоу в активный режим, нажав переключатель «Active» в верхней панели. Теперь он будет работать автоматически по расписанию, заданному в триггере.

Ключевые типы узлов и их назначение

Узлы в N8n делятся на категории. Понимание их предназначения — основа построения эффективных автоматизаций.

Категория узлов	Описание и примеры	Ключевое назначение
Триггеры (Trigger)	Запускают воркфлоу по событию или расписанию. Примеры: Schedule Trigger, Webhook, Email Trigger (IMAP, Gmail), Telegram Trigger.	Инициирование выполнения workflow. Должен быть только один на воркфлоу (если не используется ветвление).
Действия (Actions)	Выполняют операции с внешними сервисами. Примеры: HTTP Request, Google Sheets, Slack, Notion, PostgreSQL.	Основная «рабочая» логика: получение, отправка, изменение данных.
Преобразования (Transform)	Обрабатывают и меняют данные внутри workflow. Примеры: Date & Time, агрегатор Spreadsheet File, XML/JSON преобразователи.	Изменение формата, структуры или содержания данных, проходящих через workflow.
Логика (Logic)	Управляют потоком выполнения. Примеры: IF (условие), Switch (множественное условие), Merge (объединение веток), Wait (пауза).	Создание сложной логики, ветвление, синхронизация параллельных потоков.
Утилиты (Utility)	Вспомогательные функции. Примеры: Function/Function Item (пользовательский код на JS), Webhook Response, Convert to File.	Выполнение кастомной логики на коде, отправка ответа вебхуку, отладка.

Работа с данными: Выражения (Expressions) и контекст

Мощь N8n раскрывается при использовании выражений для динамической подстановки данных. Данные в workflow передаются от узла к узлу в формате JSON. Каждый узел получает на вход массив объектов (items). Для доступа к данным используются выражения в двойных фигурных скобках {{ }}.

• Контекст выполнения: Система предоставляет несколько контекстных переменных:
  • $json: Данные, полученные от предыдущего узла в текущем элементе выполнения (item). Например, {{ $json.subject }} для доступа к полю subject.
  • $node: Позволяет обращаться к данным любого узла в workflow по его имени. Например, {{ $node["Название узла"].json["поле"] }}.
  • $items(): Функция для доступа к данным всех элементов на определенном этапе workflow.
  • $now: Текущая дата и время.
  • $env: Доступ к переменным окружения.
• Функции: В выражениях доступны встроенные функции для работы со строками, числами, датами и массивами. Например: {{ $json.title.toUpperCase() }} или {{ new Date().toISOString().slice(0,10) }}.

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

N8n предоставляет инструменты для диагностики проблем.

• Панель Execution Log: При запуске workflow справа открывается панель, где для каждого узла отображается статус (успех, ошибка), входные и выходные данные. Это основной инструмент отладки.
• Узел «Error Trigger»: Позволяет создать отдельную ветку workflow, которая будет выполняться только в случае ошибки в основной цепи. Это механизм обработки исключений.
• Настройка повторных попыток (Retry): В настройках узла (вкладка «Options») можно задать количество повторных попыток при сбое и интервал между ними.
• Валидация данных: Используйте узлы логики (IF) для проверки наличия ожидаемых полей в данных перед их передачей в следующий узел.

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

Для построения сложных систем автоматизации необходимо освоить следующие концепции:

• Ветвление и слияние: Узел «Split In Batches» разбивает большой массив данных на пакеты для обработки без превышения лимитов API. Узел «Merge» объединяет результаты параллельных веток.
• Итерация по данным: Многие узлы (например, «HTTP Request») могут работать в режиме «Execute Once», обрабатывая все входящие элементы, или «Execute Once for Each», выполняя отдельный запрос для каждого элемента массива.
• Переменные окружения и безопасности: Никогда не храните пароли и API-ключи прямо в настройках узлов. Используйте переменные окружения, доступные через выражение {{ $env.ИМЯ_ПЕРЕМЕННОЙ }}. Их можно задать в настройках N8n (Settings -> Environment Variables).
• Экспорт и импорт: Workflow можно экспортировать в JSON-файл через меню в правом верхнем углу канвы. Это позволяет переносить автоматизации между инстансами, делиться ими и хранить в системе контроля версий (Git).

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

В чем основное отличие N8n от Zapier и Make (Integromat)?

N8n — open-source решение, которое можно развернуть на собственном сервере, что обеспечивает полный контроль над данными и неограниченное количество операций. Zapier и Make — облачные SaaS-сервисы с платной подпиской, основанной на объеме операций. N8n предлагает более гибкую логику и низкоуровневый доступ через узлы вроде HTTP Request и Function.

Как организовать расписание выполнения workflow без триггера?

Для этого существует отдельный узел «Schedule Trigger». В его настройках можно указать cron-выражение (например, «0 9 1» для запуска каждый понедельник в 9:00) или простой интервал (каждые 30 минут).

Можно ли использовать N8n как вебхук-приемник (webhook receiver)?

Да. Для этого используйте узел «Webhook». При его добавлении N8n сгенерирует уникальный URL. При активации workflow этот URL будет ожидать входящих HTTP-запросов (POST/GET) и передавать их данные следующим узлам. Для ответа отправителю используйте узел «Webhook Response» в конце цепи.

Как обрабатывать большие объемы данных без потери производительности?

Избегайте режима «Execute Once for Each» для очень больших массивов. Используйте узлы «Split In Batches» для пакетной обработки. Настройте «Concurrency» (параллельное выполнение) в настройках узла, чтобы не превышать лимиты внешних API. Для ресурсоемких операций рассмотрите использование очередей (например, через Redis) и нескольких экземпляров N8n.

Как реализовать ветвление логики (if-else) в N8n?

Используйте узел «IF». В его настройках задаются два или более условия. Каждое условие определяет отдельную исходящую ветку. Данные будут направлены по той ветке, условие которой выполнится первым. Узел «Switch» позволяет создавать более сложные множественные ветвления.

Можно ли писать собственный код в N8n?

Да, с помощью узлов «Function» и «Function Item». Они позволяют выполнять JavaScript код. «Function» работает со всем массивом items сразу, а «Function Item» — итерируется по каждому элементу отдельно. Это дает возможность выполнять любые манипуляции с данными, которые не покрыты стандартными узлами.

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

В настройках N8n (Settings -> Users) можно создать нескольких пользователей с разными ролями (Owner, Member). Для enterprise-нужд существует N8n Enterprise Edition, которая предлагает расширенные функции безопасности, Single Sign-On (SSO), аудит логов и более тонкое управление ролями.