# n8n v2 遷移指南

> n8n v2 來了：Zeabur 用戶完整遷移指南

等待終於結束了。**n8n v2.0** 已經正式落地，帶來了備受期待的 **自動儲存 (Autosave)** 功能、巨大的效能提升，以及徹底改變我們構建自動化方式的「草稿 vs 發布 (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 的處理方式。如果你只是更新 Image Tag，基於 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. **儲存 vs 發布：** 你現在擁有一個「草稿 (Draft)」狀態。點擊「Save」不會使更改生效。你必須點擊 **「Publish」** 才能更新你正在運作的工作流程。

要深入了解每個技術變更，請參閱官方文件：
[**📄 n8n v2.0 重大變更文件**](https://docs.n8n.io/2-0-breaking-changes/)

---

## ⚡️ 快速決策指南

不確定該走哪條路？使用此表來決定：

| 功能 / 用法 | **路徑 1：基礎** | **路徑 2：Pyodide** | **全新部署** |
| --- | --- | --- | --- |
| **主要程式語言** | 僅 JavaScript | JavaScript + 簡單 Python | 全部 |
| **外部 Pip 套件** | 無 | 無 (僅標準庫) | - |
| **效能需求** | 標準 | 標準 | 標準 |
| **遷移操作** | 更新 Image Tag | 更新 Tag + [應用 Config](https://gist.github.com/c-c-epr/53770cb3286ddc7ea6ae4c4cfcc572ce) | [**使用範本**](https://zeabur.com/templates/JP88UN) |
| **最適合** | 大多數用戶 | 輕量級 Python 用戶 | **全新 / 乾淨的開始** |

### 最後的想法

在 Zeabur 上升級到 v2 是向穩定性和開發者體驗邁出的一大步。選擇適合你工作流程複雜度的路徑，祝自動化愉快！ 🚀