N8n 2.30.4 – 安全地還原遺失的節點,具有原始 ID 和版本保護

你好 n8n 社群,

我們需要有關如何安全地修復 自主託管 n8n 2.30.4 中現有工作流程的指導,而不會冒著造成無意變更的風險。

目前情況

  • 工作流程處於非活躍且未發佈的狀態。
  • 目前包含 26 個節點。
  • 一個資料表格節點(n8n-nodes-base.dataTable,typeVersion 1.1)遺失。
  • 原始遺失節點的 ID 為 b4-17。
  • 我們已驗證目前工作流程和原始 27 節點設計的備份。
  • 僅應還原遺失的節點及其兩個連接。
  • 所有現有節點、認證、webhook 路徑、工作流程設定和工作流程身份必須保持不變。

之前嘗試將部分 JSON 片段貼入編輯器時,意外地變更了工作流程標題。我們停止了操作,隨後恢復了預期的標題。

我們不想在沒有可靠保障的情況下重複此方法。

問題

1. 使用原始 ID 還原節點

原生 n8n 2.30.4 編輯器是否支援插入或還原節點,同時保留其確切的原始 JSON ID(b4-17)?

如果不支援此功能,假設節點名稱、參數、表達式和連接保持正確,保留原始節點 ID 在技術上是否必要?

是否存在任何可能依賴此 ID 的內部參考或機制?

2. 版本衝突保護

n8n 2.30.4 在透過編輯器保存工作流程時,是否能可靠地防止並行修改?

對於 API 端點 PUT /api/v1/workflows/{id},versionId 在此特定版本中是否提供有效的樂觀鎖定?

目前的 API 文件提及樂觀鎖定,但 versionId 在更新架構中也顯示為唯讀。我們希望獲得有關實際支援行為的澄清。

3. 最安全的官方支援修復程序

在現有非活躍工作流程中還原恰好一個遺失節點及其兩個連接的建議方法是什麼?

我們的優先事項是:

  • 保留現有工作流程 ID 和標題。
  • 保留每個現有節點和無關的連接。
  • 保留認證、webhook 路徑和安全設定。
  • 防止無意的啟用或發佈。
  • 建立完整的修改前後 JSON 比較。
  • 避免覆寫並行變更。

您會建議對 n8n 2.30.4 進行受控編輯器操作還是 API 更新?

我們特別感謝官方文件或相關版本特定原始碼的參考。

基於安全考慮,我們不會發佈完整的工作流程 JSON、API 金鑰、認證或內部基礎架構詳細資訊。

感謝您的幫助!

嗨 @Zafer_Imre,在 2.30.4 中公開的 PUT 處理程序設置 forceSave: true。因此傳遞 versionId 不能防止覆蓋並發變更。

  1. 正常的剪貼板貼上會重新生成節點 ID。導入程式也會應用頂級 name,這可以重新命名工作流程。普通連接和節點名稱表達式使用名稱,所以 b4-17 通常不需要用於路由。ID 在其他地方仍然重要,例如 nodeGroups.nodeIds。

  2. 編輯器會發送 expectedChecksum,但當停用共用支持時,控制器會略過該檢查。其校驗和檢查和數據庫更新是分開的操作。此版本中的任何路由都不能給你無條件的原子 versionId 保護。

  3. 如果必須保留 b4-17,我會使用公開 API 並阻止所有其他編輯器/API 寫入器,先在隔離的 2.30.4 副本上排練修復。取得目前 26 節點工作流程的新鮮 GET,並只合併原始節點物件,保留其 ID 和 typeVersion 1.1,以及兩個預期的連接。使用目前圖表作為基礎,而不是用舊的 27 節點備份替換它。在發送 PUT 到現有工作流程 ID 之前,查看預期的差異。

PUT 主體必須遵循該版本的可寫入架構,包括 name、完整的 nodes 和 connections,以及 settings;不要提交包含唯讀元數據的整個 GET 回應。在更新前確認 activeVersionId 為空:此路徑重新發布已發布的工作流程,但不發布未發布的工作流程。

再次 GET 它並保留完整的前後 JSON 差異。預期伺服器管理的修訂/時間戳記變更;驗證標題、現有節點、認證參考、webhook 路徑、設定和無關連接保持不變。單獨進行 GET/比較再 PUT 無法防止競爭。如果不需要原始 ID,在編輯器中重新建立節點及其兩個連接會更簡單。

2.30.4 源代碼:

最安全的方式是完全跳過貼到編輯器的步驟。匯出工作流程 JSON,將節點物件加回節點陣列中並保持其原始 id,然後手動在 connections 下新增它的兩個條目。將其匯入為新工作流程,與備份進行比較,只有在確認後才替換。

匯出原始工作流程 json,並手動插入具有其原始 id 的節點區塊,可以保留所有下游引腳參考,並防止連線中斷。

在複製的草稿上測試修補後的工作流程,然後再將變更儲存到使用中的工作流程,可確保您避免意外的生產停機時間。