Смотришь на чужие красивые схемы в n8n и думаешь: «Ага, понятно, что ничего не понятно». Какие‑то цветные блоки, стрелочки, всё движется, что‑то там отправляется в Notion, в Telegram, в Google Sheets – а ты всё ещё руками копируешь данные из одной таблички в другую.
Я сам так начинал: поставил n8n, открыл интерфейс, потыкал пару минут и закрыл. Слишком много всего. А потом дошло, что вся эта история крутится вокруг одной простой штуки – узлов. Как только понял узлы, начал наращивать огромные схемы.
Что такое узлы в n8n
Узлы в n8n – это базовые строительные блоки рабочих процессов (workflow). Каждый узел выполняет конкретную задачу и соединяется с другими узлами для создания цепочки действий.
Представь ленту на заводе. По конвейеру едет коробка:
- на первой станции в неё кладут товар,
- на второй клеят наклейку;
- на третьей проверяют вес;
- на четвёртой отправляют на погрузку.
В n8n узлом называется каждая такая станция. Только вместо коробки по цепочке передаются данные. Каждый узел принимает на вход и отдаёт на выход набор JSON-записей.
Если workflow работает с файлами (картинки, документы и т.п.), n8n умеет передавать их как binary-данные (в дополнение к JSON), для этого используются узлы/операции формата File/Binary.
| Название | Назначение | Примеры |
|---|---|---|
| Триггеры | Запускают рабочий процесс при наступлении события | Manual trigger; On a webhook; On a Schedule; Email trigger |
| Интеграции | Выполняют действия во внешних сервисах | Google Sheets, Notion, Telegram, Postgres |
| Логика | Управляют ходом выполнения рабочего процесса (ветвление, ожидание, циклы) | IF, Switch, Wait, Loop |
| Манипуляция данными | Преобразуют, фильтруют, объединяют или разбивают данные, переходящие между узлами. | Aggregate, Summarize, Sort, Split Out, Set, Merge |
| Работа с файлами | Чтение, запись, преобразование и передача файлов и бинарных данных | Read/Write Files from Disk, Extract from File, Convert to File |
| Парсинг и извлечение данных | Извлечение структурированных данных из HTML, XML, JSON или текста | Extract HTML content; XML to JSON; CSV |
| Код | Выполнение пользовательского кода для сложной обработки данных или интеграций | Code in Python; Code in JavaScript |
| AI/LLM-узлы | Работа с моделями машинного обучения и нейросетями | AI Agent, OpenAI, OpenRouter |
На просторах сети можно встретить множество различных классификаций узлов. В рамках статьи мы будем опираться на вышеуказанную таблицу, хоть она и не является исчерпывающей.
Для поиска нужного узла:
- Зайди в рабочий процесс или создай новый;
- Нажми на кнопку «+» или клавишу «Tab»;
- Введи в поиске название нужного узла.
Архитектура и типология узлов в n8n
Структура узла
Каждый узел имеет одинаковую базовую структуру. На левой стороне узла находится входной коннектор, откуда приходят данные. На правой стороне – выходной коннектор. Это откуда данные уходят в следующий узел. Исключение только для триггер-узлов: у них нет входа, потому что они начинают процесс с нуля.
Когда ты дважды кликаешь на узел, открывается панель конфигурации. Вот тут ты видишь параметры узла. Например, в HTTP Request узле параметры – это URL, метод запроса (GET, POST и т.д.), заголовки, тело запроса. В Set узле параметры – это название новых полей и их значения. В Google Sheets узле – это имя таблицы, диапазон ячеек, и какие данные туда писать.
Помимо специфичных параметров, каждый узел имеет опции, доступные в вкладке «Settings» панели конфигурации:
- Retry on Fail. Повторное выполнение узла при появлении ошибки;
- Max Tries. Максимальное количество попыток;
- Wait Between Tries. Задержка между повторными выполнениями в миллисекундах;
- On Error. Действие при ошибке: остановить рабочий процесс, продолжить или продолжить с выводом ошибки.
Параметры Retry полезны при работе с внешними API, которые могут быть временно недоступны или иметь ограничение частоты запросов. Настройка Wait Between Tries должна быть больше чем rate limit API (например, если API позволяет 1 запрос в секунду, установите не менее 1000ms).
Входные и выходные данные в узлах
Узлы в n8n обмениваются данными в формате JSON. Данные приходят в узел в виде массива items. Если у тебя есть список 5 контактов, то это 5 items. Большинство узлов n8n по умолчанию обрабатывают каждый item отдельно (это называется «Run Once for Each Item»). Поэтому если в Set узел пришло 5 items, узел выполнится 5 раз, каждый раз обрабатывая по одному item.
Данные между узлами передаются через выражения. Это такие конструкции в двойных скобках: {{ }}. Внутри можно писать как просто названия полей, так и более сложные конструкции на языке JavaScript.
Самое простое выражение: $json. Это ссылка на JSON-данные текущего item. Если у тебя в данных есть поле «email», то {{$json.email}} вернёт значение этого поля. Синтаксис точно как в JavaScript – можно использовать точечную нотацию или скобки.
Но что если тебе нужны данные не из текущего узла, а из предыдущего? Или из узла, который был несколько шагов назад? Вот тут есть специальная конструкция: {{$('Имя узла').item.json.поле}}. Ты можешь ссылаться на любой узел в твоём workflow и доставать оттуда данные.
Основные категории узлов в n8n
Теперь рассмотрим самые популярные узлы и сценариии их применения.
Триггеры
Триггер – это узел, который запускает рабочий процесс при определенном условии. Без него выполнение созданной автоматизации невозможно.
Manual Trigger. Самый простой. Это кнопка запуска workflow, которую ты нажимаешь в интерфейсе n8n. Идеален для тестирования и отладки. У данного триггера нет никаких параметров.
Пример использования. Ты разрабатываешь автоматизацию и хочешь проверить её работоспособность перед использованием более подходящих триггеров.
Schedule Trigger. Запускает рабочий процесс в n8n по расписанию. Каждое утро в 9 утра, каждый понедельник, или по Cron-выражению.
Параметры Schedule Trigger:
- Interval – выбираешь один из готовых вариантов (каждые 3 минуты, день, неделю и т.д.);
- Expression – появляется при выборе значения Custom (Cron) для параметра Interval. Вводишь свое выражение вроде «
0 9 * * 1» (каждый понедельник в 9:00).
Пример использования. Ты хочешь каждый день в 8 утра получать сводку из аналитики и отправлять ее в Telegram. Ставишь Schedule с выражением «0 8 * * *» и подключаешь API аналитики и Telegram.
Webhook Trigger (вебхук) – запускает рабочий процесс при получении HTTP-запроса от внешнего источника. Это один из самых популярных способов запуска в реальным задачах.
Основные параметры:
- Test URL. Ссылка для тестирования триггера;
- Production URL. Рабочая ссылка, которую будут использовать внешние сервисы для запуска workflow;
- HTTP Method. GET, POST, PUT и другие (обычно POST для получения данных);
- Path. Позволяет изменить последнее значение URL;
- Authentication. Способ аутентификации: Basic Auth, Header Auth, JWT Auth;
- IP(s) Whitelist. Можно задать список IP-адресов, которые могут отправлять запрос для запуска рабочего процесса.
Пример использования. Допустим, платежная система отправила запрос о состоянии платежа пользователя. Webhook Trigger запускает рабочий процесс, который выдаёт клиенту VIP-статус.
Интеграции
Интеграционные узлы – это готовые подключения к популярным сервисам. Вместо того чтобы писать код для работы с API Telegram или Google Sheets, ты просто берешь узел и настраиваешь параметры.
Telegram – набор узлов для отправки сообщений, фотографий и документов. Для использования необходимо создать бота. Идеально подходят для уведомлений.
Параметры узлов Telegram:
- Chat ID. Уникальный идентификатор чата или пользователя. Не путать с username. Можно получить с помощью специальных ботов, например, @userinfobot;
- Text. Содержимое сообщения;
- Operation. Действие, которое должен выполнить узел: отправка текстового сообщения, стикера, видео и другие;
- Reply Markup. Какого вида меню возвращать пользователю при ответе.
Пример использования. Каждые 5 минут workflow проверяет, есть ли новые заказы. Если есть, отправляет тебе в Telegram уведомление с количеством, суммой и другими данными. Ты не пропустишь ни один заказ, потому что Telegram всегда под рукой.
HTTP Request – узел для отправки HTTP-запросов. Если под нужный тебе сервис нет готового решения, то используешь HTTP Request для отправки запросов на доступный API.
Основные параметры:
- Method. GET, POST, PUT, PATCH и другие;
- URL. Адрес, на который отправляется запрос;
- Authentication. Способ аутентификации: Basic Auth, Header Auth, Custom Auth;
- Send Query Parameters. Отправка параметров запроса;
- Send Headers. Отправка заголовков запроса;
- Send Body. Отправка тела запроса.
Кроме того, доступны опции для использования прокси, игнорирования небезопасных соединений и реализации таймаутов при отсутствии ответа от сервера в течение заданного времени.
Postgres – узел для взаимодействия с СУБД PostgreSQL. Он позволяет выполнять SQL-запросы, вставлять, обновлять и удалять данные прямо из рабочих процессов. Узел поддерживает как простые операции, так и сложные запросы с защитой от SQL-инъекций.
Основные операции:
- Delete. Удаление данных из таблицы. Вы можете полностью очистить таблицу (Truncate), удалить конкретные строки (Delete) или удалить таблицу целиком (Drop);
- Execute Query. Выполнение произвольных SQL запросов. Это наиболее гибкая операция, которая позволяет использовать prepared statements с параметрами ($1, $2, $3) для безопасного передачи данных и предотвращения SQL-инъекций;
- Insert. Добавление новых строк в таблицу. Узел может автоматически отображать колонки или выполнять ручное отображение. Есть опция Skip on Conflict для пропуска строк, нарушающих ограничения уникальности;
- Insert or Update. Вставка или обновление записей в зависимости от того, существует ли запись. Это удобно для синхронизации данных без предварительной проверки наличия записи;
- Select. Выбор данных из таблицы с поддержкой фильтрации, сортировки и ограничений на количество результатов. Вы можете использовать условия с операторами AND/OR для сложной фильтрации;
- Update. Обновление существующих записей. Как и для Insert, поддерживаются оба режима отображения колонок.
Пример использования. PostgreSQL можно использоваться для долгосрочного хранения данных. Например, памяти для ИИ-агентов или данных пользователей.
Логика и ветвление
Иногда нужно обработать данные по-разному в зависимости от условий. Для этого созданы логические узлы, которые направляют данные в разные стороны или объединяют их.
If – проверяет условие и в зависимости от результата. Workflow идет по одному или другому пути. Очень похоже на обычное программирование.
Параметры узла if:
- Conditions. Что проверяем (например,
price > 10000); - Operation. Оператор (equals, not equals, greater than, contains, regex match и другие);
- Value. Значение для сравнения
Пример использования. Рабочий процесс получает данные о заказе. Если сумма больше 10000 рублей, отправляет ее менеджеру на ручное согласование. Если меньше – сразу в производство. Узел If выбирает маршрут в зависимости от суммы.
Switch – прокачанная версия узла If. Подходит для случаев, когда маршрутов больше 2. Он позволяет маршрутизировать данные по разным ветвям рабочего процесса в зависимости от условий, которые вы определяете. Если узел If предоставляет простую логику «да-нет», то Switch открывает возможности для многоветвевой маршрутизации.
Параметры:
- Conditions. список условий и маршрутов;
- Value. Поле, по которому происходит сравнение;
- Convert types where required. Если указанный тип данных не соответствует ожидаемому, n8n попробует выполнить преобразование.
Пример использования. Если статус платежа «pending», ожидаем завершение оплаты, если «paid» – выдать доступ к курсу, если «cancelled» – отправить письмо клиенту с вопросом, почему он отказался от покупки.
Манипуляция данными
Edit Fields (Set) – узел для создания и преобразования данных по мере их прохождения через workflow. Set является одним из самых часто используемых узлов в n8n, поскольку обеспечивает полный контроль над тем, как выглядят ваши данные при передаче между этапами автоматизации.
Если тебе нужно переименовать поля, добавить новые данные, удалить ненужные элементы или преобразовать форматы, узел Set – это основной инструмент.
Параметры узла Set:
- Fields to Set. Определяет, какие поля нужно создать или изменить;
- Include Other Input Fields. Определяет, какие данные будут включены в выход узла.
Узел Set поддерживает 6 типов значений: строки (String), числа (number), булевы значения (Boolean), массивы (Array), объекты (Object) и бинарные файлы (Binary Data).
Пример использования. API возвращает данные о товаре в виде цены в долларах и названия на английском. Ты используешь Edit Fields, чтобы создать новое поле priceRUB (преобразуешь из долларов в рубли через выражение {{$json.priceDollar * курс доллара}}), новое поле name_ru (переводя название) и объединяешь имя и фамилию клиента в одно поле fullName.
Merge – узел для объединения данных из нескольких потоков. Он позволяет синхронизировать параллельные ветки вашего рабочего процесса, комбинировать данные из разных источников и обогащать информацию перекрестно связанными данными.
Когда рабочий процесс разветвляется на несколько параллельных потоков (например, через узел If, Switch или параллельные запросы к API), нужно снова их объединить для дальнейшей обработки. Он ожидает, пока данные станут доступны из всех подключённых входов, прежде чем выполнить объединение.
Поддерживаемые режимы объединения:
- Append. Складывает элементы из первого входа, а затем добавляет элементы из второго входа;
- Combine. Гибкий режим, предоставляющий несколько подрежимов для различных типов объединений: на основе совпадения значений в выбранных полях, на основе порядка и декартово произведение;
- SQL Query. Можно написать SQL-запрос для объединения данных;
- Choose Branch. Этот режим выбирает, какой из входных потоков данных использовать в качестве выходных. Узел дожидается данных от обоих входов, но выводит только один из них без изменений.
Пример использования. Workflow генерирует статью с помощью нейросети. В один момент он разделяется на 2 потока: генерация текста статьи и написание раздела FAQ. Далее 2 текста объединяются в один с помощью узла Merge.
Работа с файлами
Read/Write Files from Disk – это один из самых важных узлов для работы с файлами на локальной машине в n8n. Это встроенный узел, который позволяет читать файлы с диска и записывать бинарные данные в файлы на компьютере, где запущен n8n.
Узел поддерживает 2 операции: Read File(s) From Disk (чтение файлов с диска) и Write File to Disk (запись файлов на диск).
Read File(s) From Disk позволяет читать один или несколько файлов с диска компьютера, где запущен n8n. Основные параметры этого режима:
- File(s) Selector. Путь к файлу или шаблон пути для чтения нескольких файлов;
- File Extension. Расширение файла в выходных данных;
- File Name. Название файла в выходных данных;
- MIME Type. MIME-тип файла;
- Put Output File in Field. Название поля для вывода файла.
Write File to Disk создаёт бинарный файл на диске машины, где запущен n8n. Основные параметры этого режима:
- File Path and Name. Полный путь с названием файла и расширением;
- Input Binary Field. Поле входных данных, содержащее бинарные данные;
- Append (опция). Режим записи: добавлять к файлу (включено) или перезаписывать (выключено);
Обычно для создания файлов из данных используется узел Convert to File, который преобразует структурированные данные в бинарный формат (CSV, XLSX, PDF, JSON и т.д.), а затем узел Read/Write Files from Disk записывает эти бинарные данные на диск.
Пример применения. Workflow считал показатели рекламной компании, с помощью LLM сформулировал вывод, а далее сохранил его в файл с помощью узла Write File to Disk.
Convert to File – это базовый узел n8n, который преобразует структурированные данные JSON в бинарный формат, создавая загружаемые файлы. Это важный компонент для любого рабочего потока, требующего экспорта данных, генерации отчётов или создания файлов для отправки другим системам.
Узел работает в одном направлении – от JSON к файлу. Для обратного преобразования (файл к JSON) используется узел Extract from File. Поддерживается конвертация в следующие типы файлов: CSV, HTML, ICS, JSON, ODS, RTF, Text File, XLS, XLSX.
Пример применения. Пользователь заполняет форму с деталями встречи. Workflow генерирует .ics файл, который пользователь может импортировать в Outlook, Google Calendar или Apple Calendar.
Вставка кода
Code – это узел, который заменил старые Function и Function Item nodes (начиная с версии 0.198.0). Он позволяет выполнять произвольный код JavaScript или Python как часть вашей автоматизации, обрабатывая данные и трансформируя их в нужные вам структуры.
Узел Code предоставляет два принципиально разных режима работы, и выбор между ними критичен для производительности и логики вашего рабочего процесса:
- Run Once For All Items. Код выполняется один раз для всех входных элементов. По умолчанию;
- Run Once For Each Item. Код выполняется отдельно для каждого входного элемента.Подходит для специализированных случаев, когда нужна индивидуальная обработка каждого элемента.
Режим «Run Once for All Items» быстрее при большом количестве элементов, так как код выполняется единократно, а не многократно.
Узел Code поддерживает Node.js JavaScript, что открывает возможности использования современного JavaScript синтаксиса, включая async/await, promises, стрелочные функции и деструктуризацию. Также поддерживается язык Python в бета-версии.
Пример применения. После генерации с помощью нейросети в тексте присутствуют нежелательные символы. Можно их удалить или заменить в узле Code.
AI и LLM-узлы
Благодаря узлам для работы с нейросетями, n8n приобрел огромное число фанатов. Теперь пользователи без навыков программирования могут создавать продукты на основе языковых моделей.
OpenAI – предоставляет доступ к API OpenAI. Узел организован вокруг шести основных категорий ресурсов: Text (текст), Image (изображения), Audio (аудио), Video (видео), File (файлы) и Conversation (разговоры). Каждая категория содержит набор операций, адаптированных под специфические сценарии использования.
Опция Classify Text for Violations используется для модерации контента согласно политике OpenAI. Операция возвращает булево значение flagged и детальные баллы по категориям нарушений (насилие, сексуальный контент, ненависть и т.д.).
Узел Open AI поддерживает встроенные инструменты:
- Web Search. Поиск актуальной информации в интернете;
- File Search. Семантический поиск в загруженных документах (идеален для RAG);
- Code Interpreter. Выполнение кода в изолированной среде.
Пример применения. Ты получаешь отзыв клиента, отправляешь его в ChatGPT с промптом «Определи, позитивный это отзыв или негативный», и на основе ответа модели либо отправляешь благодарность, либо автоматически создаешь задачу для менеджера для разбора проблемы.
Basic LLM Chain – универсальный узел для взаимодействия с языковыми моделями в n8n. Он принимает текстовый ввод, отправляет его в LLM и возвращает структурированный результат.
Параметры:
- Model. Выбор модели (ChatGPT, Claude, Gemini и другие);
- Fallback Model. Модель, которая будет использоваться в случае ошибки от основной;
- Prompt. Запрос пользователя;
- Chat Messages. Позволяет добавить дополнительные инструкции. Например, системный промпт;
- Output Parser. Преобразование ответа модели в структурированные данные.
Способ применения. Создание простого чат-бота, который принимает запросы пользователя и выдаёт ответ от выбранной модели.
Как использовать Community nodes в n8n
Community Nodes – это узлы (интеграции), которые разработало сообщество n8n, а не сама команда платформы. Экосистема уже включает больше 5000 таких нод, которые скачиваются миллионы раз в месяц.
К пользовательским узлам стоит обратиться, если ты не нашёл готового решения для своей задачи. Конечно можно реализовать логику с помощью HTTP Request. Но использование протестированных множеством пользователей узлов сэкономит время и позовлит избежать ошибок. Особенно, если ты ранее не работал с API различных сервисов.
Где искать и как установить Community Nodes
Облачная версия n8n
-
Поиск нужного узла
Открой меню узлов и введи название нужного инструмента. В нашем случае это «Taddy API». Нужный узел находится в разделе «More from the community».
-
Нажимаем на кнопку «Install»
Далее устанавливаем нужный узел с помощью кнопки «Install». Ждём несколько секунд, пока загружается узел.
-
Используем установленный узел
Далее пользовательский узел будет доступен в меню. Если он не появился, перезагрузи страницу. Узлы, загруженные в облачной версии n8n являются верифицированными, поэтому за безопасность можно не переживать.
Версия self-hosted на компьютере или виртуальном сервере
-
Переходим в каталог узлов для n8n
В интерфейсе self-hosted версии n8n нет каталога узлов. Поэтому ищем нужные решения здесь. Для установки нам нужно взять название узла, например: «n8n-nodes-globals».
-
Заходим в настройки
В настройках в разделе «Community nodes» нажми кнопку «Install». В поле вводим название узла и запускаем установку.
-
Используем установленный узел
Далее пользовательский узел будет доступен в меню. Если он не появился, перезагрузи n8n.
Риски использования Community Nodes
Community nodes в n8n представляют существенные угрозы безопасности, поскольку это неверифицированный код из публичных источников (npm), который выполняется с полными привилегиями процесса n8n на вашем сервере.
Установка community nodes равносильна внедрению стороннего исполняемого кода в ваше окружение. n8n предлагает механизмы верификации для некоторых узлов и инструменты контроля, но правильная конфигурация и дисциплина при отборе узлов остаются критически важными.
В случае с версией self-hosted Community nodes имеют полный доступ к машине, на которой работает n8n. Это означает, что вредоносный узел может:
- Выполнять произвольные команды на хосте;
- Получать доступ к локальной файловой системе;
- Модифицировать данные на диске;
- Использовать ресурсы сервера;
- Устанавливать вредоносное ПО.
Например, в n8n были обнаружены критические уязвимости (CVE-2025-68668, CVE-2025-68613), которые позволяют аутентифицированным пользователям с правом редактирования workflows выполнять произвольный код на хосте с привилегиями процесса n8n.
n8n пытается смягчить эти риски посредством верификации узлов. Однако верификация – это однократный процесс. После одобрения узла разработчик может внести уязвимость в последующих версиях, и это может остаться незамеченным некоторое время.
Если у тебя есть опыт разработки, то рекомендую читать код узлов перед установкой. В ином случае стоит минимизировать использование пользовательских узлов. Например, использовать HTTP Request, если у нужного сервиса есть API. Это долго, но безопасно.
Часто задаваемые вопросы про узлы в n8n
Сколько узлов можно использовать в одном workflow?
Теоретически нет жёстких ограничений на количество узлов. На практике производительность workflow зависит от типа узлов, количества элементов на обработку и ресурсов сервера, на котором запущен n8n. Обычно workflows содержат 5–50 узлов. Если узлов становится больше 100, стоит подумать о разделении на более маленькие процессы или использовании асинхронных триггеров.
Как передать данные между узлами?
Через выражения в двойных скобках: {{ }}. Самое простое выражение – {{ $json }} (данные текущего item). Если у тебя есть поле email, напиши {{ $json.email }}.
Что такое JSON и зачем он нужен в n8n?
JSON (JavaScript Object Notation) — это стандартный формат для обмена структурированными данными. В n8n почти всё крутится вокруг JSON, потому что узлы обмениваются данными между собой в данном формате. Если данные приходят в другом формате (CSV, XML), n8n может их преобразовать в JSON с помощью специализированных узлов.
Безопасны ли community nodes?
Не всегда. Community nodes – это пользовательский код из npm, который выполняется с полными привилегиями процесса n8n. n8n пытается смягчить это верификацией, но верификация – однократный процесс. Разработчик может внести уязвимость в новой версии.
Что такое «Run Once for All Items» и когда его использовать?
По умолчанию узлы выполняются один раз для каждого item. Это удобно для простых операций, но медленно при большом количестве items. Режим «Run Once For All Items» выполняет узел один раз для всех items сразу. Доступен в узлах Code и некоторых других.
Для чего в n8n нужен узел Code?
n8n построен так, чтобы большинство автоматизаций можно было создать БЕЗ кода, используя готовые узлы. Но с помощью кода можно обработать сложные данные и в некоторых случаях ускорить рабочий процесс.
