n8n 中文文档

更新自托管 n8n

保持 n8n 版本最新可以获得最新的功能和修复。

更新时的一些提示:

  • 经常更新:这可以避免一次跨越多个版本,降低更新造成中断的风险。尽量至少每月更新一次。
  • 查看 Release notes 发布说明,了解 breaking changes。
  • 使用 Environments 环境 创建实例的测试版本。请先在那里测试更新。

有关如何更新的说明,请参阅您的安装方法的文档:

更新队列模式下的实例

在队列模式下,主进程、worker 和可选的 webhook 处理器共享同一个数据库。请将它们作为一次协调的变更来更新,并在开始之前规划好回滚方式。

更新队列模式下的实例之前

  • 进行完整备份,包括数据库和加密密钥。如果 n8n 无法撤销本次更新所应用的迁移,你需要用这份备份恢复到之前的版本。
  • 记下数据库 migrations 表中最新的迁移,以便回滚时知道在哪里停止。例如,在没有表前缀的情况下,运行 SELECT name FROM migrations ORDER BY id DESC LIMIT 1;。如果 n8n 使用了表前缀(DB_TABLE_PREFIX),请将 migrations 替换为带前缀的表名。如果 n8n 使用了自定义 schema(DB_POSTGRESDB_SCHEMA),请加上 schema 名称,例如 <schema-name>.migrations。这两个设置也都可能来自对应的 _FILE 变量,例如 DB_POSTGRESDB_SCHEMA_FILE。
  • 阅读当前版本之后、直到目标版本(含)的每个版本的发行说明。
  • 如果你使用 n8n Helm chart 部署,请检查目标 n8n 版本是否需要更新的 chart 版本。chart 有自己的版本号,与它所部署的 n8n 版本相互独立。

在每个进程上运行相同的 n8n 版本

在所有主进程、worker 和 webhook 处理器上运行相同的 n8n 版本。请固定使用特定的镜像标签,例如 n8nio/n8n:<n8n-version>,并在每个进程上使用它,而不是使用 latest。

如果你以外部模式运行 task runner,n8nio/runners 镜像版本必须与 n8nio/n8n 镜像版本一致。请同时更新两者。

如果你计划在更新过程中开启 webhook 响应转存,请先升级每个主进程和 webhook 处理器,然后再在 worker 上设置 N8N_WEBHOOK_RESPONSE_RELAY_OFFLOAD_ENABLED。详情请参阅在升级期间开启转存。

更新期间 n8n 如何运行数据库迁移

每个主进程、worker 或 webhook 进程在启动时都会检查并运行待处理的数据库迁移。

在 PostgreSQL 上,迁移锁从 n8n 2.33.0 起可用。一个进程获取 advisory lock,并在单个事务中运行所有待处理的迁移。其他进程等待该锁,之后会发现没有待处理的迁移。

该锁只在启动时将迁移串行化。它不保证运行不同 n8n 版本的进程能够协同工作,也不保证你可以在不停机的情况下完成更新。

回滚队列模式下的更新

将镜像标签或 Helm release 改回旧版本并不会撤销数据库迁移。要回滚:

  1. 停止所有 n8n 进程:主进程、worker、所有 webhook 处理器以及外部 task runner。
  2. 通过以下两种方式之一,将数据库恢复到更新之前的状态:
    • 撤销本次更新所应用的迁移。 你需要用到更新前记下的最新迁移。如果没有记下,请改为恢复备份。

      1. 检查数据库中的 migrations 表。它列出了 n8n 已运行的迁移。如果 n8n 使用了表前缀,表名会以该前缀开头;如果 n8n 使用了自定义 schema,该表位于该 schema 中。如果最新的迁移就是你在更新前记下的那个,请停止撤销,进入下一个回滚步骤。
      2. 保持其他所有 n8n 进程处于停止状态。使用较新的 n8n 版本和现有的数据库配置运行 n8n db:revert,例如以较新镜像的一次性容器方式运行。每次运行只会撤销最近的一个迁移。
      3. 检查命令的输出:
        • 如果输出以 Cancelled command 开头,或者提示 n8n 找不到该迁移的代码,说明 n8n 没有撤销该迁移。在这些情况下 n8n db:revert 的退出状态为 0,因此不能依赖退出状态判断。
        • 如果输出显示 Error reverting last migration,说明命令失败,并以非零状态退出。请先修复错误,再重复此步骤。
        • 否则,说明 n8n 已撤销一个迁移。
      4. 从第 1 步开始重复。

      如果 n8n 无法撤销其中某个迁移,请改为恢复备份。撤销迁移会将数据库结构改回原样,但不一定能找回该迁移删除的数据。 * 从更新前所做的备份恢复数据库。 这会丢弃备份之后所做的所有更改。恢复期间请保持所有 n8n 进程处于停止状态,并且不要执行恢复步骤最后的启动 n8n 操作。请参阅恢复完整实例。 3. 数据库恢复到更新前的状态后,使用旧的 n8n 版本启动每个进程。如果你运行了外部 task runner,也要将它们恢复到对应的旧版 n8nio/runners 版本。

相关资源

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