undercode_
  1. Главная
  2. Блог
  3. n8n: что это, как запустить и где он хранит ключи
Схема сценария n8n: триггер, запрос к API и запись в таблицу, рядом закрытый сейф с ключами

Разбор10 мин чтения

n8n: что это, как запустить и где он хранит ключи

Что такое n8n и для каких задач он нужен: облако или свой сервер, лицензия и оплата, запуск в Docker и безопасное хранение API-ключей и токенов.

Содержание · 10 разделов

n8n — сервис для автоматизации: вы собираете цепочку шагов в визуальном редакторе, и она сама выполняется по расписанию, по событию или по запросу. Например: пришла заявка с сайта, n8n записывает её в таблицу, просит модель ИИ определить тему и отправляет уведомление в нужный чат. Сама n8n называет его инструментом автоматизации с лицензией fair-code: исходный код открыт, но использование ограничено лицензией, подробности ниже.

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

Из чего состоит n8n

  • Workflow — сценарий целиком: цепочка шагов от запуска до результата.
  • Node (узел) — один шаг: запрос к API, запись в таблицу, условие, вызов модели ИИ.
  • Trigger (триггер) — узел, который запускает сценарий: расписание, вебхук, новое письмо, сообщение в чат.
  • Credentials — сохранённые доступы к сервисам: токены, ключи, OAuth. Узлы используют их, не показывая сам ключ в сценарии.
  • Execution (выполнение) — один запуск сценария целиком, сколько бы шагов в нём ни было. По числу выполнений считается оплата в облаке, о ней ниже.

Данные между узлами передаются в виде JSON. Где готового узла нет, можно написать шаг на JavaScript в узле Code (Python там тоже есть, но зависит от того, как настроен ваш n8n) или обратиться к любому API через HTTP Request.

Для чего его используют

  • Связать сервисы без своего бэкенда: форма → CRM → таблица → уведомление.
  • Регулярные отчёты: раз в день забрать данные из нескольких источников, свести и отправить.
  • Обработка входящих: разобрать письма или заявки, извлечь поля, разложить по местам.
  • Сценарии с ИИ: классификация обращений, черновики ответов, поиск по своей базе документов.
  • Внутренние боты для команды в Telegram или Slack.

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

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

Есть два способа работать с n8n.

n8n CloudСвой сервер (self-hosted)
Кто ставит и обновляетn8nвы
Где данныена серверах n8n, регион указан в FAQ тарифовтам, где вы разместили
Оплатаподписка n8nсервер и ваше время
Что нужно уметьничего, кроме самого n8nDocker, бэкапы, обновления, защита

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

Учтите: когда хостинг-провайдер предлагает «n8n в облаке», это обычно его виртуальный сервер с установленным n8n, а не n8n Cloud. Обновлять и защищать такой сервер, как правило, всё равно вам.

Сколько стоит n8n

Актуальные цены и лимиты тарифов — на странице n8n.io/pricing. Перед оплатой смотрите её: цифры меняются, а пересказы быстро устаревают.

Как устроена оплата:

  • Облачные тарифы различаются числом выполнений в месяц, одновременных запусков и общих проектов. Платите за запуски сценария, а не за шаги: сценарий из 20 узлов, запущенный один раз, считается одним выполнением.
  • Платные тарифы для своего сервера нужны компаниям, которым требуются функции для команд и администрирования.
  • Community Edition бесплатна как программа для своего сервера в рамках лицензии.
  • Пробный период в облаке есть, условия указаны на странице тарифов.

Бесплатная Community Edition не значит, что работа ничего не стоит. Сервер, резервные копии и платные API, которые вызывает сценарий (например, модели ИИ), оплачиваются отдельно.

Лицензия: что можно, а что нельзя

n8n распространяется по Sustainable Use License и сама себя open source не называет. Код открыт для чтения, но использование ограничено. Основное правило из текста лицензии: использовать и менять программу можно для внутренних задач своей компании, а также в некоммерческих и личных целях.

Что это значит на практике, разобрано в FAQ лицензии:

  • Можно: автоматизировать процессы своей компании, даже коммерческой; использовать для учёбы и личных задач; брать с клиентов деньги за создание, настройку и поддержку сценариев.
  • Отдельно разобран в FAQ: n8n как внутренний компонент вашего продукта, где пользователи только запускают сценарии, собранные вами. Что здесь разрешено и где начинается коммерческий договор, зависит от того, кто задаёт логику сценариев и чьи доступы в них используются. Если строите на n8n продукт для клиентов, прочитайте этот раздел FAQ целиком и при сомнениях уточните у n8n.
  • Нужен отдельный договор: если вы как коммерческий сервис даёте клиентам редактор n8n или возможность самим собирать и настраивать сценарии в вашем продукте. Обход через API, MCP или ИИ-агента FAQ прямо называет тем же самым.
  • Нужен отдельный договор: если вы продаёте n8n клиентам под своим брендом.

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

Как запустить n8n

Проще всего — облако. Регистрируетесь на n8n.io, и редактор открывается в браузере. Ничего ставить не нужно.

На своём компьютере через npx. Нужен Node.js, подходящие версии указаны в инструкции по npm:

npx n8n

После запуска редактор откроется по адресу http://localhost:5678. Это способ попробовать, ограничения и предупреждения для него перечислены на той же странице.

В Docker на своём компьютере. Это локальный тестовый запуск, а не настройка для сервера. Команда основана на примере из документации по Docker, но порт здесь открыт только для своей машины (127.0.0.1), чтобы редактор не был виден из локальной сети:

docker volume create n8n_data

docker run -it --rm \
 --name n8n \
 -p 127.0.0.1:5678:5678 \
 -e GENERIC_TIMEZONE="Europe/Moscow" \
 -e TZ="Europe/Moscow" \
 -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
 -v n8n_data:/home/node/.n8n \
 n8nio/n8n

Отличия от документации: часовой пояс вместо заглушки <YOUR_TIMEZONE> и привязка порта к 127.0.0.1. Том n8n_data хранит сценарии, доступы и ключ шифрования, поэтому данные переживают удаление контейнера. Без тома данные остались бы только внутри контейнера, а флаг --rm удаляет контейнер сразу после остановки, вместе с ними. По умолчанию n8n хранит данные в SQLite, PostgreSQL тоже поддерживается.

Для постоянной работы у n8n есть отдельное руководство по Docker Compose: какие файлы подготовить, какие сервисы запускаются и сколько ресурсов нужно серверу, смотрите в нём.

На сервер в интернет такой контейнер выставлять как есть нельзя: порт 5678 открыт без HTTPS. Нужны обратный прокси с сертификатом, пароль администратора, резервные копии тома и обновления. Это отдельная работа, и именно о ней предупреждает документация. Список версий и что в них изменилось — на странице релизов.

Как n8n хранит доступы к сервисам

Токены, ключи API и OAuth-доступы вы сохраняете в n8n как credentials, и узлы берут их оттуда. Если пользоваться этим механизмом, ключ не нужно вписывать в параметры узла. Не вставляйте ключи вручную в узел Code, в поля и в URL: оттуда они попадают в сам сценарий и в историю выполнений. Историю выполнений перед экспортом или передачей кому-то тоже проверяйте, в ней бывают данные из ответов сервисов.

По документации о ключе шифрования n8n при первом запуске сам создаёт случайный ключ и сохраняет его в папке ~/.n8n. Этим ключом он шифрует credentials перед записью в базу. Из этого следуют три правила:

  • Без ключа доступы не расшифровать. Если ключ создал сам n8n, он лежит в ~/.n8n (в примере выше это том n8n_data): потеряете папку и восстановите только базу — сохранённые доступы придётся вводить заново. Если ключ задан переменной, сохраните отдельно его точное значение. В любом случае бэкап должен включать и базу, и ключ.
  • Шифрование не защищает от того, у кого есть и база, и ключ. В примере выше оба лежат в одном томе, а запущенный n8n умеет ими пользоваться. Поэтому шифруйте резервные копии и ограничивайте, кто имеет доступ к серверу и тому.
  • Свой ключ задают до первого запуска переменной окружения N8N_ENCRYPTION_KEY. Если n8n уже работает и сохранил доступы, подменять ключ нельзя: при переносе на другой сервер нужен тот же ключ, которым зашифрованы данные. В режиме очереди один и тот же ключ должны получить основной экземпляр и все воркеры.
  • Ключ — такой же секрет, как пароли. Не кладите его в репозиторий и в общий чат, храните там же, где остальные секреты сервера.

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

Первый сценарий

Официальный quickstart предлагает такой сценарий: Schedule Trigger (по расписанию) → HTTP Request (забрать данные) → Edit Fields (оставить нужные поля) → Data table (сохранить). Данные он берёт из учебного сервиса, ключи сторонних сервисов не нужны. Настройки каждого узла расписаны по шагам на странице quickstart, здесь только общий порядок работы, одинаковый для любого сценария:

  1. Соберите узлы на схеме и нажмите Execute workflow. n8n выполнит сценарий один раз и покажет, какие данные вышли из каждого узла.
  2. Проверьте вывод каждого шага. Если что-то не так, исправляйте шаг и запускайте снова.
  3. Когда всё работает, опубликуйте сценарий. Только после этого он будет срабатывать по триггеру сам.

Пока сценарий не опубликован, триггер по расписанию не сработает. Это частая причина вопроса «почему ничего не запускается».

ИИ-агенты и MCP в n8n

В n8n можно подключать модели разных провайдеров, в том числе OpenAI, Anthropic и Google, добавлять им инструменты и память.

AI Agent — узел, к которому подключают модель и инструменты. По документации модель сама решает, какой инструмент вызвать. Хотя бы один инструмент подключить обязательно. Инструментом может быть HTTP-запрос, свой код или другой сценарий n8n.

Поиск по своим документам (RAG) собирается из узлов: загрузка документов, эмбеддинги, векторное хранилище. Хранилище можно отдать агенту как инструмент.

MCP в n8n работает в обе стороны:

  • MCP Client Tool подключает агента n8n к инструментам внешнего MCP-сервера.
  • MCP Client вызывает инструмент внешнего MCP-сервера как обычный шаг сценария, без агента.
  • MCP Server Trigger делает инструменты и сценарии n8n доступными внешним клиентам, например Claude или Cursor. Работает по SSE и streamable HTTP. Документация пишет: «It currently doesn't support standard input/output (stdio) transport».

Что такое MCP-сервер и как подключать его к агентам, я разбирал в отдельной статье про MCP-сервер. Если хотите понять, как агент устроен без конструктора, есть статья как создать ИИ-агента с примером на Python.

С агентами в n8n те же риски, что и везде. Агент, которому дали инструмент записи в CRM и доступ к входящим письмам, может выполнить инструкцию, спрятанную в письме. Давайте инструментам минимальные права, тестируйте на учебных данных и ставьте шаг подтверждения человеком перед действиями, которые нельзя отменить.

Частые вопросы

n8n бесплатный? Программа Community Edition бесплатна для своего сервера в рамках лицензии. Облако платное, есть пробный период.

Нужно ли уметь программировать? Для простых сценариев нет. Для сложных пригодятся понимание JSON и API и иногда небольшой код в узле Code.

Чем n8n отличается от Zapier и Make? Все три соединяют сервисы. Особенности n8n: его можно поставить на свой сервер, а в облаке n8n оплата считается по запускам сценария, а не по шагам. Как считают оплату Zapier и Make, смотрите на их страницах тарифов.

Где хранятся данные? В облаке — на серверах n8n, регион указан в FAQ тарифов. На своём сервере — там, где вы его разместили. Если сценарий отправляет данные во внешнюю модель ИИ, они уходят и к её провайдеру.

Читайте также

Источники

  1. n8n Docs
  2. n8n Plans and Pricing
  3. License FAQ
  4. Sustainable Use License
  5. Install with npm
  6. Install with Docker
  7. Install using Docker Compose
  8. Set a custom encryption key
  9. AI Agent node
  10. MCP Client node
  11. MCP Server Trigger node
  12. n8n releases on GitHub
  13. Build your first workflow
Консультация · 60 минут · 6 000 ₽Обсудить свою задачуОпишите задачу в Telegram-боте, разберём её на созвоне.