了解功能可用性
你能否使用某项 n8n 功能,取决于你的计划、平台和 n8n 版本。 你在多大程度上可以依赖它,则取决于其成熟度状态(Preview、GA、已弃用或已移除),以及对于 Enterprise 部署而言,它是 Enterprise ready 还是具有 Limited enterprise readiness(有限的企业就绪程度)。
本页说明:
- 平台和计划限制如何生效
- 每种成熟度状态的含义,以及它在功能生命周期中所处的位置
- Limited enterprise readiness 的含义,以及它与 Preview 的区别
- Preview 和 Limited enterprise readiness 与你协议中的 Beta Features 有何关系
- n8n 版本控制如何运作
在 n8n 文档中,上述每一项都有自己的标签或提示,例如 Feature availability 提示、Preview status 提示或 Limited enterprise readiness 提示,因此无论哪个页面说明了相同信息,你都能认出来。
按平台划分的功能可用性
n8n 提供两种主要部署方式:
- n8n Cloud:在由 n8n 运行的实例上使用的托管方案。
- Self-hosted:在你自己的机器或基础设施上,或在你选择的云平台上运行 n8n。
大多数功能在两个平台上都可用,只有少数功能仅存在于其中一个平台。例如,AI Transform 节点仅在 n8n Cloud 上可用,而 LangSmith tracing 仅在自托管环境中可用。
文档中的平台限制
文档默认功能在两个平台上都可用。如果并非如此,该功能的页面会带有特定于平台的 Feature availability 提示,例如:
提示
功能可用性
AI Transform 可用于:
- n8n Cloud: 所有计划
它在自托管 n8n 上不可用。
产品中的平台限制
在你的平台上不可用的功能通常根本不会出现在 n8n 界面中,而不是以锁定状态显示。
按计划划分的功能可用性
计划或版本是你的商业层级:
- n8n Cloud:Starter、Pro 或 Enterprise。
- 自托管:Community、Registered Community、Business 或 Enterprise。
例如,日志流仅在 Enterprise 上可用。你可以拥有的共享项目数量因计划而异。
文档中的计划限制
文档默认功能在所有计划和版本中都可用。如果并非如此,该功能的页面会带有特定于计划的 Feature availability 提示,列出每个平台上所需的计划或版本。如果某个平台的所有计划或版本都包含该功能,提示中也会说明。
提示
功能可用性
凭据共享可用于:
- n8n Cloud: 所有计划
- Self-hosted: Business、Enterprise
有关每个自托管版本所含内容的完整说明,请参阅比较计划和版本。由于计划内容可能会变化,各计划的当前功能列表以定价页面为准。
产品中的计划限制
需要更高计划或版本的功能仍会显示在 n8n 界面中,但处于锁定状态,并附有访问该功能所需计划的说明。

功能成熟度:Preview、GA、已弃用和已移除
每项 n8n 功能都有一个成熟度状态:
- Preview:n8n 可能仍会对该功能进行破坏性更改,例如更改 API 结构、导出格式、节点参数或执行结果,甚至完全移除它。避免在生产工作流中依赖 Preview 功能。Preview 并不表示存在 bug、缺少选项、界面未完成或功能较新:GA 功能同样可能存在这些情况。
- 正式发布(GA):这不是 n8n 会显示的标签,而是在没有其他标签时的默认状态。GA 功能稳定且可用于生产,n8n 只会通过弃用流程对其进行破坏性更改。
- 已弃用:该功能仍可使用,但 n8n 计划移除它,并建议你迁移到其他方案。
- 已移除:该功能在当前版本中已不存在。移除总是在主版本中进行。
对于节点,请查看已弃用和版本化节点,获取当前自动更新的列表。
文档中的成熟度状态
文档以不同方式标记每种状态:
- Preview:当整个页面介绍 Preview 功能时,页面标题处会显示 Preview 标签。页面或章节还会带有 Preview status 提示,例如:
提示
**预览状态**
OpenTelemetry tracing 从 n8n 2.19.0 起处于 Preview 阶段,未来版本中可能会发生变化。请勿在生产工作流中依赖它。
- GA:没有标记,因为它是默认状态。
- 已弃用:当整个页面介绍已弃用的功能时,页面标题和导航菜单中会显示 Deprecated 标签。页面、设置或节点上的说明会写明它从哪个版本开始弃用,以及替代方案(如果有)。
- 已移除:对应版本的破坏性变更页面(例如 n8n 3.0 破坏性变更)会记录移除情况以及替代做法。该功能自己的页面可能已不再存在。
产品中的成熟度状态
Preview 和 Deprecated 会在 n8n 界面中以标签形式显示。Preview 标签出现在你接触该功能的位置,例如其页面标题、节点或面板,以及设置中它的开关旁边。它们不会出现在主导航(例如侧边栏)中。Deprecated 标签出现在节点面板中的节点旁边以及其设置中。没有标签的功能或节点即为 GA。
已移除的功能不会出现在界面中。如果某个工作流依赖它,请查看你所更新到的版本的破坏性变更页面。
Enterprise 就绪
与成熟度无关,功能还可能具有 Limited enterprise readiness。此状态面向 Enterprise 计划的管理员,告诉他们某些 Enterprise 能力尚未覆盖该功能。完整列表请参阅 Enterprise 能力。
共有两种状态:
- Enterprise ready:适用于该功能的所有 Enterprise 要求均已满足。
- Limited enterprise readiness:至少有一项适用的 Enterprise 要求尚未满足。
Preview 与 Limited enterprise readiness 的区别
这两种状态彼此独立。功能可以是 GA 但具有 Limited enterprise readiness,也可以处于 Preview 但完全 Enterprise ready,不过后一种组合很少见。
| Preview | Limited enterprise readiness | |
|---|---|---|
| 回答的问题 | n8n 是否可能对该功能进行破坏性更改或将其移除? | 适用于该功能的所有 Enterprise 能力是否都能与它配合使用? |
| 谁能看到 | 所有人 | Enterprise 管理员 |
| 差距意味着什么 | n8n 不承诺稳定性或兼容性。 | 该功能目前还无法与你的部分 Enterprise 设置配合使用。 |
| 出现在哪里 | 功能本身的界面、其设置项、文档和 API 参考 | 管理员开关旁边以及文档中 |
| 何时移除 | 当 n8n 不再计划进行破坏性更改或移除时 | 当所有适用的 Enterprise 要求都满足时 |
Enterprise 就绪方面的差距并不会让功能变成 Preview。例如,不支持队列模式和多主模式的功能并不处于 Preview,未运行这些模式的用户也不受影响。
Enterprise 能力
以下是完整的 Enterprise 能力列表。n8n 会根据适用于每项功能的能力对其进行评估:
- SSO
- RBAC and project scoping
- Data residency
- Queue mode and multi-main
- Environments and source control
- Audit events and log streaming
- OpenTelemetry tracing
- External secrets
- Public API
- Enterprise-scale volumes
- Policy coverage for new nodes, credentials, and resources
文档中的 Enterprise 就绪
对于 Enterprise ready 的功能,文档不会显示任何内容,因此没有标签的功能即为 Enterprise ready。
如果功能具有 Limited enterprise readiness,其页面会带有 Limited enterprise readiness 提示。该提示会写出功能名称,并列出它支持的 Enterprise 能力及其当前就绪程度:Full 或 Partial。然后说明其他 Enterprise 能力要么不适用于该功能,要么它尚不支持,并链接到完整列表。
提示
有限的企业就绪程度
示例功能具有 Limited enterprise readiness。它支持以下 Enterprise 能力:
- SSO: Full
- External secrets: Partial
其他 Enterprise 能力要么不适用于示例功能,要么它尚不支持。有关完整的 Enterprise 能力列表,请参阅了解功能可用性。
完全不在 Enterprise 上提供的功能不会带有此标签,那属于计划或平台限制,请参阅按计划划分的功能可用性。
产品中的 Enterprise 就绪
同样,n8n 界面也不会为 Enterprise ready 的功能显示任何内容。具有 Limited enterprise readiness 的功能会在 n8n 界面中其开关出现的位置带有 Limited enterprise readiness 标签。在 Enterprise 计划中,处于 Preview 或具有 Limited enterprise readiness 的功能应默认关闭。管理员可以在设置页面中开启它,在自托管实例上也可以通过环境变量开启。Preview 和 Limited enterprise readiness 标签显示在开关旁边,方便你在启用功能前做出知情选择。
Preview 和 Limited enterprise readiness 与协议中的 Beta Features 的关系
你与 n8n 之间的协议提到了「Beta Features」。标记为 Preview 或 Limited enterprise readiness 的功能属于 Beta Feature。n8n 按原样提供该功能,在 n8n 移除该标签之前,使用风险由你自行承担。在此之前,n8n 可以随时更改或停止提供该功能。标签移除后,n8n 也可能开始对其收费。
「Beta Features」与 n8n Cloud 上的 Beta 发布轨道无关,后者只控制你的工作区何时接收新版本。请参阅按 n8n 版本划分的功能可用性。
按 n8n 版本划分的功能可用性
n8n 有两种版本号:
- 实例版本:n8n 发行版本身的版本,采用三段式语义版本控制,例如 n8n 2.30.0。MAJOR 在进行可能需要用户操作的不兼容更改时递增,MINOR 在添加向后兼容的新功能时递增,PATCH 在进行向后兼容的修复时递增。环境变量、API、CLI 命令和钩子都与此版本绑定。
- 节点版本:单个节点自己的版本号,通常为两段式,例如节点版本 4.7。节点可以独立于其所在的 n8n 发行版获得新版本。
n8n Cloud 工作区选择的是发布轨道和更新节奏,而不是一个需要你手动升级的固定版本。这两项设置是:
- 发布轨道:Beta 会在新版本就绪后立即交付。Stable 运行较晚、经过更多验证、已在 Beta 上运行过一段时间的补丁版本。对于关键业务负载,n8n 建议使用 Stable。
- 更新节奏:Security & stability 大约每两周升级一次。Every new release 在每次发布时升级,平均约每天一次。无论选择哪种,安全和稳定性修复都会自动应用。
你可以随时在工作区设置的 Updates & maintenance 中切换轨道或节奏,请参阅更新您的版本。自托管实例则按你自己的计划更新,请参阅更新 n8n。
文档中的版本可用性
各个文档页面并不会系统地记录功能是从哪个版本引入的。对于许多较新的功能,页面会带有基于版本的 Feature availability 提示,例如:
提示
功能可用性
Canvas Groups 从 n8n 2.28.0 起可用。
较旧的功能和较小的更改通常没有此类提示,因此没有提示并不意味着该功能在所有版本中都存在。
要了解某个版本中可用的内容,请根据所需的详细程度选择以下来源之一:
- Changelog:在 n8n 推出功能时,对最重要功能的精选叙述性摘要。
- 发行说明:每一项功能级更新,每个功能一行,最新的在前,也提供 RSS 订阅源。
- GitHub releases:链接到提交记录的完整变更详情,包括另外两者略过的 bug 修复和细小更改。
产品中的版本可用性
你的实例版本显示在 Settings 侧边栏底部。在 n8n Cloud 上,Updates & maintenance 也会显示你的工作区运行的版本。

在比你的版本更晚的版本中添加的功能,在你更新之前不会出现在你的 n8n 界面中。
在 changelog 或发行说明中发布并不保证该功能已经到达你的实例。有些功能带有需要你启用的功能标志,另一些则会先逐步推广到 n8n Cloud 或自托管实例,然后才覆盖所有人。
影响功能可用性的其他因素
- 角色或权限:即使你的计划、平台和版本都包含某项功能,也由实例 owner 或 admin 决定你的角色能否看到或使用它。
这是由你自己的管理员设置的限制,而不是 n8n。有关角色和权限的工作方式,请参阅了解实例角色和设置权限和角色 (RBAC)。