# n8n v2 迁移指南

> n8n v2 来了：Zeabur 用户完整迁移指南

等待终于结束了。**n8n v2.0** 已经正式落地，带来了备受期待的 **自动保存 (Autosave)** 功能、巨大的性能提升，以及彻底改变我们构建自动化方式的“草稿与发布 (Draft vs. Publish)”工作流。

如果你在 **Zeabur** 上托管 n8n，这是一份完整的指南。更新你的实例通常很简单，但由于 v2 带来了一些架构变化（特别是对于 Python 用户），根据你使用 Code 节点的方式，有三条不同的路径可供选择。

以下是如何安全地迁移你的 Zeabur 项目。

---

### 🚀 只想重新开始？

如果你更喜欢从头开始而不是迁移现有实例，我们发布了一个预配置的 **静态 n8n v2 模板 (Static n8n v2 Template)**。它针对 Zeabur 进行了开箱即用的优化。

[**在 Zeabur 上部署 n8n v2 模板 →**](https://zeabur.com/templates/JP88UN)

---

## 路径 1：“基础”用户（标准升级）

**这适合谁？**

- 你使用标准的 n8n 节点（Webhooks, HTTP Requests, Google Sheets 等）。
- 你在 Code 节点中使用 JavaScript。
- 你**不**在 Code 节点中使用 Python。

如果这听起来像你的情况，那么在 Zeabur 上的升级过程非常简单。

### 如何升级：

1. 登录你的 **Zeabur 仪表板**。
2. 点击你的 **n8n 服务**。
3. 导航到 **Settings** (设置) 选项卡。
4. 找到 **Image Tag** (镜像标签) 字段。
5. 将标签从当前版本（或 `latest`）更改为 **`2.1.4`**（或可用的最新版本）。
6. Zeabur 将自动重新部署你的服务。

**就是这样。** 服务重启后，你将看到新的 v2 界面。

> ⚠️ 重要提示：即使是基础用户，v2 在子工作流之间的数据流转方面也有破坏性变更 (Breaking Changes)。我们强烈建议你在切换之前阅读官方的破坏性变更指南。
>

---

## 路径 2：“Pyodide”用户（旧版 Python 支持）

**这适合谁？**

- 你目前在工作流中使用 Python。
- 你正在利用 **Pyodide** 实现（不需要完整的外部任务运行器的轻量级浏览器/服务器端 Python）。
- 你希望保持当前的简单架构，而不部署复杂的 Task Runner。

**关键点：**
n8n v2 改变了 Python 的处理方式。如果你只是更新镜像标签，基于 Pyodide 的节点可能会失败，因为环境要求已经改变。你需要对 Zeabur 实例应用特定的配置以维持此功能。

### 如何升级：

我们为这种情况准备了特定的配置指南。请根据以下指南验证你的设置和环境变量，以确保 Pyodide 继续在 Zeabur 上运行：

**👉 [指南：在 Zeabur 上升级带 Pyodide 支持的 n8n v2](https://gist.github.com/c-c-epr/53770cb3286ddc7ea6ae4c4cfcc572ce)**

*在期望 Python 工作流成功运行之前，请务必按照上述链接中的步骤修补你当前的实例。*

---

## 破坏性变更 (Breaking Changes) 摘要

无论你是基础用户还是高级用户，这些 v2 的变更都会影响每个人：

1. **子工作流数据：** 如果你使用 “Execute Workflow” 节点，n8n 现在返回子工作流的*实际结果*，而不是传递输入数据。请检查你的数据输出！
2. **Code 节点安全性：** 默认情况下，Code 节点不再能访问环境变量 (`process.env`)。如果你的代码依赖它们，你必须显式启用权限。
3. **保存与发布：** 你现在拥有一个“草稿 (Draft)”状态。点击“Save”不会使更改生效。你必须点击 **“Publish”** 才能更新你正在运行的工作流。

要深入了解每个技术变更，请参阅官方文档：
[**📄 n8n v2.0 破坏性变更文档**](https://docs.n8n.io/2-0-breaking-changes/)

---

## ⚡️ 快速决策指南

不确定该走哪条路？使用此表来决定：

| 功能 / 用法 | **路径 1：基础** | **路径 2：Pyodide** | **全新部署** |
| --- | --- | --- | --- |
| **主要代码语言** | 仅 JavaScript | JavaScript + 简单 Python | 全部 |
| **外部 Pip 包** | 无 | 无 (仅标准库) | - |
| **性能需求** | 标准 | 标准 | 标准 |
| **迁移操作** | 更新 Image Tag | 更新 Tag + [应用配置](https://gist.github.com/c-c-epr/53770cb3286ddc7ea6ae4c4cfcc572ce) | [**使用模板**](https://zeabur.com/templates/JP88UN) |
| **最适合** | 大多数用户 | 轻量级 Python 用户 | **全新 / 干净的开始** |

### 最后的想法

在 Zeabur 上升级到 v2 是向稳定性和开发者体验迈出的一大步。选择适合你工作流复杂度的路径，祝自动化愉快！ 🚀