n8n 2.43.7 CLI 命令详解与实测

n8n 2.43.7 全部 26 个 CLI 子命令：工作流导入导出/激活发布、execute 与 5679 端口冲突坑、凭证与全库实体备份、audit 审计与 license 实跑回显，实测与帮助实采逐条标注。

n8nn8nCLI命令运维2026/10/17

n8n 2.43.7 CLI 命令详解与实测

‍‍​​‌​> 目标：给出 n8n 2.43.7 全部 26 个 CLI 子命令的用途、关键参数与实测回显，覆盖工作流导入导出、批量执行、备份、安全审计与故障场景。实测环境：Ubuntu 22.04 服务器，n8n 2.43.7。逐条标注 ✅ 实测 / 【帮助实采】（仅 --help 验证参数）/ 【参考】。

一、命令全景

$ n8n --version
2.43.7
$ n8n --help          # 输出全部子命令

26 个子命令按用途分组：

分组命令
进程start、worker、webhook、engine
工作流list:workflow、import:workflow、export:workflow、execute、execute-batch、publish:workflow、unpublish:workflow、update:workflow（已弃用）
凭证/实体import:credentials、export:credentials、import:entities、export:entities、export:nodes
用户/许可user-management:reset、mfa:disable、ldap:reset、license:info、license:clear
安全/维护audit、db:revert、community-node、ttwf:generate

二、工作流管理（✅ 全部实测）

2.1 list:workflow

$ n8n list:workflow
JB97JNkL2l1EVbyu|Webhook Echo Demo (API renamed)
j14aJ0OcFlLHsq46|CLI Manual Demo

$ n8n list:workflow --active=true     # 只看已激活
$ n8n list:workflow --onlyId          # 每行一个 ID，喂给脚本用

输出格式为 ID|名称。

2.2 import:workflow

$ n8n import:workflow --input=cli-test-wf.json
Successfully imported 1 workflow.

关键参数：--separate --input=目录/（批量导入目录内 *.json）；--userId=<uuid> 或 --projectId=<id> 指定归属；--activeState=fromJson（按 JSON 内 active 字段导入，默认强制 false）。

2.3 export:workflow

$ n8n export:workflow --id=j14aJ0OcFlLHsq46 --output=wf.json --pretty
Successfully exported 1 workflow.

$ n8n export:workflow --backup --output=backups/
Successfully exported 2 workflows.
$ ls backups/
JB97JNkL2l1EVbyu.json  j14aJ0OcFlLHsq46.json

--backup 等价 --all --pretty --separate，一个工作流一个文件，适合进版本库。另有 --published（导出已发布版本）与 --version=<versionId>。

2.4 激活/发布

$ n8n update:workflow --id=<id> --active=true
⚠️  WARNING: The "update:workflow" command is deprecated.
Please restart n8n for changes to take effect if n8n is currently running.

$ n8n list:workflow --active=true     # 确认已激活

2.43.7 推荐用发布语义（均实测执行成功，同样提示运行中实例需重启生效）：

n8n publish:workflow --id=<id>      # 发布当前版本
n8n unpublish:workflow --id=<id>

update:workflow 仍可用但已打弃用警告。

三、执行类

3.1 execute：单次执行

$ n8n execute --id=<id> --rawOutput

--rawOutput 时输出完整执行 JSON（实测截选）：

{
  "data": {
    "resultData": {
      "runData": {
        "Code": [ { "executionStatus": "success",
          "data": { "main": [ [ { "json": { "hello": "from-put" } } ] ] } } ]
      },
      "lastNodeExecuted": "Code"
    }
  },
  "mode": "cli",
  "status": "success",
  "finished": true
}

⚠️ 实测坑：常驻 n8n 服务运行时，同机再跑 n8n execute 会报： n8n Task Broker's port 5679 is already in use. Do you have another instance of n8n running already? 处理：批量任务放到维护窗口执行（先停服务），或为该次执行指定不同的 Broker 端口错开。执行记录仍会入库，编辑器/API 均可查（mode: "cli"）。

3.2 execute-batch：批量执行【帮助实采】

n8n execute-batch --ids=id1,id2 --concurrency=2 --output=/var/n8n/runs/

参数：--ids（逗号分隔或文件）、--concurrency（默认 1）、--output（保存执行）、--snapshot/--compare/--shallow（快照对比回归测试）、--skipList（跳过清单）。

四、备份与迁移（✅ 核心路径实测）

命令用途实测要点
export:credentials --backup --output=dir/凭证导出--decrypted 会以明文导出（帮助原文警告 ALL SENSITIVE INFORMATION WILL BE VISIBLE），仅在跨密钥迁移时用
import:credentials --input=file.json凭证导入支持 --include/--exclude 字段筛选、--userId/--projectId 归属
export:entities --outputDir=/path全库实体导出--includeExecutionHistoryDataTables 默认排除大表
import:entities --inputDir=/path全库实体导入--truncateTables 先清表；配 --keyFile 换密钥
export:nodes --output=nodes.json导出全部节点类型清单✅ 实测 "Successfully exported 922 node types"，17.8 MB

备份策略组合见《n8n 2.43.7 运维手册：备份、升级、日志与监控》。

五、运维与安全类

5.1 audit：安全审计（✅ 实跑）

$ n8n audit --days-abandoned-workflow=10

输出风险报告 JSON，覆盖 credentials/database/nodes/filesystem/instance 五类（可用 --categories=database,credentials 裁剪）。实测报告含遥测状态 diagnosticsEnabled: true 等实例画像。建议纳入每周维护。

5.2 license:info（✅ 实跑）

expiresAt: <n/a>
isValid: false (!)
entitlements: 0

无授权即社区版；license:clear 清除本地许可证书【帮助实采】。

5.3 危险命令（先备份再动手）

命令后果
user-management:reset✅ 无参数、无确认提示，直接把用户库重置回初始态——Owner 账户与 API Key 全部失效
db:revert回退最后一次数据库迁移（升级失败回滚用）
ldap:reset重置 LDAP 配置
mfa:disable --email=user@x.com关闭指定用户 MFA（锁死时的救援通道）
community-node --uninstall --package=<pkg>卸载社区节点及其凭证

5.4 ttwf:generate：AI 生成工作流【帮助实采】

n8n ttwf:generate --prompt "Create a telegram chatbot that can tell current weather in Berlin" --output=result.json
n8n ttwf:generate --input=dataset.jsonl --output=results.jsonl --concurrency=4

六、进程形态

命令说明
n8n start主进程：编辑器 + API + 激活的工作流触发器；-o 自动开浏览器
n8n worker --concurrency=10队列模式执行器（需外置消息队列；--concurrency 默认 10）
n8n webhook独立 webhook 进程，只处理生产 URL（大规模分流用）
n8n engineengine v2 数据面，需主进程以 N8N_ENGINE_MODE=remote 作为控制面

单机部署用 start 即可；worker/webhook/engine 属水平扩展架构【进程入口与参数实采，多机队列模式未长跑】。

七、实测速查表

场景命令
看有哪些工作流n8n list:workflow
批量备份工作流n8n export:workflow --backup --output=backups/
批量备份凭证n8n export:credentials --backup --output=creds/
恢复工作流n8n import:workflow --separate --input=backups/
跑一次指定工作流n8n execute --id=<id> --rawOutput（注意 5679 冲突）
周期安全体检n8n audit
查许可状态n8n license:info
重置用户体系n8n user-management:reset（不可逆！）

环境变量如何影响这些命令的行为（端口、路径、时区、日志）见《n8n 2.43.7 配置参数详解（环境变量实测）》；用 Public API 完成同类操作见《n8n 2.43.7 Public API 使用指南（实测）》。

相关文档