n8n 匯入n8n 匯出n8n jsonn8n 備份跨環境搬移

n8n 工作流匯入匯出:JSON 備份與跨環境搬移教學

工作流改壞了想還原、或要把流程從測試搬到正式環境?這篇教你用 n8n 的 JSON 匯入匯出做備份與跨環境搬移,搞懂憑證為什麼搬不過去、版本控管怎麼做,避免一改就回不去。

N8NMarket 2026年6月15日 10 分鐘閱讀

n8n 工作流匯入匯出是把整條流程存成 JSON 檔再讀回來的功能,透過匯出備份與匯入還原,解決「工作流改壞想回到上一版」與「流程要從測試搬到正式環境」這兩個常見需求。

改工作流改到一半,邏輯越改越亂,只想回到昨天那個能跑的版本——結果發現沒備份。或者你在測試環境調好了一條流程,要搬到正式的 n8n,卻不知道怎麼整條搬過去。這兩個情境的答案是同一個:JSON 匯入匯出

n8n 的每條工作流本質上就是一份 JSON。學會匯出存檔、匯入還原,你才有「改壞了能回去」的安全網。本文是《n8n 模板客製化教學》系列的收尾篇,客製化前先學會備份,改起來才敢放手。

工作流就是一份 JSON

打開任何一條 n8n 工作流,它在背後存的是一段 JSON——記錄了有哪些節點、節點的設定、節點之間怎麼連。匯出,就是把這段 JSON 倒出來變成一個檔案;匯入,就是把檔案讀回來重建工作流。

理解這點很重要,因為它解釋了兩件事:

  • 為什麼模板可以分享。模板市場上的工作流就是一份 JSON,你下載、匯入,就重建了原作者的流程骨架。
  • 為什麼憑證搬不過去。JSON 裡只存「這個節點用了某個 Slack 憑證」這個參照,不存憑證內容本身。這是安全設計,後面會詳談。

怎麼匯出工作流

n8n 提供兩種匯出方式,依需求選。

方式一:UI 直接匯出(最常用)

在工作流編輯畫面,點右上角選單,選 Download,n8n 就會把整條流程存成一個 .json 檔下載到你電腦。要備份單一工作流,這最快。

也可以只匯出部分節點:框選你要的幾個節點,按 Ctrl/Cmd + C 複製,這時剪貼簿裡就是那幾個節點的 JSON,貼到別處(甚至貼進文字檔)都行。

方式二:CLI 批次匯出(self-hosted 適用)

如果你是 self-hosted 且工作流很多,一個個點太慢。n8n CLI 可以一次匯出全部:

# 匯出所有工作流到一個資料夾,每條一個檔
n8n export:workflow --backup --output=./n8n-backups/

這個指令很適合排程定期備份。完整的備份策略可以參考《n8n 備份與更新 SOP》,把匯出排成自動排程,就不怕忘記備份了。官方參數說明見 n8n 匯出匯入官方文件

n8n 兩種匯出方式:UI 下載單條、CLI 批次備份

怎麼匯入工作流

匯入更簡單。在 n8n 主畫面或工作流選單,選 Import from File(讀 .json 檔)或 Import from URL(直接給模板網址)。選好來源,n8n 就把整條流程重建到畫布上。

也可以用貼的:複製一段工作流 JSON,在空白畫布按 Ctrl/Cmd + V,節點就全貼出來了。從模板市場或社群論壇拿到的 JSON 程式碼,這招最快。

匯入後先別急著執行。剛匯入的工作流憑證是空的、參數是原作者的,直接跑一定報錯。正確流程是匯入後接著做客製化——換憑證、改參數——這部分照《n8n 模板客製化教學》的五步走就對了。

跨環境搬移:測試搬正式要注意什麼

把工作流從一個 n8n 環境搬到另一個(測試→正式、或換主機),匯出再匯入就是標準做法。但有三個坑要避開。

坑一:憑證不會跟著搬

這是最大的雷。JSON 裡只有憑證的「參照」(一個 ID 和名稱),沒有 token 或 key。搬到新環境後,那些節點會顯示「找不到憑證」。你得在新環境重建同名憑證,節點才會重新對上。憑證怎麼設見《n8n 憑證設定教學》。

坑二:環境相關的參數要改

測試環境指向測試試算表、測試頻道,搬到正式要把這些資源 ID 換成正式的。別讓正式流程還在寫測試資料。

坑三:Webhook URL 會變

如果工作流有 Webhook 觸發器,新環境的 Webhook 網址不一樣。搬過去後要把新網址更新到對接的外部服務(金流回呼、表單通知等),否則事件送不進來。

跨環境搬移三大坑:憑證、環境參數、Webhook 網址

用 JSON 做版本控管

進階一點的玩法:把工作流的 JSON 檔丟進 Git 版控。

每次改完工作流就匯出一份 JSON、commit 一次,你就有完整的修改歷史。改壞了,git checkout 回上一版的 JSON、重新匯入,立刻還原。團隊協作時,誰改了哪條流程也一目了然。

這對重要的生產工作流特別值得。比起 n8n 內建的還原,Git 版控給你的是「任意時間點都能回去」的能力。流程不複雜:建一個 repo,把匯出的 JSON 都放進去,養成改完就 commit 的習慣即可。社群裡也有人把這套做成自動同步到 GitHub 的工作流,做法討論可參考 n8n 官方社群論壇,搜「git backup」就有不少現成方案。

常見問題

Q:匯入別人的工作流安全嗎?會不會藏惡意程式? 工作流 JSON 本身是設定資料,但要小心 Code 節點裡的自訂 JavaScript,以及寫死的可疑網址。匯入來路不明的模板,先把每個節點(尤其 Code、HTTP Request)點開看一遍再執行。

Q:匯出的 JSON 可以手動編輯嗎? 可以,它是純文字。但不建議新手直接改——一個括號錯了整條就匯入失敗。要批次改(例如把某個舊網址全換掉),改完務必在測試環境先匯入驗證。

Q:為什麼匯入後節點都在但連線斷了? 多半是只複製了節點沒複製連線,或 JSON 不完整。重新完整匯出/複製一次。用 UI 的 Download 匯出的整檔不會有這問題。

Q:免費的 n8n Cloud 方案能用 CLI 匯出嗎? CLI 匯出是 self-hosted 才有的能力。n8n Cloud 用 UI 的 Download 逐條匯出。要批次備份就得自己排一條「定時把工作流存到雲端硬碟」的工作流,或升級方案。

小結

n8n 工作流的本質是 JSON,學會匯入匯出,等於給自己裝了「改壞能回去」的安全網。匯出用 UI 的 Download 或 CLI 的 export:workflow,匯入用 Import from File/URL 或直接貼。

跨環境搬移記住三個坑:憑證要在新環境重建、環境參數要換、Webhook 網址會變。重要的生產流程,再進一步用 Git 把 JSON 版控起來,就有完整的修改歷史可回溯。把這套備份習慣養成,客製化模板時才敢大膽改。

想要一批附完整節點說明、好備份好搬移的 n8n 工作流模板,可以逛逛 N8NMarket 的模板庫,匯入就能開始改。