n8n v2 迁移指南
n8n v2 来了：Zeabur 用户完整迁移指南
Kyle Chung等待终于结束了。n8n v2.0 已经正式落地，带来了备受期待的 自动保存 (Autosave) 功能、巨大的性能提升，以及彻底改变我们构建自动化方式的“草稿与发布 (Draft vs. Publish)”工作流。
如果你在 Zeabur 上托管 n8n，这是一份完整的指南。更新你的实例通常很简单，但由于 v2 带来了一些架构变化（特别是对于 Python 用户），根据你使用 Code 节点的方式，有三条不同的路径可供选择。
以下是如何安全地迁移你的 Zeabur 项目。
🚀 只想重新开始？
如果你更喜欢从头开始而不是迁移现有实例，我们发布了一个预配置的 静态 n8n v2 模板 (Static n8n v2 Template)。它针对 Zeabur 进行了开箱即用的优化。
路径 1：“基础”用户（标准升级）
这适合谁？
- 你使用标准的 n8n 节点（Webhooks, HTTP Requests, Google Sheets 等）。
- 你在 Code 节点中使用 JavaScript。
- 你不在 Code 节点中使用 Python。
如果这听起来像你的情况，那么在 Zeabur 上的升级过程非常简单。
如何升级：
- 登录你的 Zeabur 仪表板。
- 点击你的 n8n 服务。
- 导航到 Settings (设置) 选项卡。
- 找到 Image Tag (镜像标签) 字段。
- 将标签从当前版本（或
latest）更改为2.1.4（或可用的最新版本）。 - Zeabur 将自动重新部署你的服务。
就是这样。 服务重启后，你将看到新的 v2 界面。
⚠️ 重要提示：即使是基础用户，v2 在子工作流之间的数据流转方面也有破坏性变更 (Breaking Changes)。我们强烈建议你在切换之前阅读官方的破坏性变更指南。
路径 2：“Pyodide”用户（旧版 Python 支持）
这适合谁？
- 你目前在工作流中使用 Python。
- 你正在利用 Pyodide 实现（不需要完整的外部任务运行器的轻量级浏览器/服务器端 Python）。
- 你希望保持当前的简单架构，而不部署复杂的 Task Runner。
关键点： n8n v2 改变了 Python 的处理方式。如果你只是更新镜像标签，基于 Pyodide 的节点可能会失败，因为环境要求已经改变。你需要对 Zeabur 实例应用特定的配置以维持此功能。
如何升级：
我们为这种情况准备了特定的配置指南。请根据以下指南验证你的设置和环境变量，以确保 Pyodide 继续在 Zeabur 上运行：
👉 指南：在 Zeabur 上升级带 Pyodide 支持的 n8n v2
在期望 Python 工作流成功运行之前，请务必按照上述链接中的步骤修补你当前的实例。
破坏性变更 (Breaking Changes) 摘要
无论你是基础用户还是高级用户，这些 v2 的变更都会影响每个人：
- 子工作流数据： 如果你使用 “Execute Workflow” 节点，n8n 现在返回子工作流的实际结果，而不是传递输入数据。请检查你的数据输出！
- Code 节点安全性： 默认情况下，Code 节点不再能访问环境变量 (
process.env)。如果你的代码依赖它们，你必须显式启用权限。 - 保存与发布： 你现在拥有一个“草稿 (Draft)”状态。点击“Save”不会使更改生效。你必须点击 “Publish” 才能更新你正在运行的工作流。
要深入了解每个技术变更，请参阅官方文档： 📄 n8n v2.0 破坏性变更文档
⚡️ 快速决策指南
不确定该走哪条路？使用此表来决定：
| 功能 / 用法 | 路径 1：基础 | 路径 2：Pyodide | 全新部署 |
|---|---|---|---|
| 主要代码语言 | 仅 JavaScript | JavaScript + 简单 Python | 全部 |
| 外部 Pip 包 | 无 | 无 (仅标准库) | - |
| 性能需求 | 标准 | 标准 | 标准 |
| 迁移操作 | 更新 Image Tag | 更新 Tag + 应用配置 | 使用模板 |
| 最适合 | 大多数用户 | 轻量级 Python 用户 | 全新 / 干净的开始 |
最后的想法
在 Zeabur 上升级到 v2 是向稳定性和开发者体验迈出的一大步。选择适合你工作流复杂度的路径，祝自动化愉快！ 🚀
