今天我们发布 n8n 3.0.0 BETA 版本
n8n 3.0 聚焦于内部改动,以提升可靠性、稳定性和安全性,并为接下来要构建的改进奠定基础。它清理了遗留功能,收紧了安全默认设置,并重构了 n8n 底层运行方式的部分内容。
简而言之:测试版今天即可使用,稳定版将于 12 月初发布。由于 3.0 包含破坏性变更,部分工作流和设置可能需要在升级前进行更新。你实例中的迁移报告会准确告诉你哪些需要更新。
即使你不打算立即升级,现在也值得看一看。
为什么要更改版本号?
n8n 遵循 语义化版本。这意味着我们不会在不提升主版本号的情况下发布破坏性变更(可能需要你更改工作流或配置的更新)。
在过去一年里,我们收集了一份想要实施的破坏性变更清单:要移除的遗留代码路径、要变得更安全的默认设置、要淘汰的一些功能。每一项都必须等到主版本发布,因此 3.0 将它们汇集在一个版本中。
如果你想知道新功能去哪了,它们并没有等待。我们持续发布功能,而不是把它们留到主版本。自 2025 年 12 月 2.0 发布以来,我们已经发布了 45 个以上版本,大约每周一个,其中许多都包含重要的新功能。完整列表在我们的 更新日志.
中。
这就是为什么 3.0 可以纯粹聚焦于基础,而稳定版发布之后的所有新内容都会在 3.x 上发布。
3.0 版本包含什么 3.0 破坏性变更文档 中有详细列表,说明了每项变更需要做什么。以下是主要主题,并附有一些示例。
可靠性与稳定性
- 队列模式。 手动执行现在始终在工作节点上运行,因此主实例不再承担这项工作。
- 二进制数据。 内存中的二进制数据模式已被移除。实例使用文件系统,或 S3 及其他外部存储,这在负载下更具可预测性。
- 防止失控工作的护栏。 Code 节点的默认超时(任务运行器)从 5 分钟降至 1 分钟,并且可以配置。解压缩限制更低,以保护实例免受超大归档(“zip 炸弹”)的影响。
- 调度。 旧的 Cron 和 Interval 节点被 Schedule Trigger 取代,后者运行在 n8n 更持久的调度器上。
安全性
我们让多项默认设置更安全:
- 加密密钥轮换始终开启。
- Slack 凭据需要签名密钥,因此没有人能发送伪装成 Slack 的伪造请求。
- 启用 SSRF 保护时,默认的 SSRF(服务端请求伪造)阻止列表更大。
- 未经验证的社区包默认关闭。
自托管
自托管的 n8n 现在运行在 Docker 上。不再支持使用 npm 或 npx n8n 进行安装,部分原因是新的安全功能依赖于容器环境。如果你喜欢 npx n8n 的快捷,有一个 一行安装脚本 可以达到同样的效果。Kubernetes 和 Helm 部署不受影响。
清理
我们移除了遗留节点:Function、Function Item、Item Lists、Cron、Interval、旧版 OpenAI 节点、较旧的 AI Agent 模式、旧版本的 Edit Image 节点、用于已不存在服务的节点等。大多数都有直接替代品(Function 变为 Code 节点;Item Lists 变为 Split Out、Aggregate、Sort、Limit、Remove Duplicates 或 Summarize),并且许多会自动迁移。
还有一些功能也被淘汰。Chat Hub 默认关闭(你可以在 3.x 中重新开启;n8n AI 助手和代理正在取代它),编辑器中的 Import from URL 已移除,Code 节点中的 Ask AI 标签页也已移除。
检查你是否已准备好:迁移报告
这是如果我什么都不读,也会读的部分。
版本 2.39 或更高版本的每个实例都在 设置 > 迁移报告.
下有一份迁移报告。最新的 2.x 版本拥有最新版本的报告,随着我们获得更多反馈,我们将继续改进体验,所以请先更新。
它的作用如下:
- 列出受 3.0 影响的工作流和实例级设置。
- 自动修复许多问题。每个修复都会保存为新的工作流版本供你审查和发布,而你已发布的工作流在你操作期间继续在 v2 上运行。
- 为每个工作流建议负责人(最后编辑它的人),允许管理员重新分配,并通过电子邮件通知负责人需要修复什么。
- 过滤掉未发布或长时间未运行的工作流,这样你可以将这些标记为“不予修复”并继续。
- 导出 CSV 摘要。
管理员可以看到每个工作流;其他用户可以看到他们有权访问的工作流。与去年不同,你不需要是管理员才能看到它。
我们推荐的路径:
- 更新到最新的 2.x 并打开迁移报告。
- 修复或标记“不予修复”它标记的所有内容。
- 进行完整备份。
- 先升级测试或预发布实例,然后升级生产环境。
今天就试用测试版
无需注册。
- 自托管: 像安装任何其他测试版一样安装它。
- n8n Cloud: 在
3.0.0 Beta (early access)更改你的 n8n 版本 时选择.
点击前需要知道的一件事: 迁移到 3.x 是单向的。 无法回到 2.x。先在测试实例上试用,并进行完整备份。
2.0 发布一年以来
才过去一年,但这些数字值得一看。
这些数字背后是那些提交问题、构建节点、在论坛回答问题、撰写教程,并在出问题时告诉我们的人。感谢你们所做的一切。
常见问题:你需要知道的事
这什么时候发生?
测试版(3.0.0)今天,10 月 27 日。稳定版(3.x)在 12 月初。关注 发布说明 以获取更新。
有哪些破坏性变更?
以下是全部内容,以及每项该怎么做,都在 3.0 破坏性变更文档.
我如何知道自己是否受影响?
在“设置 > 迁移报告”中打开迁移报告(版本 2.39 或更高)。 设置 > 迁移报告 (版本 2.39 或更高)。
社区版会获得所有 3.0 更新吗?
是的。3.0 中的所有内容都适用于自托管的社区版、云版和企业/商业版。
2.x 会怎样?
稳定版发布后,2.x 将获得 12 个月的安全和关键错误修复。新功能仅在 3.x 上提供。
我还在用 1.x,该怎么办?
请先升级到 2.x;从 1.x 无法直接升级到 3.x。对 1.x 的支持将于 2026 年 12 月 31 日结束。
我可以回滚吗?
不能。升级前请先做完整备份;回滚意味着要恢复这份备份。
会有停机时间吗?
短暂重启,就像任何升级一样。
我的凭据和执行历史会保留吗?
会。
如果我有问题怎么办?
回复 公告帖 在社区论坛中提问,我们会帮助你解决问题。
感谢 Ophir 和整个 n8n 团队!
与我们分享
n8n 用户来自不同背景、经验水平和兴趣领域。我们一直希望在博客文章中介绍不同的用户及其项目。如果你正在使用 n8n 并希望激励社区, 联系我们 💌
分享