今天我们发布 n8n 版本 3.0.0 BETA

n8n 3.0 侧重于内部改动，提升可靠性、稳定性与安全性，并为接下来要做的改进打好基础。它清理了遗留功能，收紧了安全默认值，并重做了 n8n 底层运行方式的部分环节。

简版说明：beta 版今天就能用，稳定版会在十二月初跟进。由于 3.0 包含破坏性变更，部分工作流和设置可能需要在升级前先做调整。你实例里的迁移报告会明确告诉你具体是哪些。

现在值得看一眼，哪怕你并不打算马上升级。

为什么要改版本号？

n8n 遵循语义化版本。也就是说，我们不会在不提升主版本号的情况下发布破坏性变更（这类更新可能需要你改动自己的工作流或配置）。

过去一年里，我们攒了一份想做的破坏性变更清单：要移除的旧代码路径、要改得更安全的默认值、还有几个要下线的功能。每一项都得等一个大版本，所以 3.0 把它们一起放进了同一个版本里。

如果你在想新功能都去哪了，那它们可没等着。我们是持续发版，而不是把功能攒着留给大版本。自从 2.0 在 2025 年十二月发布以来，我们已经发了 45 个以上版本，差不多每周一个，其中很多都包含重要的新功能。完整列表在我们的更新日志里。

正因如此，3.0 才能纯粹专注于基础部分，而稳定版发布之后的所有新东西都在 3.x 上发布。

3.0 版本有哪些内容

3.0 破坏性变更文档里有一份详细清单，逐项说明了每个变更该怎么处理。下面说说几个主要方向，并配几个例子。

可靠性与稳定性

  • 队列模式。 手动执行现在一律在 worker 上运行，主实例不再承担这部分工作。
  • 二进制数据。 内存中的二进制数据模式已被移除。实例改用文件系统，或 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 助手和 agent 正在取代它），编辑器里的 Import from URL 没了，Code 节点里的 Ask AI 标签页也没了。

先确认你是否准备好了：迁移报告

如果别的都不看，这一段是我会读的。

版本 2.39 或更高版本上的每个实例，在 Settings > Migration Report 下都有一份迁移报告。

最新的 2.x 版本包含了最新版的报告，我们也会在收到更多反馈后持续改进体验，所以请先更新。

它的作用如下：

列出受 3.0 影响的工作流和实例级设置。

  • 自动修复许多问题。每项修复都会保存为新的工作流版本，供你审阅并发布；在你操作期间，已发布的工作流会继续在 v2 上运行。
  • 为每个工作流建议一位负责人（即最后编辑它的人），允许管理员重新指派，并通过邮件告知负责人需要修复什么。
  • 过滤掉未发布或很久没运行过的工作流，这样你就可以把这些标记为「不修」，然后继续往下走。
  • 导出一份 CSV 汇总。

管理员能看到所有工作流，其他用户只能看到自己有权限访问的工作流。和去年不同，现在不需要管理员身份也能看到。

我们推荐的路径：

  1. 升级到最新的 2.x 版本，然后打开迁移报告。
  2. 把它标记出来的所有问题都修掉，或者标成「不修」。
  3. 做一次完整备份。
  4. 先升级测试或预发布实例，再升级生产环境。

查看详细的 v3 迁移工具文档

立即试用 Beta 版

无需注册。

  • 自托管： 像安装其他任何 beta 版本一样安装它。
  • n8n Cloud： 在更改 n8n 版本时，选择 3.0.0 Beta (early access)。

动手前先记住一点：升到 3.x 是单程票。 回不到 2.x 了。先拿测试实例试一遍，并做一次完整备份。

距 2.0 已有一年

才过去一年，但这些数字值得一看。

  • GitHub 星标数： 从 2.0 版本发布时的约 160,000 增长到如今的 208,000 以上。
  • 社区论坛 成员数： 从 115,192 增长到 183,000 以上。

这些数字背后，是那些提交 issue、开发节点、在论坛里答疑、写教程，以及在出问题时告诉我们的人。谢谢你们所做的一切。

常见问题：你需要了解的内容

什么时候上线？ Beta（3.0.0）今天发布，October 27。Stable（3.x）在十二月初发布。更新动态请关注发布说明。

有哪些破坏性变更？ 全部破坏性变更，以及每一项该怎么处理，都写在 3.0 破坏性变更文档 里。

怎么判断自己是否受影响？ 打开 Settings > Migration Report 下的迁移报告（2.39 或更高版本）。

Community 版会拿到 3.0 的全部更新吗？ 会。3.0 里的所有内容都适用于自托管的 Community、Cloud 和 Enterprise/Business 版本。

2.x 会怎样？ 稳定版发布后，2.x 会获得为期 12 个月的安全修复和关键 bug 修复。新功能只在 3.x 上发布。

我还在 1.x 上，该怎么办？ 先升级到 2.x；从 1.x 到 3.x 没有直接升级路径。对 1.x 的支持将在 December 31, 2026 结束。

能回滚吗？ 不能。升级前先做完整备份；要退回去只能靠恢复这份备份。

会有停机时间吗？ 会有，和任何升级一样，需要短暂重启。

我的凭据和执行历史会保留吗？ 会。

如果我有问题怎么办？ 在社区论坛的公告帖下回复，我们会帮你解决。

感谢 Ophir 和全体 n8n 团队！