从 Environments (Classic) 升级
环境改进并取代了早期的源代码控制功能 Environments (Classic)。每个实例要么使用 Classic,要么使用环境;在环境功能处于 Preview 阶段期间,你可以切换回 Classic。
提示
Preview status 预览状态
环境功能处于 Preview 阶段,未来版本中可能会发生变化。在为生产实例设置之前,请先在测试实例上试用。
比较 Classic 与环境
| Environments (Classic) | 环境 | |
|---|---|---|
| 模型 | 实例向一个分支推送并从同一个分支拉取。 | 实例推广到一个环境,并从另一个环境应用。每个环境都可以使用自己的仓库和分支。 |
| Git 托管平台 | 任何支持 SSH 或 HTTPS 的 Git 托管平台。 | 与 Classic 一样,可通过通用 Git 使用任何 Git 托管平台。GitLab 额外提供仓库和分支列表。 |
| 审查 | 在 Git 托管平台上手动审查。 | 在 n8n 中进行推广审查并提供可视化差异,基于 n8n 在 GitLab 上创建的合并请求。 |
| 选择更改 | 你选择要推送的内容。拉取会引入所有内容。 | 你可以通过项目级推广或项目级应用在两个方向上选择更改,也可以通过实例级推广或实例级应用移动所有团队项目。 |
| 依赖项 | 你选择工作流、凭据和数据表。n8n 会添加标签和变量存根。 | n8n 会包含所选工作流使用的所有内容。已计划支持自行选择依赖项。 |
| 更改生效之前 | 确认后,拉取可能会覆盖本地更改。 | 应用会先检查阻止项,并要求你确认破坏性更改。 |
| 凭据 | 不含值的存根。 | 必须已存在于目标实例上,或者在应用时创建。 |
| 变量 | 不含值的存根。 | 连同其值一起写入仓库。必须已存在于目标实例上,或者在应用时创建。 |
| 可以使用的人 | 实例所有者和管理员。项目管理员可以推送。 | 实例所有者和管理员。已计划支持项目管理员执行项目级推广和项目级应用。 |
| 个人项目 | 包含。 | 不包含。 |
| 自动化 | 公共 API 中的源代码控制端点,以及 n8n CLI 中的 pull 命令。 | 公共 API 中的推广端点,以及 n8n CLI 中的推广命令。 |
环境尚不支持的 Classic 功能
环境目前还没有覆盖 Environments (Classic) 的所有功能。升级之前请检查以下各项:
- 个人项目: Classic 包含个人项目。环境只推广团队项目。
- 项目管理员: 在 Classic 中,项目管理员可以推送。在环境中,只有实例所有者和实例管理员可以推广和应用。已计划支持项目管理员执行项目级推广和项目级应用。
- 自动发布: Classic 可以在拉取时发布工作流。应用不会改变工作流的发布状态。已计划支持自动发布。
- 实例颜色: Classic 允许你为实例设置颜色。环境没有此设置。
- 选择依赖项: Classic 允许你单独推送凭据和数据表。环境会包含所选工作流的所有依赖项,且你无法自行选择依赖项。已计划支持选择依赖项。
- 跨项目移动: Classic 拉取会将工作流移动到它们在 Git 中所属的项目。项目级推广或项目级应用无法在项目之间移动工作流或文件夹,因此请使用实例级推广和实例级应用。请参阅在项目之间移动工作流和文件夹。
- 工作流描述: Classic 会同步工作流描述,环境不会。
- 凭据设置: Classic 会同步凭据是否共享给所有用户和项目,以及是否由每个用户连接自己的账户。环境不会同步这些设置,因此请在目标实例上重新设置这些选项。
提示
环境还有一些与 Classic 无关的限制。请参阅已知限制。
从 Environments (Classic) 迁移
Classic 和环境在 Git 中存储内容的格式不同,因此应用无法读取 Classic 推送的内容。从技术上讲,环境可以与 Classic 内容共用一个仓库,但 n8n 建议使用新仓库或空分支。
请先在测试实例上尝试。你的 Classic 设置会在后台保持连接,因此你可以切换回去。
开始之前:
- 将调用公共 API 中 Classic 端点的所有 CI 流水线切换到推广端点。升级只会改变 UI,因此这些端点仍会继续执行 Classic 的推送和拉取。n8n 计划在使用环境的实例上阻止这些端点。
- 在每个实例(例如开发和生产实例)上,前往 Settings 设置 > Environments (Classic),选择 Upgrade 升级 并确认。
- 为 Production 环境创建一个新仓库或空分支。
- 按照开发和生产中的说明添加环境配置。分支为空时,不要在生产实例上执行应用。
然后通过以下两种方式之一填充分支。
从开发实例开始
如果开发实例上没有尚未准备好进入生产环境的更改,请从第 3 步开始按照第一次推广操作。
从生产实例开始
如果开发实例上有尚未准备好进入生产环境的更改,请改为从生产实例填充分支。这样分支就与生产实例保持一致,等开发实例上的更改准备好后再推广。

- 在生产实例上,添加一个指向同一仓库和分支的 Production 推广环境配置,并运行实例级推广。然后从生产实例中移除该推广环境配置。
- 此后,当开发实例上的更改准备好时,使用项目级推广推广它们。实例级推广还会发送尚未准备好的更改。
- 在生产实例上应用这些更改。
在这两种情况下,Classic 拉取都保留了源实例的 ID,因此应用会就地更新生产实例上的内容。工作流会保留其版本历史和执行记录,变量会保留其值,凭据会保留其密钥。完成后,请保护生产实例。
切换回 Environments (Classic)
- 前往 Settings 设置 > Environments 环境。
- 选择 Switch back 切换回去,然后确认。
切换回去只影响此实例。你可以随时再次升级。
相关资源
不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。