logo

n8n v2 遷移指南

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

Kyle ChungKyle Chung

本文亦提供 English简体中文日本語EspañolBahasa Indonesia

等待終於結束了。n8n v2.0 已經正式落地,帶來了備受期待的 自動儲存 (Autosave) 功能、巨大的效能提升,以及徹底改變我們構建自動化方式的「草稿 vs 發布 (Draft vs. Publish)」工作流程。

如果你是在 Zeabur 上託管 n8n,這是一份完整的指南。通常更新你的實例很簡單,但由於 v2 帶來了一些架構變化(特別是對於 Python 用戶),根據你使用 Code 節點的方式,有三條不同的路徑可供選擇。

以下是如何安全地遷移你的 Zeabur 專案。


🚀 只想重新開始?

如果你更喜歡從頭開始而不是遷移現有實例,我們發布了一個預先設定好的 靜態 n8n v2 範本 (Static n8n v2 Template)。它針對 Zeabur 進行了開箱即用的最佳化。

在 Zeabur 上部署 n8n v2 範本 →


路徑 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

在期望 Python 工作流程成功執行之前,請務必按照上述連結中的步驟修補你目前的實例。


重大變更 (Breaking Changes) 摘要

無論你是基礎用戶還是進階用戶,這些 v2 的變更都會影響每個人:

  1. 子工作流程資料: 如果你使用「Execute Workflow」節點,n8n 現在返回子工作流程的實際結果,而不是傳遞輸入資料。請檢查你的資料輸出!
  2. Code 節點安全性: 預設情況下,Code 節點不再能存取環境變數 (process.env)。如果你的程式碼依賴它們,你必須明確啟用權限。
  3. 儲存 vs 發布: 你現在擁有一個「草稿 (Draft)」狀態。點擊「Save」不會使更改生效。你必須點擊 「Publish」 才能更新你正在運作的工作流程。

要深入了解每個技術變更,請參閱官方文件: 📄 n8n v2.0 重大變更文件


⚡️ 快速決策指南

不確定該走哪條路?使用此表來決定:

功能 / 用法路徑 1:基礎路徑 2:Pyodide全新部署
主要程式語言僅 JavaScriptJavaScript + 簡單 Python全部
外部 Pip 套件無 (僅標準庫)-
效能需求標準標準標準
遷移操作更新 Image Tag更新 Tag + 應用 Config使用範本
最適合大多數用戶輕量級 Python 用戶全新 / 乾淨的開始

最後的想法

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