Как импортировать и экспортировать workflow в n8n

Экспортируйте workflow n8n в JSON и импортируйте копию: проверка узлов, соединений, доступов и секретов перед запуском. Учебный пример без рабочих токенов.

Импортировать и экспортировать workflow в n8n можно так: сохраните схему в JSON, загрузите файл в новую копию и сверьте узлы, соединения и настройки до первого запуска, как это делают при переносе учебного примера с Manual Trigger и Edit Fields, где поле campaign = demo.

Способы экспорта и импорта: файл, URL, copy-paste

n8n хранит workflow в JSON и даёт несколько путей переноса Export and import | n8n Docs[1]. Разница между ними видна на учебном workflow с Manual Trigger и Edit Fields: один и тот же набор узлов можно вынести файлом, вставить через буфер или провести командной строкой, и каждый способ переносит свой объём данных.

Способ Где запускается Что переносит Когда использовать
Download / Import from File
Меню Workflow в редакторе канваса
Один workflow как JSON-файл
Быстрое сохранение и передача учебного workflow
Copy-Paste
Редактор n8n, клавиатура
Выбранные узлы целиком, с соединениями между ними
Перенос части схемы или сборка копии по узлам
n8n CLI
Командная строка, любая машина с доступом к сети
Workflow с папками, проектами и ссылками в .n8np-пакет
Перенос между инстансами с зависимостями
Server CLI
Командная строка инстанса
Экспорт и импорт
Устаревающие команды
n8n API
HTTP-запросы
Пакеты либо одиночный workflow как JSON через workflow endpoints
Автоматизация переноса

n8n CLI разработчик рекомендует для переноса workflow между инстансами и уже заложил в него проверку импорта до записи; Server CLI export и import помечены как планируемые к устареванию Export and import | n8n Docs[1]. Для одиночного workflow достаточно файла или буфера обмена.

Экспорт: скачать workflow как JSON

Сборка учебного входа до экспорта. Создайте новый workflow и добавьте в него два узла:

  1. Manual Trigger. Этот триггер запускает схему вручную и служит стартовой точкой без автоматического расписания [2].
  2. Edit Fields. В узле выберите Mode → Manual Mapping, затем добавьте одно поле: Name — campaign, Value — demo. Переключатель рядом со значением поставьте в Fixed, чтобы значение не превратилось в выражение. Edit Fields пишет новые данные и перезаписывает существующие [3].

Соедините Manual Trigger с Edit Fields перетаскиванием от правого края первого узла ко второму.

Порядок экспорта для учебного примера:

  1. Откройте собранный workflow на канвасе.
  2. В шапке канваса откройте меню Workflow.
  3. Нажмите Download — текущий workflow скачается на компьютер как JSON-файл.

Через меню доступны две операции: Download сохраняет текущий workflow JSON-файлом, Import from File загружает workflow из JSON на компьютере Export and import | n8n Docs[1].

Экспортируйте учебный workflow в файл campaign-demo.json. Этот файл и станет входом для импорта в новую копию. Для проверки повторите экспорт того же workflow в буфер обмена: выделите узлы мышью, нажмите Ctrl + C и вставьте Ctrl + V в Editor UI — так переносится workflow или его часть Export and import | n8n Docs[1].

Импорт: загрузить JSON в библиотеку

Откройте новый пустой workflow: исходная собранная схема и будущая копия будут различимы по содержимому канваса. Затем загрузите файл:

  1. В шапке канваса открытого нового workflow откройте меню Workflow.
  2. Выберите Import from File.
  3. Укажите campaign-demo.json с компьютера.

Import from File загружает workflow из JSON-файла с компьютера Export and import | n8n Docs[1]. Отдельного поля Import from URL в текущей справке по меню редактора нет: там описаны Download и Import from File, а перенос по сети идёт через n8n CLI, API или буфер обмена Export and import | n8n Docs[1]. Если копия нужна на другом инстансе с папками и ссылками, используйте n8n CLI с .n8np-пакетом: он несёт workflow вместе с папками, проектами и ссылками и проверяет импорт до записи Export and import | n8n Docs[1].

До запуска учебной копии сверьте её содержимое с исходным workflow по контрольному списку ниже.

Секреты и credentials в экспортированном JSON

Перед передачей файла проверьте его содержимое: экспортированный JSON несёт имена и ID credentials, а HTTP Request-узлы могут содержать заголовки аутентификации при импорте из cURL Export and import | n8n Docs[1]. Имена credentials бывают чувствительными в зависимости от того, как вы их назвали Export and import | n8n Docs[1].

Что убрать перед передачей файла наружу:

  • имена credentials, если они содержат адреса сервисов, логины или названия аккаунтов клиента;
  • заголовки аутентификации в HTTP Request-узлах — токены, ключи в query-параметрах, Authorization;
  • реальные идентификаторы таблиц, досок, чатов и кабинетов клиента;
  • тестовые значения полей, если в них остались персональные данные из пилота.

Справка прямо предлагает удалить или обезличить эту информацию из JSON до передачи, чтобы защитить credentials Export and import | n8n Docs[1]. В учебном примере рабочих токенов нет: в Edit Fields лежит поле campaign со значением demo, а узлы внешних сервисов не подключены.

Только после этой чистки файл можно передавать между командами и загружать на другом инстансе. Удалите чувствительные сведения и затем проверьте, что узлы и соединения учебного workflow сохранились.

Контрольная проверка импортированной копии до запуска

Учебный пример. Рабочих токенов в примере нет. Входные данные и ожидаемый результат собраны в одном учебном артефакте: узел Manual Trigger, узел Edit Fields с полем campaign = demo в режиме Fixed, соединение от первого ко второму.

Фрагмент JSON учебного workflow для импорта:

{
 "name": "campaign-demo",
 "nodes": [
 {
  "name": "When clicking Execute workflow",
  "type": "n8n-nodes-base.manualWorkflowTrigger",
  "typeVersion": 1,
  "position": [0, 0]
 },
 {
  "name": "Set campaign",
  "type": "n8n-nodes-base.set",
  "typeVersion": 3,
  "position": [220, 0],
  "parameters": {
  "mode": "manual",
  "assignments": {
   "assignments": [
   {
    "name": "campaign",
    "value": "demo",
    "type": "string"
   }
   ]
  },
  "options": {}
  }
 }
 ],
 "connections": {
 "When clicking Execute workflow": {
  "main": [
  [
   {
   "node": "Set campaign",
   "type": "main",
   "index": 0
   }
  ]
  ]
 }
 }
}

Этот фрагмент — до экспорта и после импорта одинаков: Import from File загружает узлы, соединения и параметры Edit Fields из JSON, а новая копия получает тот же набор Export and import | n8n Docs[1]. Источник и импортированная копия построены на одном фрагменте, поэтому колонки совпадают по узлам, соединению и полю.

Что сверяем До экспорта В импортированной копии Итог
Узлы
Manual Trigger, Edit Fields
Manual Trigger, Edit Fields
совпали
Соединения
Manual Trigger → Edit Fields
Manual Trigger → Edit Fields
порядок сохранён
Поле campaign
demo, режим Fixed
demo, режим Fixed
значение и режим сохранились
Вебхук
отсутствует
отсутствует
адрес пересоздавать не нужно
Дополнительный узел
нет
нет
копия совпала с источником

Проверка до запуска идёт по пунктам:

  • Узлы на месте, типов и настроек столько же, сколько в источнике: один Manual Trigger и один Edit Fields.
  • Соединение между узлами идёт в исходном порядке: Manual Trigger → Edit Fields.
  • Поле campaign содержит demo в режиме Fixed, значение не подменилось на пустое и не сбилось на выражение.
  • Триггер один: второй Manual Trigger в workflow не добавляется, n8n выдаёт ошибку, если он уже есть [2].
  • Проверьте выбранные credentials в узлах на целевом инстансе; при необходимости создайте или выберите нужные подключения.
  • Сверьте Webhook URL на целевом инстансе с адресом во внешнем сервисе; если адрес отличается, обновите его во внешнем сервисе.
  • Расписание в Schedule Trigger выключено или пересмотрено там, где копия не должна запускаться автоматически.

Только после этой сверки нажмите Execute Workflow. Manual Trigger позволяет запустить workflow кнопкой и не даёт ему идти автоматически [2]. Поле campaign задаётся узлом Edit Fields, который пишет новые данные или перезаписывает существующие [3].

Чем перенос workflow отличается от миграции инстанса

Для одного workflow используйте JSON. Если нужно перенести связанные папки, проекты и ссылки workflow, в справке предложен n8n CLI с .n8np-пакетом и проверкой импорта до записи. Этот формат находится в Preview и может измениться Export and import | n8n Docs[1]. Полную миграцию инстанса планируйте отдельно: приведённая справка описывает перенос workflow и связанных сущностей, а не восстановление всего сервера.

Что осталось за рамками примера

В JSON попадают имена и ID credentials; HTTP Request-узлы после импорта из cURL могут содержать заголовки аутентификации. Поэтому проверяйте файл перед передачей Export and import | n8n Docs[1]. После импорта сверьте узлы, соединения и поля, затем проверьте подключения к внешним сервисам.

Читайте также: Окупаемость ИИ-автоматизации: расчёт по операциям.

Читайте также: Автоматизация маркетинга: что автоматизировать первым.

Источники

  1. Export and import | Build | n8n Docsdocs.n8n.io
  2. Manual Trigger | Nodes | n8n Docsdocs.n8n.io
  3. Edit Fields (Set)docs.n8n.io

Валерий Курземнек

Автор метода «Машиночитаемый маркетинг»

Что ещё почитать