保存并发布工作流程
n8n 会在您编辑工作流时自动保存更改。当您准备将工作流投入生产环境时,请发布工作流。这种方式可以避免生产环境中的意外变更,同时支持安全迭代与审查。
保存机制
编辑时系统会自动保存更改,通常在 1 到 5 秒内完成。无需手动点击保存按钮。发布前,所有编辑内容都会保留为草稿。
发布的工作原理
发布会让工作流上线并锁定到某个特定版本。生产执行将使用已发布版本,而不是您最新的编辑内容。发布后,工作流会启用以下能力:
- Webhook 和表单触发器将使用其生产 URL
- 时间表将在您定义的时间运行
- 来自连接应用程序的事件将触发此工作流程
发布是异步进行的。发布时,n8n 会找出上一个已发布版本与新版本之间发生变化的触发器,然后在后台只应用这些变更。未发生变化的触发器会继续运行,不会中断。新版本也会在此过程中上线。在 n8n 确认结果前,Publish 发布按钮会显示 Publishing 正在发布。n8n 会将此状态存储在服务器上,因此即使在发布期间重新加载页面,按钮仍会显示 Publishing 正在发布,并在收到结果时更新。
初始状态:当工作流没有可发布更改时,Publish 按钮处于禁用状态。

可发布状态:当工作流尚未发布且存在更改时,按钮会变为可用。

已发布且最新:工作流当前已发布,并且自上次发布以来没有新变更。

已发布但有新变更:工作流已发布,但您在上次发布后进行了尚未上线的更改。

已发布但变更无效:工作流已发布,但当前状态不满足再次发布条件(例如没有需要发布的触发器)。

已发布但存在错误:工作流已发布,但最近更改中存在错误,需要修复后才能再次发布。

Publishing 正在发布:发布后,n8n 会在后台注册触发器。在 n8n 确认结果前,按钮会一直显示此状态。
Published, partial 已部分发布:n8n 已发布新版本,但至少有一个触发器未能激活,例如连接的应用程序不可用。工作流会继续运行已成功激活的触发器,n8n 不会取消发布工作流。将鼠标悬停在按钮上可查看失败的触发器,然后再次发布以重试。
Failed to publish 发布失败:工作流的所有触发器都未能激活,因此工作流未运行。已发布版本仍会保留,你可以再次发布以重试。
协作如何运作
同一时间只能由一人编辑工作流。如果其他人正在编辑:
- 你会以只读模式查看该工作流
- 对方停止编辑或处于非活动状态时,编辑锁会释放
- 随后你可以基于最新更改接管编辑
检查发布状态
在 Workflows 工作流 页面中,已发布工作流的卡片上会显示状态标记。

发布工作流程
当存在未发布更改时,画布页眉中的 Publish 发布 按钮会启用。
每当您对工作流做出更改,n8n 都会自动将其保存为新的工作流版本。只有发布后,这些已保存版本才会在生产环境中生效。
- 选择 Publish 发布 按钮(或使用快捷键
Shift+p)打开发布模态窗口。 - 版本名称默认为 UUID。你可以自定义名称并添加版本描述。
-
选择 Publish 发布,让更改在生产环境中生效。生产执行始终指向当前发布的版本。
如果您仅更新工作流程设置,n8n 将重新发布版本,无需您执行任何操作。

提示
Workflow reviews 工作流审查
如果您的实例启用了工作流审查,可以提交版本进行审查,而不是立即发布。审查进行期间,n8n 会阻止发布该工作流。有关计划可用性和审查工作方式,请参阅工作流审查。
命名版本
提示
Feature availability 功能可用性
命名版本可用于:
- n8n Cloud: Pro、Enterprise
- Self-hosted: Business、Enterprise
命名版本允许您为任何工作流程版本提供有意义的名称和描述。这可以帮助您识别工作流程开发中的重要里程碑。命名版本也受到自动版本历史修剪的保护,因此它们会无限期地持续存在。
从画布页眉命名版本:
- 选择 Publish 发布 按钮旁边的下拉箭头(或使用快捷键
Cmd/Ctrl+s)。 - 选择 Name version 命名版本。
- 输入名称和可选描述。
- 选择 Save 保存。

从版本历史页命名版本:
- 通过选择标题中的历史记录图标打开版本历史记录。
- 在要命名的版本上,选择 Options 选项
。 - 选择 Name version 命名版本。
- 输入名称和可选说明。
- 选择 Save 保存。
管理版本历史记录
点击页眉中的历史图标可查看并管理版本历史。在版本历史视图中,您可以:
- 取消发布工作流,将其从生产环境中移除
- 恢复到先前版本。恢复后,您可以在不影响生产执行的情况下继续编辑
- 发布工作流的其他版本
- 命名版本以避免被自动清理
如何取消发布工作流程
您可以通过以下任一方式取消发布工作流:
- 画布标题中 Publish 发布按钮旁边的下拉箭头(或使用快捷键
Cmd/Ctrl+u)。 - 工作流列表。
- 版本历史记录页面(对已发布版本执行取消发布操作)。