n8n 3.0.0 BETA 发布，聚焦稳定性、安全性与重大变更迁移

今天我们发布 n8n 3.0.0 BETA 版本

n8n 3.0 专注于提升可靠性、稳定性和安全性的内部改动，并为我们正在构建的后续改进打下基础。它清理了旧版功能，收紧了安全默认设置，并重新设计了 n8n 在底层的部分运行方式。

简而言之：测试版今天发布，稳定版将于 12 月初发布。由于 3.0 包含破坏性变更，升级前可能需要更新某些工作流和设置。实例中的迁移报告会明确告诉你具体是哪些内容。

即使你暂时不打算升级，现在也值得查看一下。

为什么要更改版本号？

n8n 遵循 语义化版本控制。这意味着，如果不提升主版本号，我们不会发布破坏性变更（可能需要你更改工作流或配置的更新）。

过去一年里，我们收集了一份想要实施的破坏性变更清单：要移除的旧代码路径、要提高安全性的默认设置，以及一些要停用的功能。它们都必须等到主版本发布，因此 3.0 将这些变更集中在一个版本中。

如果你想知道新功能去哪儿了，它们并没有等待。我们会持续发布功能，而不是等到主版本时再发布。自 2.0 于 2025 年 12 月发布以来，我们已经发布了 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 assistant 和 agents 正在取代它），编辑器中的“从 URL 导入”已移除，Code 节点中的 Ask AI 标签页也已移除。

检查你是否已准备就绪：Migration Report

如果只能读一部分，我会建议你读这一部分。

所有使用 2.39 或更高版本的实例，都可以在 Settings > Migration Report 中找到 Migration Report。

最新的 2.x 版本包含最新版本的报告；我们会根据收到的更多反馈持续改进使用体验，因此请先完成更新。

它的功能如下：

• 列出受 3.0 影响的工作流和实例级设置。
• 自动修复许多问题。每项修复都会另存为新的工作流版本，供你审核和发布；在你处理期间，已发布的工作流会继续在 v2 上运行。
• 为每个工作流建议一名负责人（最近编辑该工作流的人），允许管理员重新分配负责人，并通过电子邮件告知负责人需要修复的内容。
• 过滤掉未发布或长时间未运行的工作流，这样你可以将这些工作流标记为“不会修复”，然后继续处理其他内容。
• 导出 CSV 摘要。

管理员可以看到所有工作流；其他用户只能看到他们有权访问的工作流。与去年不同，你不需要是管理员也能查看报告。

我们建议采用以下路径：

1. 更新到最新的 2.x 版本并打开 Migration Report。
2. 修复报告标记的所有问题，或将其标记为“不会修复”。
3. 执行完整备份。
4. 先升级测试或预发布实例，然后再升级生产实例。

查看详细的 v3 Migration Tool Docs

立即试用 beta 版本

无需注册。

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

点击之前需要了解一件事：迁移到 3.x 是单向操作。无法返回 2.x。请先在测试实例上试用，并执行完整备份。

距 2.0 发布已经一年

虽然只有一年，但这些数字值得一看。

• GitHub stars：从 2.0 发布时的大约 160,000 增长到如今的超过 208,000。
• Community forum 成员：从 115,192 增长到超过 183,000。

这些数字背后，是那些提交问题、构建节点、在论坛中回答问题、编写教程，以及在出现故障时告诉我们的人。感谢大家所做的一切。

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

这会在什么时候发生？
Beta（3.0.0）版本于今天（10 月 27 日）发布。稳定版（3.x）将于 12 月初发布。请关注发行说明获取更新。

有哪些破坏性变更？
所有变更及其对应处理方法，都在3.0 破坏性变更文档中。

我如何知道自己是否受到影响？
在 Settings > Migration Report 下打开 Migration Report（需要使用 2.39 或更高版本）。

Community 版本是否会获得所有 3.0 更新？
是。3.0 中的所有内容都适用于自托管 Community、Cloud 和 Enterprise/Business。

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

我仍在使用 1.x，该怎么办？
请先升级到 2.x；不存在从 1.x 直接升级到 3.x 的路径。对 1.x 的支持将于 2026 年 12 月 31 日结束。

我可以回滚吗？
不可以。升级前请执行完整备份；要返回旧版本，意味着恢复该备份。

会停机吗？
会短暂重启，就像进行任何升级一样。

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

如果我有问题怎么办？
请在社区论坛中回复公告主题，我们会帮助你。

Ophir 和全体 n8n 团队感谢大家！