n8n 1.0 迁移指南
本文档总结了更新到 n8n 1.0 之前应注意的事项。
n8n 1.0 的发布标志着 n8n 使 n8n 可用于要求苛刻的生产环境的旅程中的一个里程碑。 n8n 1.0 代表了过去四年投入的辛勤工作,使 n8n 成为最易于使用、功能强大且多功能的自动化工具。 n8n 1.0 现已准备好在生产中使用。
新功能
代码节点 中的 Python 支持
尽管 JavaScript 仍然是默认语言,但您现在还可以选择 Python 作为 代码节点 中的选项,甚至可以使用 许多Python模块。请注意,Python 在 n8n 1.0 之前的工作流中添加的代码节点中不可用。
执行订单
n8n 1.0 引入了多分支工作流程的新执行顺序:
在多分支工作流程中,n8n 需要确定分支上节点的执行顺序。以前,n8n 执行每个分支的第一个节点,然后执行每个分支的第二个节点,依此类推(广度优先)。新的执行顺序确保每个分支在开始下一个分支之前完全执行(深度优先)。分支根据其在画布上的位置从上到下执行。如果两个分支处于相同高度,则最左边的分支首先执行。
n8n 用于执行多输入节点,只要它们在第一个输入上接收到数据即可。连接到多输入节点的第二个输入的节点无论是否接收到数据都会自动执行。 n8n 1.0 中引入的新执行顺序简化了这一行为:节点现在仅在接收数据时执行,并且多输入节点需要至少一个输入上的数据才能执行。
您的现有工作流程将使用旧订单,而新工作流程将使用 n8n 1.0 订单执行。您可以在工作流程设置中配置每个工作流程的执行顺序。
弃用
MySQL 和 MariaDB
n8n 已不再支持 MySQL 和 MariaDB 作为 n8n 的存储后端。这些数据库系统只有少数用户使用,但需要不断的开发和维护工作。 n8n 建议迁移到 PostgreSQL,以获得更好的兼容性和长期支持。
EXECUTIONS_PROCESS 和“自己”模式
以前,您可以使用 EXECUTIONS_PROCESS 环境变量来指定执行是应在 main 进程中运行还是在其 own 进程中运行。此选项和 own 模式现已弃用,并将在 n8n 的未来版本中删除。这是因为它导致代码复杂性增加,同时提供边际效益。从 n8n 1.0 开始,main 将成为新的默认值。
请注意,main 模式下的执行启动速度比 own 模式下快得多。但是,如果工作流消耗的内存多于可用内存,则可能会导致整个 n8n 应用程序崩溃,而不仅仅是工作线程崩溃。为了缓解这种情况,请确保分配足够的系统资源或配置 队列模式 以在多个工作人员之间分配执行。
重大变更
码头工人
权限变更
使用基于 Docker 的部署时,n8n 进程现在由用户 node 而不是 root 运行。此更改提高了安全性。
如果启动 n8n 时 n8n 容器日志中出现权限错误,您可能需要通过在 Docker 主机上执行以下命令来更新权限:
docker run --rm -it --user root -v ~/.n8n:/home/node/.n8n --entrypoint chown n8nio/base:16 -R node:node /home/node/.n8n
图像去除
我们删除了 Debian 和 RHEL 映像。如果您正在使用这些,您需要更改您使用的图像。这不会导致任何错误,除非您基于这些图像之一制作自定义图像。
入口点更改
容器的入口点已更改,您不再需要指定 n8n 命令。如果您之前运行的是 n8n worker --concurrency=5,那么现在是 worker --concurrency=5
由于表达式错误 导致工作流程失败
工作流执行可能会由于表达式中的语法或运行时错误(例如引用不存在的节点的错误)而失败。虽然表达式已经在前端抛出错误,但此更改确保 n8n 也在后端抛出错误,而这些错误之前在后端被默默地忽略。要接收失败工作流程的通知,n8n 建议在工作流程设置下设置“错误工作流程”。
强制所有者账户
此更改使 用户管理 成为强制性的,并删除了对其他身份验证方法(例如 BasicAuth 和外部 JWT)的支持。请注意,n8n.cloud 或自定义计划允许的用户数量仍会根据您的订阅而有所不同。
自定义节点安装目录
n8n 将不再从其全局 node_modules 目录加载自定义节点。相反,您必须将它们安装(或链接)到 ~/.n8n/custom(或 N8N_CUSTOM_EXTENSIONS 定义的目录)。作为 npm 包的自定义节点将位于 ~/.n8n/nodes 中。
如果您有使用 npm link 链接到全局 node_modules 目录的自定义节点,则需要再次将它们链接到 ~/.n8n/nodes 中。
WebSockets
N8N_PUSH_BACKEND 环境变量可用于配置将更新推送到用户界面的两种可用方法之一:sse 和 websocket。从 n8n 1.0 开始,websocket 是默认方法。
日期转换函数
n8n 提供了各种对日期进行操作的转换函数。这些函数可能返回 JavaScript Date 或 Luxon DateTime 对象。使用新行为,返回类型始终与输入匹配。如果您在 Date 上调用日期转换函数,它将返回 Date。同样,如果您在 DateTime 对象上调用它,它将返回 DateTime 对象。
要识别可能受此更改影响的任何工作流和节点,您可以使用此 实用工作流程。
有关日期转换函数的更多信息,请参阅官方文档。
执行数据保留
从n8n 1.0开始,默认保存所有成功、失败和手动工作流程执行。可以在“工作流程设置”下为每个工作流程修改这些设置,也可以使用相应的环境变量进行全局修改。此外,默认情况下将启用 EXECUTIONS_DATA_PRUNE 设置,EXECUTIONS_DATA_PRUNE_MAX_COUNT 设置为 10,000。这些默认设置旨在防止使用 SQLite 时性能下降。确保根据您的个人要求和系统容量来配置它们。
已删除 N8N_USE_DEPRECATED_REQUEST_LIB
旧版 request 库已被弃用一段时间。从 n8n 1.0 开始,通过设置 N8N_USE_DEPRECATED_REQUEST_LIB 环境变量在 HTTP 请求节点中回退到它的功能已被完全删除。 HTTP 请求节点现在将始终使用新的 HttpRequest 接口。
如果您构建自定义节点,请参阅 HTTP 请求助手 以获取有关迁移到新接口的更多信息。
已删除 WEBHOOK_TUNNEL_URL
从 n8n 0.227.0 开始,n8n 已将 WEBHOOK_TUNNEL_URL 配置选项重命名为 WEBHOOK_URL。在n8n 1.0中,WEBHOOK_TUNNEL_URL已被删除。更新您的设置以反映新名称。有关此配置选项的更多信息,请参阅 文档。
删除节点 16 支持
n8n 现在需要节点 18.17.0 或更高版本。
更新至 n8n 1.0
- 创建 n8n 的完整备份。
- n8n 建议先更新到最新的 n8n 0.x 版本,然后再更新到 n8n 1.x。这将使您能够查明正确版本的任何潜在问题。验证 n8n 0.x 启动没有任何问题后,请继续执行下一步。
- 请仔细阅读上面的 弃用 和 重大变化 部分,以评估它们可能如何影响您的设置。
- 更新至n8n 1.0:
- 在测试期间(2023 年 7 月 24 日之前):如果使用 Docker,请拉取
nextDocker 映像。 - 2023 年 7 月 24 日之后:如果使用 Docker,请拉取
latestDocker 映像。
- 在测试期间(2023 年 7 月 24 日之前):如果使用 Docker,请拉取
- 如果遇到任何问题,请重新部署以前的 n8n 版本并恢复备份。
报告问题
如果您在更新到n8n 1.0的过程中遇到任何问题,请在论坛社区寻求帮助。
谢谢
我们想花一点时间对所有用户的持续支持和反馈表示感谢。您的贡献对于帮助我们使 n8n 成为最好的自动化工具非常宝贵。我们很高兴继续与您合作,推动 n8n 1.0 及更高版本的发布。感谢您成为我们旅程的一部分!