跨實例工作流同步工具 - n8n 工作流程

管理多個預演和正式版 n8n 環境的自動化架構師。
需要在不同自架實例間部署一致 n8n 工作流更新的技術團隊。
希望有可靠方式在不同帳號間備份或轉移特定 n8n 範本的使用者。
任何為管理和 DevSecOps 任務使用 n8n API 的人。

管理多個 n8n 實例時，同步挑戰經常隨之而來。手動匯出和匯入複雜的 n8n 工作流定義非常耗時且容易出錯。這個專用的 n8n 工作流透過自動識別並複製來源實例中存在但目標實例所遺漏的工作流來解決這個問題。

此自動化利用原生的 n8n 節點功能和「合併 (Merge)」節點中的 SQL 比較邏輯，確保了高度精確的同步。在複製遺漏的 n8n 工作流後，它會使用進階的 HTTP 請求步驟，可選擇將新工作流指派到目標實例上的特定專案，讓您對新 n8n 範本的部署擁有完整的管理權限。

此自動化是從「點擊測試工作流 (When clicking Test workflow)」的 n8n 觸發器開始。

1. 擷取工作流： n8n 工作流立即分岔，同時向來源實例的 GET - Workflows n8n 節點和目標實例的 GET - Destination Workflows n8n 節點查詢其工作流。


2. 準備資料： 使用「依工作流分割 (Split Out Workflows)」n8n 節點變體來分別處理來自兩個實例的資料。


3. 識別遺漏的工作流： 核心邏輯位於「合併工作流 (Merge Workflows)」n8n 節點中，它使用 SQL LEFT JOIN 進行比較。它會比較來源（輸入 1）的工作流名稱與目標（輸入 2）的工作流名稱。WHERE input2.name IS NULL 這個子句確保只有來源中存在但目標遺漏的工作流才會被傳送出去。


4. 批次處理：「逐項迴圈 (Loop Over Items)」n8n 節點會以小批次（每批 5 個項目）來處理已識別的工作流。


5. 建立工作流： 對於每一個遺漏的工作流，「建立工作流 (CREATE - Workflow)」n8n 節點會利用目標實例的 n8n API 憑證，在目標實例上重新建立該工作流，包含其節點、連線和設定。


6. 專案指派 (選用)： 建立後，工作流會使用 HTTP 請求動態找出目標實例上的目標專案 ID 並進行篩選。最後，「放入專案的工作流 (PUT - Workflow in Project)」n8n 節點將新建立的 n8n 工作流轉移到指定的專案中。

若要部署這個強大的 n8n 工作流並管理您的 n8n 範本，請遵循以下步驟：

1. 匯入 JSON： 複製提供的 n8n 工作流 JSON 代碼，並使用『新增 (New)』選單 ->『從 JSON 匯入 (Import from JSON)』功能將其匯入到您的 n8n 實例中。


2. 設定來源實例憑證： 找到 GET - Workflows n8n 節點。將『n8n API』憑證（範本中標記為『AK n8n original account』）更新，使其指向您的 來源 n8n 實例。


3. 設定目標實例憑證： 將 GET - Destination Workflows 和 CREATE - Workflow 所使用的『n8n API』憑證（範本中標記為『AlexK1919 n8n ent account』）更新，使其指向您的 目標 n8n 實例。


4. API 金鑰： 確保所設定的憑證具有必要的權限（通常是 全部 (All) 權限），以便列出和建立 n8n 工作流項目。


5. 設定專案篩選器 (選用)： 如果您希望使用專案指派功能，請導覽至 Filter Project n8n 節點，並變更條件中的 rightValue，以匹配您希望新 n8n 工作流轉移過去的目標實例上的專案確切名稱。

此 n8n 工作流依賴核心節點和 n8n API：

點擊「測試工作流」(手動觸發)： 啟動複製程序的關鍵 n8n 觸發器。用於即時同步測試。
GET - Workflows / GET - Destination Workflows (n8n 節點)： 使用 n8n API 資源來擷取各自來源和目標實例上的所有工作流。
合併工作流 (Merge 節點)： 對於邏輯控制至關重要。使用「依 SQL 合併 (Combine by SQL)」模式並搭配 LEFT JOIN，根據工作流名稱過濾掉在目標實例上已存在的工作流。
建立工作流 (CREATE - Workflow) (n8n 節點)： 最後的動作節點，負責將遺漏的 n8n 工作流完整 JSON 定義 POST 到目標實例的 API。
篩選專案 (Filter Project) (篩選器節點)： 用於透過匹配專案名稱（例如『z Original n8n Workflows from AlexK1919』）來識別目標實例上的特定專案 ID。
放入專案的工作流 (PUT - Workflow in Project) (HTTP 請求節點)： 一個進階的工具性 n8n 節點，它會發起 API 呼叫，將新建立的 n8n 工作流轉移到特定的專案容器中。