n8n 中文文档

保存并发布工作流程

n8n 会在您编辑工作流时自动保存更改。当您准备将工作流投入生产环境时,请发布工作流。这种方式可以避免生产环境中的意外变更,同时支持安全迭代与审查。

保存机制

编辑时系统会自动保存更改,通常在 1 到 5 秒内完成。无需手动点击保存按钮。发布前,所有编辑内容都会保留为草稿。

发布的工作原理

发布会让工作流上线并锁定到某个特定版本。生产执行将使用已发布版本,而不是您最新的编辑内容。发布后,工作流会启用以下能力:

  • Webhook 和表单触发器将使用其生产 URL
  • 时间表将在您定义的时间运行
  • 来自连接应用程序的事件将触发此工作流程

发布是异步进行的。发布时,n8n 会找出上一个已发布版本与新版本之间发生变化的触发器,然后在后台只应用这些变更。未发生变化的触发器会继续运行,不会中断。新版本也会在此过程中上线。在 n8n 确认结果前,Publish 发布按钮会显示 Publishing 正在发布。n8n 会将此状态存储在服务器上,因此即使在发布期间重新加载页面,按钮仍会显示 Publishing 正在发布,并在收到结果时更新。

初始状态:当工作流没有可发布更改时,Publish 按钮处于禁用状态。

没有未发布的更改时,Publish 按钮呈灰色禁用状态

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

工作流存在未发布的更改时,Publish 按钮处于可用状态

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

Publish 按钮显示工作流已发布且为最新状态,没有待发布的更改

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

Publish 按钮显示工作流已发布,但仍有尚未上线的更改

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

Publish 按钮显示工作流无法重新发布,因为没有需要发布的触发器

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

Publish 按钮显示错误状态,因为最近的更改中存在需要修复的错误

Publishing 正在发布:发布后,n8n 会在后台注册触发器。在 n8n 确认结果前,按钮会一直显示此状态。

Published, partial 已部分发布:n8n 已发布新版本,但至少有一个触发器未能激活,例如连接的应用程序不可用。工作流会继续运行已成功激活的触发器,n8n 不会取消发布工作流。将鼠标悬停在按钮上可查看失败的触发器,然后再次发布以重试。

Failed to publish 发布失败:工作流的所有触发器都未能激活,因此工作流未运行。已发布版本仍会保留,你可以再次发布以重试。

协作如何运作

同一时间只能由一人编辑工作流。如果其他人正在编辑:

  • 你会以只读模式查看该工作流
  • 对方停止编辑或处于非活动状态时,编辑锁会释放
  • 随后你可以基于最新更改接管编辑

检查发布状态

在 Workflows 工作流 页面中,已发布工作流的卡片上会显示状态标记。

Workflows 列表中的工作流卡片上显示已发布标记

发布工作流程

当存在未发布更改时,画布页眉中的 Publish 发布 按钮会启用。

每当您对工作流做出更改,n8n 都会自动将其保存为新的工作流版本。只有发布后,这些已保存版本才会在生产环境中生效。

  1. 选择 Publish 发布 按钮(或使用快捷键 Shift + p)打开发布模态窗口。
  2. 版本名称默认为 UUID。你可以自定义名称并添加版本描述。
  3. 选择 Publish 发布,让更改在生产环境中生效。生产执行始终指向当前发布的版本。

    如果您仅更新工作流程设置,n8n 将重新发布版本,无需您执行任何操作。

Publish 模态窗口包含可编辑的版本名称(默认为 UUID)和描述字段

提示

Workflow reviews 工作流审查

如果您的实例启用了工作流审查,可以提交版本进行审查,而不是立即发布。审查进行期间,n8n 会阻止发布该工作流。有关计划可用性和审查工作方式,请参阅工作流审查。

命名版本

提示

Feature availability 功能可用性

命名版本可用于:

  • n8n Cloud: Pro、Enterprise
  • Self-hosted: Business、Enterprise

命名版本允许您为任何工作流程版本提供有意义的名称和描述。这可以帮助您识别工作流程开发中的重要里程碑。命名版本也受到自动版本历史修剪的保护,因此它们会无限期地持续存在。

从画布页眉命名版本:

  1. 选择 Publish 发布 按钮旁边的下拉箭头(或使用快捷键 Cmd/Ctrl + s)。
  2. 选择 Name version 命名版本。
  3. 输入名称和可选描述。
  4. 选择 Save 保存。

Publish 按钮的下拉菜单中显示 Name version 选项

从版本历史页命名版本:

  1. 通过选择标题中的历史记录图标打开版本历史记录。
  2. 在要命名的版本上,选择 Options 选项 Options icon。
  3. 选择 Name version 命名版本。
  4. 输入名称和可选说明。
  5. 选择 Save 保存。

管理版本历史记录

点击页眉中的历史图标可查看并管理版本历史。在版本历史视图中,您可以:

  • 取消发布工作流,将其从生产环境中移除
  • 恢复到先前版本。恢复后,您可以在不影响生产执行的情况下继续编辑
  • 发布工作流的其他版本
  • 命名版本以避免被自动清理

如何取消发布工作流程

您可以通过以下任一方式取消发布工作流:

  • 画布标题中 Publish 发布按钮旁边的下拉箭头(或使用快捷键 Cmd/Ctrl + u)。
  • 工作流列表。
  • 版本历史记录页面(对已发布版本执行取消发布操作)。

相关资源

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。