n8n через CLI: импорт/экспорт, сброс пользователя

Тот, кто размещает n8n самостоятельно, рано или поздно сталкивается с необходимостью сохранить workflow, перенести их на другой инстанс или сбросить заблокированную учетную запись пользователя. Для всех трех задач n8n предоставляет собственные команды CLI, которые выполняются непосредственно на сервере и работают без функционирующего веб-интерфейса. В этой статье показаны важнейшие команды для экспорта, импорта и экстренного сброса пароля, как они описаны в официальной документации n8n. Актуально на: июль 2026.

Экспорт workflow через CLI

Команда export:workflow экспортирует workflow из базы данных n8n в файлы JSON. Без дополнительных параметров она относится к отдельным workflow, но с подходящими флагами экспорт можно расширить на весь объем или сразу подготовить для резервного копирования.

• --all: Экспортирует все workflow инстанса, а не только один.
• --id=<ID>: Экспортирует только workflow с указанным ID.
• --output или -o: Задает целевой файл или, при нескольких workflow, целевую директорию.
• --backup: Автоматически включает --all, --pretty и --separate для полной, читаемой резервной копии.
• --separate: Записывает каждый workflow в отдельный файл, требует директорию при использовании с --output.
• --pretty: Форматирует вывод JSON в читаемом виде вместо компактного.
• --published: Экспортирует опубликованную версию workflow вместо текущего черновика.
• --version=<VERSION_ID>: Экспортирует определенную историческую версию workflow.

Для регулярного резервного копирования особенно подходит комбинация export:workflow --backup --output=backups/latest/, которую удобно планировать как ежедневную или еженедельную задачу в cron.

Импорт workflow через CLI

Противоположность этому - import:workflow. Она считывает ранее экспортированные файлы JSON и записывает их обратно в базу данных целевого инстанса, например при переезде сервера или восстановлении после сбоя.

• --input: Путь к входному файлу или, вместе с --separate, к директории с несколькими файлами.
• --separate: Импортирует все файлы JSON из директории вместо только одного файла.
• --projectId: Присваивает импортированные workflow определенному проекту.
• --userId: Присваивает импортированные workflow определенному пользователю.
• --activeState: Определяет, активируются ли импортированные workflow, по умолчанию false, или fromJson при работе в режиме multi-main.
• --skipMigrationChecks: Пропускает проверки валидации при импорте.

Важно: workflow с ID, который уже существует в целевой базе данных, при импорте перезаписываются, а не дублируются. Поэтому перед импортом на продуктивном инстансе всегда стоит заранее экспортировать существующие workflow в качестве резервной копии.

Экстренный случай: сброс пароля через CLI при блокировке доступа

Если доступ к учетной записи n8n отсутствует из-за забытого пароля и не настроен SMTP-сервер для обычного сброса по электронной почте, согласно документации n8n помогает команда user-management:reset. Она возвращает управление пользователями в состояние до первоначальной настройки и при этом удаляет все существующие учетные записи пользователей. При следующем обращении к веб-интерфейсу n8n снова запрашивает настройку новой учетной записи владельца, аналогично новой установке.

Команда намеренно радикальна: она удаляет все учетные записи пользователей инстанса, а не только затронутую. Роли, права доступа и привязки к проектам после этого нужно назначить заново. Согласно документации, workflow, учетные данные и история выполнения при этом не затрагиваются, поскольку команда сбрасывает только управление пользователями.

Для более узкого случая, когда кто-то больше не может использовать двухфакторную аутентификацию, например из-за утраты кодов восстановления, достаточно менее радикальной команды mfa:disable --email=<адрес-эл-почты>. Она отключает MFA именно для этой одной учетной записи, чтобы человек мог снова войти обычным образом и заново настроить двухфакторную аутентификацию.

Другие команды CLI для повседневной эксплуатации

• export:credentials и import:credentials: Сохраняют и переносят учетные данные; с --decrypted все чувствительные значения оказываются в файле в открытом виде, что требует соответствующей осторожности при обращении.
• audit: Проверяет инстанс на распространенные проблемы безопасности.
• license:info и license:clear: Показывают текущую лицензию или сбрасывают ее до стандартного набора функций.
• n8n --help: Выводит список всех доступных команд установленной версии n8n, поскольку набор функций может различаться в зависимости от версии.

Команды CLI выполняются непосредственно на сервере и требуют соответствующего доступа, например через SSH или docker exec. Тот, кто использует n8n у провайдера без доступа к shell, как правило, не может их использовать и зависит от поддержки провайдера. Для компаний, которые размещают n8n самостоятельно и в повседневной работе зависят от надежных резервных копий и документированного плана действий в чрезвычайной ситуации, NordFlux оказывает поддержку в развертывании и эксплуатации n8n с настройкой, при которой вы сами сохраняете контроль над данными и доступами.

Часто задаваемые вопросы об импорте/экспорте n8n через CLI

Как автоматически резервировать все workflow n8n?

С помощью команды export:workflow --backup --output=<директория> можно резервировать все workflow в читаемой, разделенной форме. Команда хорошо подходит для ежедневной задачи cron на сервере, дополненной копированием целевой директории во второе место хранения.

Удаляются ли также workflow и учетные данные при user-management:reset?

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

Могу ли я экспортировать отдельные workflow вместо всего инстанса?

Да. С помощью export:workflow --id=<ID> --output=file.json можно целенаправленно экспортировать один workflow, не затрагивая остальной объем.

Что происходит, если ID импортируемого workflow уже существует?

Существующий workflow с тем же ID при импорте перезаписывается, а не создается как копия. Поэтому перед каждым импортом на работающем инстансе рекомендуется сделать актуальный экспорт в качестве резервного варианта, см. документацию n8n по командной строке и документацию по управлению пользователями.