n8n 中文文档

应用更改

应用更改会将你的工作从环境引入你的实例。项目级应用将选定的更改引入一个团队项目。实例级应用让整个实例与环境保持一致。

提示

Preview status 预览状态

环境功能处于 Preview 阶段,未来版本中可能会发生变化。在为生产实例设置之前,请先在测试实例上试用。

开始之前,请添加此实例要从中应用更改的环境。请参阅规划环境。

添加缺失的项目

项目级应用要求该项目已存在于实例上。如果环境的分支中包含此实例上尚不存在的团队项目,请先添加它们:

  1. 前往 Settings 设置 > Environments 环境。
  2. 在 Apply changes from 从以下位置应用更改 下的环境上,选择 Apply 应用 旁边的 Add N missing projects 添加 N 个缺失项目。
  3. 选择要添加的项目。可选:在 Assign a project admin 分配项目管理员 下,为每个项目选择一个用户。
  4. 确认 Add N missing projects 添加 N 个缺失项目。

n8n 会创建空项目,并沿用源实例中的 ID、名称、图标和描述,但不会应用任何内容。如果某个项目在分支上有工作流,请打开该项目并运行项目级应用。

不要手动创建这些项目。手动创建的项目会获得不同的 ID,因此即使名称相同,应用也不会匹配它,该项目仍会显示为缺失。

项目级应用

项目级应用会将你选择的更改引入一个团队项目。该项目必须以源实例的 ID 存在于实例上。请参阅添加缺失的项目。项目级应用绝不会删除项目。实例上的所有项目共享标签,因此标签重命名会在每个项目中生效。

  1. 打开一个团队项目。项目名称旁边有一个带向下箭头的徽标,显示传入更改的数量。
  2. 选择该徽标,打开 Changes to apply 待应用的更改 页面。
  3. 选择要应用的工作流。n8n 会包含它们的依赖项,例如凭据、变量、数据表和标签。
  4. 检查更改。每个资源都会显示其变更类型,例如 New 新建、Modified 已修改、Renamed 已重命名、Moved 已移动、Archived 已归档 或 Deleted 已删除。要直观比较工作流,请选择 Show diff 显示差异。差异查看器会显示画布的 Before 之前 和 After 之后,其中 Before 是此实例,After 是环境的分支。
  5. 查看 Blockers 阻止项 选项卡并解决所有阻止项。请参阅解决阻止项。
  6. 选择 Apply N changes 应用 N 项更改,然后确认。

解决阻止项

在应用写入任何内容之前,n8n 会根据实例检查这些更改。项目级应用和实例级应用都会进行此检查。阻止项会让应用停止,直到你解决它;只要还有阻止项,应用就不会做任何更改。

阻止项 处理方法
Missing 缺失 凭据或变量 选择 Add credential 添加凭据 或 Add variable 添加变量 并创建它。对于凭据,n8n 会预先填入源实例上使用表达式的字段。对于变量,n8n 会预先填入源实例中的值。由其他项目拥有的凭据会显示为冲突。请参阅跨项目依赖。
No access 无访问权限 凭据已存在,但该项目无法使用它。请让管理员将其共享给该项目。
Conflict 冲突 该资源在实例上的差异是应用无法修复的。按照提示信息操作,然后刷新。
Moved 已移动 该工作流或文件夹在分支上位于另一个项目中。项目级应用无法在项目之间移动条目。请在实例上移动它以与分支保持一致,或运行实例级应用。

确认破坏性更改

在执行以下操作之前,应用会要求你确认:

  • 删除数据表列或更改其类型。这会删除这些列中的值,行和其他列会保留。
  • 在实例级应用中删除项目。

实例级应用

危险

实例级应用会覆盖每个项目,使其与环境的分支一致。它会删除不在分支上的项目和内容,且无法撤销。请仅在源实例完成实例级推广之后,或在备份实例之后,才运行实例级应用。

使用实例级应用可以让实例与其环境完全一致,例如为新的生产实例初始化内容。对于日常更改,n8n 建议使用项目级应用,它能提供更精细的控制。

  1. 前往 Settings 设置 > Environments 环境。
  2. 在 Apply changes from 从以下位置应用更改 下的环境上,选择 Apply 应用。
  3. 阅读警告并选择 Apply 应用。
  4. 如果 n8n 发现阻止项或破坏性更改,会打开一个对话框。解决阻止项、检查更改并确认。要删除不在分支上的项目,请确认 Delete N projects and apply 删除 N 个项目并应用。

应用会在实例上更改什么

应用会带来你工作的结构,例如工作流、文件夹和数据表结构(schema)。它不会带来存储的内容,例如凭据密钥的字面值或数据表行。目前尚不包含智能体(Agents)。

资源 应用的行为
项目 实例级应用会创建分支上存在的项目,并在你确认后删除分支上不存在的项目。项目级应用绝不会创建或删除项目。要添加缺失的项目,请参阅添加缺失的项目。
文件夹 在项目内创建、重命名和移动文件夹,使其与分支一致。项目级应用只更改包含所选工作流的文件夹。
工作流 创建或更新工作流。如果你在源实例上删除了某个工作流,应用会在实例上删除它,而不是将其归档。已归档的工作流保持归档状态。应用不会改变工作流的发布状态。通过应用创建的工作流在到达时处于未发布状态,因此请在实例上发布它们。
凭据 将工作流关联到具有相同 ID 的凭据。如果凭据缺失,你需要在解决阻止项时创建它。如果凭据已存在且属于该项目,应用会更新其名称和使用表达式的字段,并保留其他所有值,例如密钥。
变量 变量必须已存在于实例上,或者你在解决阻止项时创建它(会预先填入源实例中的值)。应用绝不会更改现有变量的值。
数据表 创建数据表或更新其结构。现有行会保留。删除某列或更改其类型时,只会在你确认后删除该列的值。
标签 创建标签并重命名,使其与分支一致。应用绝不会删除标签。

应用按以下方式匹配实例上的内容:

  • 按 ID: 项目、工作流、凭据和数据表。
  • 按名称和范围: 变量。
  • 先按 ID,再按名称: 标签。

推广和应用使用 n8n 包来导出和导入这些内容。

如果应用中途停止

分支已更改

如果在你加载更改后有人修改了环境的分支,应用会在写入任何内容之前停止。项目级应用会显示 The branch changed after the page loaded, so Apply didn't change anything.,实例级应用会显示 Apply paused。请查看最新更改,然后再次应用。

无法应用

如果实例级应用失败,n8n 会显示 Couldn't apply to the instance 和 Some changes may already be applied。n8n 不会回滚已经做出的更改。应用会让实例与分支保持一致,因此你可以再次运行它来完成操作。

如果项目级应用失败,n8n 会显示 Couldn't apply the changes 以及以下其中一项:

  • Nothing changed: 根据提示信息修复原因,然后重试。
  • The request may have run: 页面现在会显示最新更改。再次应用之前请先检查这些更改。

相关资源

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