判斷：不要只把資料庫環境變數改成 PostgreSQL，就當作遷移完成；先備份並界定資料範圍，再按目前 n8n 版本的官方路徑處理，最後逐項驗收。若不需要舊執行紀錄，可先評估建立 PostgreSQL 資料庫後，只遷移必要業務資料；若必須保留歷史紀錄，先在可回復的副本上驗證適用方法，不要直接套用社群腳本。
適合：SQLite 已承載長期工作流程的獨立開發者，以及需要保留團隊工作流程、憑證或使用者關係的小型團隊維護者。
也適合：打算升級 n8n 2.x、希望把資料庫遷移與版本升級分開驗收的負責人。
若只是個人短期試用，且沒有必須保留的資料，先備份並確認回復方式，未必需要立即換庫。
最後更新於 2026 年 10 月 31 日；資料核對自 n8n 官方資料庫設定、CLI 與版本遷移文件。
先按維護角色決定遷移範圍
n8n 官方文件列有 SQLite 預設資料庫與 PostgreSQL 設定方式；這表示可選擇資料庫，不代表更改連線設定就會把舊 SQLite 內容複製到 PostgreSQL。新資料庫是另一個資料儲存位置，切換後若沒有執行資料匯出、匯入或其他經核實的遷移程序，舊資料不會因環境變數改變而自動出現在新資料庫中。官方資料庫設定文件應作為設定依據，而不是把「能連線」當成「資料已搬妥」。
工作流程與憑證匯入後，原有內容是否都會保留？
n8n CLI 文件支援工作流程與憑證的匯出、匯入；但匯入時的識別碼處理可能影響既有項目，官方文件亦提醒匯入識別碼可能覆蓋目標端內容。先在隔離的測試環境核對目前版本的命令格式與識別碼行為，不要直接對正式資料庫試跑。n8n CLI 文件
| 資料類別 | 遷移前要確認的事 | 驗收時要檢查的事 |
|---|---|---|
| 工作流程 | 需要搬移哪些流程；匯入是否可能覆蓋目標端同識別碼項目 | 清單、啟用狀態、節點設定與觸發方式 |
| 憑證 | 加密金鑰是否保留；目標環境能否解密並使用憑證 | 由具適當權限的人員測試憑證呼叫，不只確認項目名稱存在 |
| 使用者、專案與共享關係 | 目前版本和部署方式下，哪些關係有官方支援的遷移方式 | 登入後的可見範圍、工作流程歸屬與共享權限 |
| 執行紀錄 | 是否真的需要歷史紀錄；目前版本有沒有適用的遷移路徑 | 抽查紀錄完整性，並確認查詢與復原需求 |
| 二進位資料 | 資料儲存模式、實際存放位置與資料庫紀錄之間的關係 | 依部署方式測試所需檔案能否讀取；不能只驗證資料庫 |
n8n 官方文件將工作流程共享、二進位資料儲存與執行資料保留分開說明，這些項目不能一概視為「匯入工作流程」就會一併搬妥。工作流程共享說明、二進位資料儲存說明與執行資料保留說明可用來逐項核對部署方式及資料用途。
讓個人試用者先判斷是否值得換庫
個人試用者先問：目前是否有需要在新環境持續使用的工作流程或憑證？若答案是否定的，較重要的是確認舊資料已備份、備份可讀，並記下回復方式；為了「先換 PostgreSQL 再說」而增加遷移步驟，未必能解決實際問題。
n8n 資料庫遷移前要不要保留執行紀錄？
若執行紀錄只用於短期除錯，而且團隊不需要查閱歷史結果，可先依官方執行資料保留設定確認現行保留政策，再決定是否只搬必要業務資料。若紀錄涉及稽核、問題追查或營運交接，就要把它列為獨立遷移需求，先驗證所採路徑能否保留所需欄位和關聯；不能因工作流程與憑證匯入成功，就推定歷史紀錄也完整。
可用以下分支作決定：
- 若只是試用、沒有需要沿用的工作流程或憑證，選擇先備份並保留可回復副本；未確認需求前，不必急著遷庫。
- 若要延續工作流程與憑證，但不必保留舊執行紀錄，選擇在測試環境建立 PostgreSQL，按官方 CLI 文件驗證匯出、匯入與識別碼影響，再搬移必要資料。
- 若需要延續使用者、專案或共享權限，先在副本上確認目前版本與部署方式有可用的處理路徑；若關係無法驗證，就先不要把正式環境切換過去。
- 若執行歷史必須保留，但官方文件未確認適用路徑，先暫緩正式遷移，補做資料完整性、復原及儲存空間測試；不要以社群腳本取代驗證。
- 若原本打算同時升級 n8n，先把資料庫遷移與版本升級拆成不同驗收工作，並依官方 v2.0 遷移報告及破壞性變更說明核對目標版本。
讓單人維護者分開處理資料與加密金鑰
單人正式環境通常最容易漏掉的不是工作流程檔案，而是憑證能否在目標環境解密。遷移前記錄部署所用的加密金鑰設定，並以安全方式備份必要設定；不要把金鑰貼進一般工作紀錄、版本控制或與備份放在同一個未保護的位置。匯入後應實際執行一個使用既有憑證的流程，確認它能完成所需連線。
n8n 改用 PostgreSQL 後，舊工作流程和憑證能否繼續使用？
可以把官方 CLI 支援的工作流程與憑證匯出、匯入列入計畫，但能否順利使用仍取決於匯入方式、識別碼、目標端狀態及憑證加密設定。先以副本測試，再檢查流程所依賴的憑證、環境設定與外部服務連線；只看到項目出現在清單中，不代表執行條件已復原。
讓小型團隊驗證使用者與共享關係
工作流程和憑證不等於團隊協作狀態。若多人共用 n8n，還要核對使用者、專案、工作流程歸屬及共享設定；把工作流程匯入新資料庫後，原本誰能查看、修改或執行，未必會依預期重現。官方共享文件可以協助釐清協作概念，但不能單獨證明某一種資料庫遷移程序會完整搬移全部關係。
| 維護情境 | 遷移前的決策 | 轉換後的驗收重點 |
|---|---|---|
| 個人試用 | 沒有必要沿用的業務資料時，優先確認備份與回復需求 | 登入、必要流程與憑證是否可用 |
| 單人正式維護 | 列出工作流程、憑證、二進位資料及所需紀錄 | 執行代表性流程，核對憑證呼叫與資料讀取 |
| 小型團隊 | 先確認使用者、專案及共享關係的處理方式 | 由不同角色登入，對照可見範圍、歸屬與權限 |
| 必須留存歷史紀錄 | 先證明遷移方法能保留所需紀錄，再安排切換 | 檢查紀錄完整性、檢索需求及回復可行性 |
| 同時要升級版本 | 分開排定資料庫遷移和 n8n 版本升級 | 分別記錄兩項變更的驗收結果與回復條件 |
依可回復的步驟執行 n8n 資料庫遷移
在正式切換前，先建立能重複執行的驗證流程。以下程序的目的，是避免把「服務啟動成功」誤認為「資料、權限和自動化都已復原」。
- 盤點來源環境。記錄目前 n8n 版本、SQLite 部署方式、資料目錄、二進位資料儲存方式、憑證加密設定，以及團隊實際使用的專案與共享關係。需要保留的項目逐項列出；不確定的資料類型標為待驗證。
- 備份並測試回復。停止可能寫入資料的工作流程或入口，備份 SQLite 資料庫、相關檔案及必要設定，並保留憑證解密所需的設定。安排備份存放位置時，將副本與正式資料分開保存；完成備份後，先在隔離環境確認副本可讀，而不是等到切換失敗才第一次測試。
- 按保留需求選遷移路徑。若不需舊執行紀錄，可測試只匯出、匯入必要的工作流程與憑證；若需要使用者關係、二進位資料或執行紀錄，逐項查證目標版本和部署方式是否有適用的官方程序。社群分享的腳本只能當作個案，不能當成官方支援保證。
- 在測試環境設定 PostgreSQL。依官方資料庫設定文件核對 n8n 目前版本所需的資料庫參數與連線方式，不要照抄其他版本的環境變數範例。確認新資料庫中的資料狀態，再使用 CLI 文件所列的匯出、匯入功能測試工作流程與憑證。
- 分開驗收協作資料與執行紀錄。由實際團隊角色檢查登入、工作流程歸屬、共享範圍與憑證使用情況。對執行紀錄和二進位資料，按自己的保留要求抽查內容與可讀性；無法證明完整時，不應宣稱已完整遷移。
- 分開處理版本升級。若目標還包括 n8n 2.x，先依官方遷移報告與破壞性變更文件確認適用項目。先完成資料庫遷移驗收，再安排版本升級驗收；不要從社群個案推定某個版本組合一定相容。
- 設定明確的回復條件。例如必要工作流程無法執行、憑證不能解密、團隊權限不符，或必要紀錄缺失時，就停止切換並回到已驗證的來源副本。保留原 SQLite 副本，直到團隊確認新環境符合保留需求。
核對伺服器儲存與部署條件
遷移前先估算的不只是 PostgreSQL 資料庫本身，還有執行紀錄、二進位資料、備份副本與未來保留需求。檢查目前資料實際成長情形和保存政策，再決定 n8n 與 PostgreSQL 是否適合放在同一台機器；換資料庫不會自動建立備份，也不會自動帶來高可用。
XFP Cloud 的產品資料列有 2 × 1TB NVMe 直連儲存，可選配額外 NVMe；直連磁碟並非硬體 RAID，若需要磁碟冗餘，需自行規劃軟體 RAID 並另做機外備份。系統選擇可核對產品頁列出的 Linux 發行版，Linux 以 SSH 接入；計費週期則可依計費說明確認。這些條件只說明可用的儲存、系統與租用安排，不代表提供 n8n 遷移代辦、資料備份服務或復原保證。XFP Cloud 產品資訊
把遷移驗收結果作為正式切換門檻
正式切換前，請逐項勾選：
- [ ] SQLite 副本與必要檔案已備份，且已在隔離環境確認可讀。
- [ ] 工作流程與憑證的遷移方式已按目前版本測試，匯入識別碼風險已確認。
- [ ] 憑證加密設定已保留，並有實際流程驗證憑證可用。
- [ ] 團隊使用者、專案、歸屬與共享範圍已由相應角色檢查。
- [ ] 執行紀錄與二進位資料的保留範圍已單獨確認，沒有把未驗證的資料類型列為已完成。
- [ ] 資料庫遷移與 n8n 版本升級有各自的驗收結果及回復條件。
如果使用的只是輕量、短期或可隨時重建的環境，共享 VPS 可能更合適；但若執行環境受共享資源影響、資料與磁碟規劃受限，或需要自行安排 n8n 和 PostgreSQL 的長期部署，獨享伺服器會更容易由維護者掌握整台機器的儲存與系統。完成資料範圍和備份規劃後，可再查看 XFP Cloud 的獨享伺服器產品資訊，核對可用儲存、系統與計費週期，再決定是否把自託管 n8n 與 PostgreSQL 放在同一台 AMD 獨立伺服器上。