更新自托管 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 改回旧版本并不会撤销数据库迁移。要回滚:
- 停止所有 n8n 进程:主进程、worker、所有 webhook 处理器以及外部 task runner。
- 通过以下两种方式之一,将数据库恢复到更新之前的状态:
-
撤销本次更新所应用的迁移。 你需要用到更新前记下的最新迁移。如果没有记下,请改为恢复备份。
- 检查数据库中的
migrations表。它列出了 n8n 已运行的迁移。如果 n8n 使用了表前缀,表名会以该前缀开头;如果 n8n 使用了自定义 schema,该表位于该 schema 中。如果最新的迁移就是你在更新前记下的那个,请停止撤销,进入下一个回滚步骤。 - 保持其他所有 n8n 进程处于停止状态。使用较新的 n8n 版本和现有的数据库配置运行
n8n db:revert,例如以较新镜像的一次性容器方式运行。每次运行只会撤销最近的一个迁移。 - 检查命令的输出:
- 如果输出以
Cancelled command开头,或者提示 n8n 找不到该迁移的代码,说明 n8n 没有撤销该迁移。在这些情况下n8n db:revert的退出状态为 0,因此不能依赖退出状态判断。 - 如果输出显示
Error reverting last migration,说明命令失败,并以非零状态退出。请先修复错误,再重复此步骤。 - 否则,说明 n8n 已撤销一个迁移。
- 如果输出以
- 从第 1 步开始重复。
如果 n8n 无法撤销其中某个迁移,请改为恢复备份。撤销迁移会将数据库结构改回原样,但不一定能找回该迁移删除的数据。 * 从更新前所做的备份恢复数据库。 这会丢弃备份之后所做的所有更改。恢复期间请保持所有 n8n 进程处于停止状态,并且不要执行恢复步骤最后的启动 n8n 操作。请参阅恢复完整实例。 3. 数据库恢复到更新前的状态后,使用旧的 n8n 版本启动每个进程。如果你运行了外部 task runner,也要将它们恢复到对应的旧版
n8nio/runners版本。 - 检查数据库中的
-