内容来源：https://blog.n8n.io/introducing-n8n-v3/

内容总结：

n8n 正式发布 3.0.0 BETA 版本，稳定版计划于12月初推出。3.0 聚焦内部架构调整，重点提升可靠性、稳定性与安全性，并为后续改进奠定基础。本次更新清理了遗留功能、收紧了安全默认配置，并重构了部分底层运行机制。

由于3.0包含破坏性变更，部分工作流和设置可能需要在升级前调整。用户可在实例中的“迁移报告”（Migration Report）中查看具体受影响项。官方建议即使暂不升级也提前查看。

版本号变更原因

n8n 遵循语义化版本规范，破坏性变更须提升主版本号。过去一年收集的待办破坏性变更——包括移除遗留代码路径、收紧默认安全配置、退役部分功能——统一在3.0中发布。新功能并未积压等待大版本，自2025年12月2.0发布以来已累计发布超过45个版本，约每周一次，因此3.0得以专注于基础架构，稳定版发布后的新功能将在3.x系列中持续交付。

3.0主要更新内容

可靠性与稳定性方面：队列模式下手动执行一律在 worker 上运行；移除内存二进制数据模式，统一使用文件系统或 S3 等外部存储；Code 节点默认超时由5分钟缩短至1分钟（可配置），并降低解压缩限制以防范“压缩炸弹”；旧版 Cron 和 Interval 节点由 Schedule Trigger 替代，运行于更持久的调度器。

安全方面：默认开启加密密钥轮换；Slack 凭证强制要求签名密钥；扩大默认 SSRF 拦截列表；未经验证的社区包默认关闭。

自托管方面：自托管版改为基于 Docker 运行，不再支持 npm 或 npx 安装，部分新安全特性依赖容器环境；官方提供一行安装脚本实现同等快速部署；Kubernetes 和 Helm 部署不受影响。

清理方面：移除 Function、Function Item、Item Lists、Cron、Interval、旧版 OpenAI 节点、旧版 AI Agent 模式、旧版 Edit Image 节点及已停止服务的相关节点等，多数提供直接替代方案并支持自动迁移。Chat Hub 默认关闭（3.x 期间可重新开启），编辑器移除“从 URL 导入”，“Ask AI”标签页从 Code 节点移除。

迁移报告助力升级准备

版本2.39及以上的实例可在“设置 > 迁移报告”中查看受影响的工作流和实例级设置。报告支持自动修复多项问题（修复结果保存为新工作流版本供审核发布，已发布工作流在 v2 上继续运行）、建议工作流负责人并邮件通知、过滤长期未运行的工作流、导出 CSV 摘要。管理员可见全部工作流，普通用户可见其有权访问的工作流。

官方推荐升级路径：先更新至最新2.x并打开迁移报告，处理或标记所有提示项，完成完整备份，先在测试或预发布实例升级，再升级生产环境。

Beta 体验与注意事项

自托管用户可照常安装 Beta 版本；n8n Cloud 用户切换版本时选择“3.0.0 Beta (early access)”。需注意升级至3.x为单向操作，无法回退至2.x，建议先在测试实例试用并做好完整备份。

2.0发布一年回顾

GitHub 星标从2.0发布时约16万增至目前超过20.8万，社区论坛成员从115,192人增至超过18.3万人。官方对提交问题、开发节点、解答疑问、撰写教程及反馈故障的社区成员表示感谢。

常见问题

Beta 版于10月27日发布，稳定版12月初推出；破坏性变更详见3.0破坏性变更文档；受影响范围可查看迁移报告；社区版享有3.0全部更新；稳定版发布后2.x将继续获得12个月的安全与关键缺陷修复，新功能仅在3.x交付；仍在使用1.x的用户须先升级至2.x，1.x支持将于2026年12月31日结束；不支持回滚，升级前须完整备份；升级过程仅有短暂重启；凭证与执行历史均会保留。如有疑问可在社区论坛公告帖中回复获取帮助。

中文翻译：

今天，我们发布 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 和其他外部存储，在高负载下更具可预测性。
• 防止失控任务的护栏。代码节点的默认超时时间（任务运行器）从 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 助手和智能体正在取代它），编辑器中的“从 URL 导入”功能已移除，代码节点中的“询问 AI”标签页也已移除。

检查你是否准备好了：迁移报告

如果你只看一部分，那就看这部分。

每个运行 2.39 或更高版本的实例都可以在“设置 > 迁移报告”下找到迁移报告。

最新的 2.x 版本包含最新版本的报告，我们将根据收到的反馈继续改进体验，所以请先更新。

以下是它的功能：

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

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

我们推荐的路径：

• 更新到最新的 2.x 并打开迁移报告。
• 修复或标记“不予修复”所有被标记的项目。
• 进行完整备份。
• 先在测试或预发布实例上升级，然后再升级生产环境。

今天就试用测试版

无需注册。

• 自托管：像安装其他任何测试版一样安装它。
• n8n Cloud：在更改 n8n 版本时选择 3.0.0 Beta（早期访问）。

点击之前需要知道的一件事：迁移到 3.x 是单向的。无法回到 2.x。请先在测试实例上试用，并做好完整备份。

2.0 发布一年以来

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

• GitHub 星标：从 2.0 发布时的约 160,000 增至如今的超过 208,000。
• 社区论坛成员：从 115,192 增至超过 183,000。

这些数字背后是那些提交问题、构建节点、在论坛回答问题、撰写教程、并在出问题时告诉我们的人。感谢你们所做的一切。

常见问题：你需要知道的事项

什么时候发生？

测试版（3.0.0）今天，10月27日。稳定版（3.x）12月初。关注发布说明获取更新。

有哪些破坏性变更？

所有内容及每项需要做什么，都在 3.0 破坏性变更文档中。

我怎么知道是否受影响？

打开“设置 > 迁移报告”（版本 2.39 或更高）。

社区版会获得所有 3.0 更新吗？

会。3.0 中的所有内容适用于自托管社区版、Cloud 版和企业/商业版。

2.x 会怎样？

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

我还在 1.x 上。该怎么办？

先升级到 2.x；没有从 1.x 直接到 3.x 的路径。1.x 的支持将于 2026 年 12 月 31 日结束。

我可以回滚吗？

不可以。升级前请进行完整备份；回退意味着恢复备份。

会有停机时间吗？

会有短暂重启，与任何升级一样。

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

会。

如果我有问题怎么办？

在社区论坛的公告帖中回复，我们会帮助你。

来自 Ophir 和全体 n8n 团队的感谢！

英文来源：

Today we're releasing n8n version 3.0.0 BETA
n8n 3.0 focuses on internal changes that improve reliability, stability and security, and lays the groundwork for the improvements we're building next. It clears out legacy features, tightens security defaults and reworks parts of how n8n runs under the hood.
The short version: the beta is available today and the stable release follows in early December. Because 3.0 includes breaking changes, some workflows and settings may need updates before you upgrade. The Migration Report in your instance tells you exactly which ones.
It’s worth taking a look now, even if you’re not planning to upgrade right away.
Why change the version number?
n8n follows semantic versioning. That means we don't ship breaking changes (updates that might require you to change your workflows or configuration) without bumping the major version number.
Over the past year we collected a list of breaking changes we wanted to make: legacy code paths to remove, defaults to make safer, a few features to retire. Each of them had to wait for a major version, so 3.0 brings them together in one release.
If you're wondering where the new features went, they didn't wait. We ship features continuously instead of saving them for a major version. Since 2.0 came out in December 2025, we've shipped over 45 releases, roughly one a week, and many of them included major new features. The full list is on our changelog.
That's why 3.0 can focus purely on the foundation, and everything new after the stable release ships on 3.x.
What's in version 3.0
The 3.0 breaking changes docs have a detailed list with what to do for each change. Here are the main themes, with a few examples.
Reliability and stability

• Queue mode. Manual executions now always run on workers, so the main instance isn't doing that work.
• Binary data. The in-memory binary data mode is removed. Instances use the filesystem, or S3 and other external storage, which is more predictable under load.
• Guardrails against runaway work. The default Code node timeout (task runner) drops from 5 minutes to 1 minute, and it's configurable. Decompression limits are lower, to protect instances from oversized archives ("zip bombs").
• Scheduling. The old Cron and Interval nodes are replaced by the Schedule Trigger, which runs on n8n's more durable scheduler.
  Security
  We made several defaults safer:
• Encryption key rotation is always on.
• Slack credentials require a signing secret, so nobody can send forged requests pretending to be Slack.
• A larger default SSRF (server-side request forgery) block list when SSRF protection is enabled.
• Unverified community packages are off by default.
  Self-hosting
  Self-hosted n8n now runs on Docker. Installing with npm or npx n8n
  is no longer supported, partly because new security features depend on a container setup. If you liked npx n8n
  for how quick it was, there's a one-line setup script that gets you to the same place. Kubernetes and Helm deployments aren't affected.
  Cleanup
  We removed legacy nodes: Function, Function Item, Item Lists, Cron, Interval, the legacy OpenAI node, older AI Agent modes, older versions of the Edit Image node, nodes for services that no longer exist, and others. Most have a direct replacement (Function becomes the Code node; Item Lists becomes Split Out, Aggregate, Sort, Limit, Remove Duplicates or Summarize), and many migrate automatically.
  A few features are retired too. Chat Hub is off by default (you can turn it back on for 3.x; the n8n AI assistant and agents are replacing it), Import from URL is gone from the editor, and the Ask AI tab is gone from the Code node.
  Check if you're ready: the Migration Report
  This is the part I'd read if I read nothing else.
  Every instance on version 2.39 or later has a Migration Report under Settings > Migration Report.
  The latest 2.x version has the newest version of the report and we'll continue to improve the experience as we get more feedback, so update first.
  Here's what it does:
• Lists the workflows and instance-level settings affected by 3.0.
• Fixes many issues automatically. Each fix is saved as a new workflow version for you to review and publish, and your published workflows keep running on v2 while you work.
• Suggests an owner for each workflow (whoever edited it last), lets admins reassign, and emails owners what to fix.
• Filters out workflows that aren't published or haven't run in a long time, so you can mark those "won't fix" and move on.
• Exports a CSV summary.
  Admins see every workflow; other users see the workflows they have access to. Unlike last year, you don't need to be an admin to see it.
  The path we recommend:
• Update to the latest 2.x and open the Migration Report.
• Fix, or mark "won't fix", everything it flags.
• Take a full backup.
• Upgrade a test or staging instance first, then production.
  Try the beta today
  No sign-up needed.
• Self-hosted: install it like any other beta release.
• n8n Cloud: pick
  3.0.0 Beta (early access)
  when changing your n8n version.
  One thing to know before you click: moving to 3.x is one way. There's no going back to 2.x. Try it on a test instance first, and take a full backup.
  A year since 2.0
  It's only been a year, but the numbers are worth a look.
• GitHub stars: from about 160,000 at the 2.0 release to over 208,000 today.
• Community forum members: from 115,192 to over 183,000.
  Behind those numbers are the people who file issues, build nodes, answer questions in the forum, write tutorials, and tell us when something broke. Thank you for all of it.
  FAQ: What you need to know
  When is this happening?
  Beta (3.0.0) today, October 27. Stable (3.x) in early December. Follow the release notes for updates.
  What are the breaking changes?
  Here are all of them, with what to do for each, are in the 3.0 breaking changes docs.
  How do I know if I'm affected?
  Open the Migration Report under Settings > Migration Report (version 2.39 or later).
  Does the Community edition get all 3.0 updates?
  Yes. Everything in 3.0 applies to self-hosted Community, Cloud, and Enterprise/Business.
  What happens to 2.x?
  After the stable release, 2.x gets security and critical bug fixes for 12 months. New features ship on 3.x only.
  I'm still on 1.x. What do I do?
  Upgrade to 2.x first; there's no direct path from 1.x to 3.x. Support for 1.x ends December 31, 2026.
  Can I roll back?
  No. Take a full backup before upgrading; going back means restoring it.
  Is there downtime?
  A short restart, like any upgrade.
  Do my credentials and execution history carry over?
  Yes.
  What if I have questions?
  Reply to the announcement thread in the community forum and we'll help you out.
  Thanks from Ophir and all of the n8n team!