n8n 到 JieGou 遷移指南 — 逐步技術演練

本指南將引導你完成從 n8n 工作流程遷移到 JieGou 的每個步驟。無論你有 5 個還是 500 個工作流程，流程都相同 — 而且大部分都是自動化的。

預估時間： 典型的 20-50 個工作流程部署需要 1-2 小時。

先決條件

開始之前：

n8n 存取權限 — 你需要管理員存取權限來匯出工作流程（自架或雲端）
JieGou 帳戶 — 免費註冊或部署 Docker Compose 入門套件用於氣隙環境
整合憑證 — 你的 n8n 工作流程連接的任何服務的 API 金鑰或 OAuth token（Slack、Gmail、GitHub 等）

步驟 1：匯出你的 n8n 工作流程

選項 A：匯出所有工作流程（推薦）

開啟你的 n8n 實例
前往設定 → 匯出所有工作流程
下載 JSON 檔案 — 它包含你實例中的每個工作流程

匯出的檔案看起來像這樣：

[
  {
    "name": "Lead Enrichment Pipeline",
    "nodes": [
      { "name": "Webhook", "type": "n8n-nodes-base.webhook", ... },
      { "name": "HTTP Request", "type": "n8n-nodes-base.httpRequest", ... },
      { "name": "Set", "type": "n8n-nodes-base.set", ... }
    ],
    "connections": { ... }
  },
  ...
]

選項 B：匯出個別工作流程

開啟你想遷移的工作流程
點擊 ⋮ 選單 → 下載
儲存 JSON 檔案

你可以一次匯入一個工作流程或批次匯入。

匯出內容

包含	不包含
工作流程名稱和結構	憑證值（API 金鑰、token）
節點類型和設定	執行歷史
節點間的連接	環境變數
標籤和註解	自訂節點套件
靜態參數

重要： n8n 基於安全考量從不匯出憑證值。你將在 JieGou 中以 MCP 伺服器連接的方式設定新憑證。

步驟 2：註冊 JieGou

雲端（最快）

前往 console.jiegou.ai
使用 Google、GitHub 或電子郵件註冊
選擇你的部門（匯入工具在任何部門都可使用）
你會到達儀表板 — 導航至整合 → 遷移

自架（Docker Compose）

適用於需要資料留在本地的受監管環境：

# 複製入門套件
git clone https://github.com/JieGouAI/self-hosted.git
cd self-hosted

# 設定
cp .env.example .env
# 編輯 .env 填入你的 Firebase 憑證和 LLM API 金鑰

# 啟動
docker compose up -d

控制台將在 http://localhost:3000 提供服務。

混合 VPC 部署（企業版）

適用於需要雲端便利性並同時在本地處理資料的團隊：

聯繫 sales@jiegou.ai 進行 VPC 代理設定
控制平面（控制台、排程、監控）在 JieGou 雲端運行
工作流程執行在你的 VPC 內進行 — 資料永不離開你的網路
查看我們的混合部署文章了解架構詳情

步驟 3：使用匯入精靈

在你的 JieGou 控制台中導航至 /migrations/n8n
你會看到 n8n 匯入精靈 — 一個三步驟流程

上傳

直接將你的 n8n 工作流程 JSON 貼上到文字區域，或
使用檔案選擇器上傳 .json 檔案

點擊預覽轉換來分析工作流程。

分析過程

匯入工具：

解析 n8n 工作流程 JSON（驗證結構、提取節點和連接）
對應每個 n8n 節點類型到最接近的 JieGou 步驟類型
偵測觸發節點（webhook、排程、手動觸發）並轉換為工作流程輸入
識別整合節點並建議匹配的 MCP 伺服器
建構連接圖（保留執行順序和分支邏輯）
生成轉換報告，標註需要手動處理的項目

步驟 4：審查和調整對應

分析完成後，你會看到詳細的轉換報告。

摘要卡片

報告頂部顯示四個指標：

總節點數 — 工作流程中有多少 n8n 節點
已對應 — 完全轉換為 JieGou 步驟類型的節點
已跳過 — 不需要轉換的節點（例如 NoOp、StickyNote）
警告 — 需要你注意的項目

節點對應表

每個 n8n 節點都顯示其轉換狀態：

狀態	含義	需要操作
已對應	完全轉換為 JieGou 步驟	無 — 確認步驟看起來正確
部分	已轉換但某些參數需要手動審查	檢查步驟設定
手動	無法自動轉換	手動建構等效步驟
已跳過	節點類型不需要轉換	無

n8n 節點如何對應到 JieGou 步驟

n8n 節點	JieGou 步驟	說明
`Set` / `Code` / `Function`	LLM 步驟	AI 執行轉換而非程式碼
`IF` / `Switch` / `Filter`	條件步驟	直接對應 — 相同分支邏輯
`SplitInBatches`	迴圈步驟	直接對應 — 迭代陣列輸入
`Merge` / `Aggregate`	聚合器步驟	合併平行分支的輸出
`HTTP Request`	LLM 步驟 + MCP 工具	使用 HTTP MCP 伺服器進行 API 呼叫
`Slack` / `Gmail` / `GitHub`	LLM 步驟 + MCP 伺服器	使用匹配的 MCP 伺服器整合
`Webhook`（觸發）	工作流程輸入	成為工作流程的輸入架構
`Schedule Trigger`	排程	在 JieGou 排程中另行設定
`OpenAI` / `LangChain Agent`	LLM 步驟	多供應商 BYOK — 自帶金鑰
`Postgres` / `MySQL`	LLM 步驟 + MCP 伺服器	使用資料庫 MCP 伺服器
`Google Sheets`	LLM 步驟 + MCP 伺服器	使用 Google Sheets MCP 伺服器

理解警告

警告分為三類：

🔴 錯誤 — 無法自動轉換。例如：「自訂函式節點使用了 JieGou 中不可用的 npm 套件」
🟡 警告 — 轉換成功但需要驗證。例如：「偵測到 Slack 節點 — 請設定 Slack MCP 伺服器以使用此整合」
🔵 資訊 — 有用的背景。例如：「Webhook 觸發已轉換為工作流程輸入架構」

常見警告及解決方法：

警告	解決方法
「設定 [X] MCP 伺服器」	前往整合 → 市集，安裝 MCP 伺服器並連接你的憑證
「複雜表達式可能需要調整」	審查步驟的提示/設定 — n8n 表達式如 `{{$json.field}}` 已轉換為輸入對應
「自訂程式碼節點」	審查生成的 LLM 提示 — 它描述了程式碼的功能，LLM 將執行相同任務
「不支援的節點類型」	手動建構等效步驟或檢查是否有 MCP 伺服器提供該功能

步驟 5：設定你的 MCP 伺服器

MCP（模型上下文協定）伺服器取代 n8n 的內建整合節點。每個 MCP 伺服器提供 LLM 步驟可使用的工具。

安裝 MCP 伺服器

前往整合 → 市集
搜尋你需要的整合（例如「Slack」、「GitHub」、「PostgreSQL」）
點擊安裝將其新增到你的帳戶
使用你的 API 金鑰或 OAuth 憑證連接

將 n8n 憑證對應到 MCP 伺服器

n8n 憑證	JieGou MCP 伺服器	連接方法
Slack OAuth	Slack MCP 伺服器	OAuth 2.0（透過 Klavis）
Gmail API	Gmail MCP 伺服器	OAuth 2.0（透過 Klavis）
GitHub Token	GitHub MCP 伺服器	個人存取 Token
Postgres 連接	PostgreSQL MCP 伺服器	連接字串
HTTP Header 驗證	HTTP MCP 伺服器	API 金鑰 / Bearer token
OpenAI API 金鑰	帳戶 BYOK 設定	金鑰保管庫中的 API 金鑰
AWS 憑證	AWS MCP 伺服器	存取金鑰 + 密鑰
Google Sheets OAuth	Google Sheets MCP 伺服器	服務帳戶或 OAuth

驗證工具存取

安裝 MCP 伺服器後：

開啟匯入的工作流程
檢查每個使用 MCP 工具的 LLM 步驟
確認選擇了正確的 MCP 伺服器
透過快速手動運行測試連接

步驟 6：用效能比拼測試

上線之前，並排運行你的 n8n 工作流程和 JieGou 工作流程以比較輸出品質。

建立效能比拼

前往效能比拼 → 新增效能比拼
選擇工作流程對比工作流程模式
將你的 JieGou 工作流程新增為 A 組
B 組有兩個選項：
- 分別運行你的 n8n 工作流程並貼上輸出
- 建立另一個具有不同 LLM 設定的 JieGou 工作流程變體

生成測試輸入

點擊生成輸入 — JieGou 建立匹配你工作流程輸入架構的合成測試資料
或從你的 n8n 執行歷史提供真實輸入
我們建議 5-10 個多樣化輸入以進行有意義的比較

審查結果

效能比拼在每個輸入上運行兩組並提供：

LLM 評審評估 — AI 評估者對每個輸出的準確性、完整性和相關性進行評分
統計信心度 — 標準差和 95% 信賴區間
並排比較 — 並排查看輸出以進行手動審查

注意事項

輸出格式 — JieGou 工作流程是否以你下游系統預期的格式產生輸出？
資料完整性 — 所有欄位都已填充嗎？有遺漏的資訊嗎？
邊界情況 — 兩者如何處理空輸入、大型負載或不尋常的資料？
錯誤處理 — API 呼叫失敗時會發生什麼？

步驟 7：上線

一旦你對轉換有信心：

逐步切換

從低風險工作流程開始 — 內部通知、報告生成、資料同步
監控 48 小時 — 在 JieGou 的運行歷史中檢查執行日誌
遷移關鍵工作流程 — 面向客戶的整合、支付處理、資料管線
停用 n8n — 一旦所有工作流程都已驗證，關閉你的 n8n 實例

設定排程

如果你的 n8n 工作流程使用了排程觸發：

前往自動化 → 排程
為每個工作流程建立新排程
設定 cron 表達式（JieGou 支援與 n8n 相同的 cron 語法）
設定時區和輸入參數

設定 webhook 觸發

如果你的 n8n 工作流程使用了 webhook 觸發：

前往自動化 → 觸發器
建立新的 webhook 觸發
複製新的 webhook URL
在你的上游系統（例如 Stripe、GitHub、Slack）中更新 webhook URL

啟用監控

執行警報 — 設定失敗運行的通知
稽核日誌 — 所有工作流程執行都自動記錄 30 種操作類型
SOC 2 證據 — 從合規儀表板匯出合規證據

疑難排解

上傳時出現「無效 JSON」錯誤

驗證檔案是有效的 JSON（嘗試貼上到 jsonlint.com）
如果你匯出了多個工作流程，檔案是 JSON 陣列 — 匯入工具處理單一工作流程和陣列
檢查 BOM 字元或編碼問題（儲存為 UTF-8）

節點標記為「需要手動」

這表示匯入工具無法自動轉換此節點類型。常見情況：

自訂函式節點具有複雜的 npm 依賴 → 將邏輯改寫為 LLM 提示或使用 HTTP MCP 伺服器呼叫外部 API
FTP / SFTP 節點 → 使用檔案系統 MCP 伺服器或基於 HTTP 的檔案傳輸服務
XML 節點 → LLM 步驟原生處理 XML 解析 — 在提示中描述轉換

匯入後工作流程執行失敗

檢查運行詳情頁面的具體錯誤
常見原因：
- MCP 伺服器未設定（從市集安裝）
- 輸入架構不匹配（檢查工作流程的輸入設定）
- LLM 供應商缺少 BYOK 金鑰（在帳戶設定 → API 金鑰中新增）

效能差異

JieGou 工作流程是 AI 原生的 — 而非在 VM 中執行程式碼，它們使用 LLM 步驟來執行轉換。這意味著：

延遲可能較高 — 對於簡單的資料轉換（LLM 呼叫 vs. 記憶體內程式碼）
品質可能較高 — 對於非結構化資料處理（LLM 理解 vs. 正規表達式/程式碼）
維護更低 — API 變更時無需除錯程式碼

如果延遲很關鍵，使用條件步驟跳過確定性操作的 LLM 呼叫，並將 LLM 步驟保留給受益於 AI 的任務。

遷移檢查清單

使用此檢查清單追蹤你的遷移進度：

需要幫助？

匯入工具： console.jiegou.ai/migrations/n8n
MCP 市集： console.jiegou.ai/integrations/marketplace
社群： community.jiegou.ai
企業支援： sales@jiegou.ai
安全詳情： 為什麼我們選擇混合部署