n8n 官方在 2026 年 10 月 27 日發布 3.0.0 測試版（官方寫 BETA），隔天出了修正版 3.0.1，正式版預計 12 月初推出。3.0 沒有加什麼大功能，主要是把過去一年累積、會讓舊設定或舊流程失效的變更一次收進來：自己架 n8n 不再支援用 npm 安裝、一律改用 Docker，一批舊節點被拿掉，幾個安全相關的預設值也變嚴了。正式環境不用急著今天就升，先用 n8n 內建的遷移報告看看哪些流程會受影響、排好時間，等 12 月正式版再升；但有兩種人現在就要動手：還在用 1.x 的（官方支援到 2026 年 12 月 31 日，而且不能直接跳到 3.0），以及用 npm 架 n8n 的。
如果你不想自己處理 Docker 和每一次大版本升級，可以把 n8n 交給 n8n 託管，主機與容器有人顧，你只管流程。下面依序整理 3.0 的時程、影響最大的變更、升級前要做的檢查，以及用 npm 架的人有哪些路可以走。
本文依 n8n 官方部落格、官方文件與 GitHub 發行紀錄整理，資料截至 2026 年 10 月 30 日；3.0 還在測試階段，變更清單與正式版日期以官方最新公告為準。
n8n 3.0 的時程：測試版、正式版與舊版本的支援
官方 10 月 23 日先在論壇預告，10 月 27 日在部落格發表〈Introducing n8n 3.0〉並推出 3.0.0 測試版，10 月 28 日的 3.0.1 修了一批錯誤，同一天的資安公告也把 3.0.1 列為 3.0 這條線的修正版本。官方說正式版預計在 12 月初，確切日期還沒公布，之後會寫在官方的版本發行說明。
n8n 照語意化版本的規則走，會讓舊東西失效的變更只會在大版本出現，所以這一年累積下來的變更集中在 3.0。官方說 2.0 在 2025 年 12 月推出後已經出了 45 個以上的版本，大約每週一版；3.0 正式版推出後，新功能只會做在 3.x，2.x 會繼續收到 12 個月的資安與重大錯誤修正。1.x 的支援在 2026 年 12 月 31 日結束，官方也寫明 1.x 沒有直接升到 3.0 的路，要先升到 2.x 再升 3.0。這些變更同時適用自架的社群版、n8n Cloud 與企業版。
| 你現在的版本 | 官方的狀態 | 建議怎麼做 |
|---|---|---|
| 1.x（1.123 系列） | 2026 年 12 月 31 日結束支援，不能直接升 3.0 | 先在 1.x 補到 10 月 28 日資安公告的 1.123.89 以上，接著排時間升 2.x |
| 2.x 穩定版 | 3.0 正式版推出後，再收 12 個月的資安與重大錯誤修正 | 維持在 2.x 最新版（10 月 28 日公告的修正版是 2.45.5），先看遷移報告，等正式版再升 |
| 3.0 測試版 | 10 月 27 日起測試，正式版預計 12 月初 | 先在測試環境試；已經在用的至少升到 3.0.1 |
影響最大的幾項變更
對自架的人來說，最大的一項是安裝方式。3.0 不再發布可以直接執行的 n8n npm 套件，用 npm 安裝、或用 npx n8n 執行的 n8n 升不上 3.0；官方往後的自架方式是 Docker，用 Kubernetes 或 Helm 部署的不受這項影響。不管是在自己電腦上用 npx 試玩，還是在主機上直接用 npm 跑正式流程，都要先換成 Docker 才能升級。
第二項是舊節點。Function、Function Item、Item Lists、Cron、Interval、舊版 OpenAI 節點，以及 AI Agent 節點第 1 版和舊的 agent 模式都被拿掉；Read PDF、Workflow Trigger、OpenAI Assistant、OpenAI Model、舊版 HTTP Request Tool、Manual Chat Trigger、Chat Messages Retriever 也一起移除。大多數都有直接的替代節點，官方的變更文件逐一列出。舊流程裡常見的 Function 程式碼，現在一般寫在 Code 節點；用 Cron、Interval 定時跑的流程，現在用 Schedule Trigger 設定，寫法可以參考〈n8n 排程教學〉。要注意的是 HTTP Request 節點本身還在，拿掉的只有給 AI Agent 用的舊版 HTTP Request Tool。
第三類是 Code 節點與流程行為。Code 節點的 JavaScript 不能再用 $evaluateExpression()，$getPairedItem 也拿掉了，Code 節點裡的「Ask AI」分頁移除；Execute Sub-workflow 節點的來源選項拿掉 Local File 與 URL；Edit Image 節點第 1 與 1.1 版不再支援。開了 Always Output Data 的 If、Switch 這類有多個輸出的節點，改成所有輸出都是空的時候才補一個空項目，以前是每個空的輸出都補一個，會讓不該跑的分支跑起來；依賴舊行為的流程，升級後走向可能跟以前不同，要實際跑一次確認。舊版本的 Gmail Trigger 節點改用 1.4 版的方式執行，Chat Trigger 透過 WebSocket 送的訊息改成 JSON 格式，有自己寫前端接 Chat Trigger 的要一起改。
第四類是安全預設與設定。加密金鑰輪替預設開啟，Slack API 憑證一定要填 signing secret，預設封鎖的伺服器端請求偽造（SSRF）目標變多，Compression 節點的解壓縮上限調低。設定方面，3.0 第一次啟動時會把 ~/.n8n/binaryData 改名成 ~/.n8n/storage，並拿掉 N8N_MIGRATE_FS_STORAGE_PATH 這個環境變數；如果兩個資料夾同時存在，n8n 會直接停下來報錯，不會自己猜要用哪一個。用佇列模式的，手動執行一律交給 worker 跑，OFFLOAD_MANUAL_EXECUTIONS_TO_WORKERS 和 N8N_DB_PING_TIMEOUT 兩個環境變數移除。另外，Chat Hub 預設關閉（3.x 可以手動打開），編輯器的「Import from URL」也拿掉了。
升級前先做的四件事
- 先看遷移報告。官方建議升級前到 n8n 的 Settings → Migration Report，它會列出你的哪些流程與設定會被 3.0 的變更影響，官方文件〈v3.0 Migration tool〉有說明。照報告把舊節點換掉、改好受影響的設定，再談升級。
- 備份資料與加密金鑰。資料庫是 SQLite 的，備份整個 .n8n 資料夾；用 PostgreSQL 的，先匯出一份資料庫。憑證是用 N8N_ENCRYPTION_KEY 加密的，沒有自己設定的話，金鑰存在 .n8n 資料夾的設定檔裡，換主機或重建容器時少了它，所有憑證都解不開。
- 先在複製出來的測試環境升。用同一份備份另外開一個 n8n，升到 3.0 後把常用流程手動跑一次，確認 Webhook 收得到、排程有在跑、AI Agent 與 Code 節點的結果跟以前一樣。測試環境記得先停用排程和會寄信、會收款的流程，免得跟正式環境重複執行。
- 正式環境把版本號寫清楚。Docker 映像不要只寫 latest，寫明確的版本號，出問題時才知道要退回哪一版；大版本退回時，資料庫與檔案也要一起還原成升級前的備份。
用 npm 架 n8n 的人，有三條路
第一條是改成 Docker 自架。這是官方往後唯一支援的自架方式，之後升級、退回都只是換映像的版本號。搬的時候把原本的 .n8n 資料夾（含資料庫與設定檔裡的加密金鑰）整個帶進容器，或用 n8n export:workflow --all 與 n8n export:credentials --all 把流程和憑證匯出、在新環境匯入。適合熟悉 Docker、願意自己顧主機的人，自架實際要花多少，可以看〈自架 n8n 比較便宜嗎〉。
第二條是改用官方的 n8n Cloud。3.0 的變更同樣適用 Cloud，用到被移除的節點一樣要換，但主機與升級由官方處理；它依執行次數計費，流程跑得多要先算清楚，差別寫在〈n8n 自架 vs n8n Cloud〉。
第三條是交給託管服務。RoamerHost 的 n8n 自動化系統是獨立的 Docker 容器與獨立網路，主機、Docker、反向代理都不用你碰，包含自動更新、自動備份、24/7 運行監控與自動重啟，執行次數與流程數不設上限，年繳 NT$5,988（年繳平均每月 NT$499），付款後約 60 秒開好。流程隨時可以匯出成 JSON，之後想搬走也不會被綁住，方案內容在 n8n 託管方案與價格。原本架在 Zeabur 的，對方已宣布年底停止服務，搬家前可以先看〈Zeabur 停止營運後的搬家指南〉。
什麼時候升比較好
正式環境等 12 月初的正式版再升比較穩：測試版本來就是讓大家先找問題的，而正式版推出後 2.x 還有 12 個月的資安修補，時間很夠。這段時間可以先做不會出錯的準備：升到 2.x 最新版、跑遷移報告、把舊節點換掉、把 npm 安裝換成 Docker。還在 1.x 的要把時程往前排，年底支援結束後就收不到資安修補，而 n8n 現在大約每兩週發一次資安公告，10 月的三次整理在〈n8n 10 月資安更新〉。
如果你的 n8n 跑的是每天都要動的業務流程、身邊沒有人顧主機，大版本升級和固定的資安更新會一直來，交給 RoamerHost 的 n8n 託管，可以把時間留給流程本身；熟 Docker、想完全自己掌控環境的，照上面四件事自己升就好。
常見問題
Q：n8n 3.0 已經是正式版了嗎？
還不是。10 月 27 日推出的是 3.0.0 測試版，10 月 28 日出了 3.0.1；官方預計 12 月初推出正式版，確切日期請看官方的版本發行說明。
Q：我還在 1.x，可以直接升到 3.0 嗎？
不行。官方寫明 1.x 沒有直接升到 3.0 的路，要先升 2.x、確認流程正常，再升 3.0。1.x 的官方支援到 2026 年 12 月 31 日，在那之前至少先把 1.x 補到 1.123.89 以上，把 10 月的資安漏洞補起來。
Q：升到 3.0 之後，原本的流程會壞掉嗎？
要看你用了哪些節點和設定。用到已移除的舊節點、Code 節點裡的 $evaluateExpression()，或依賴舊的 Always Output Data 行為的流程，升級後會出錯或走向改變。遷移報告會列出受影響的流程，照著改完再升，並先在測試環境跑過一次。
Q：用 n8n Cloud 也要處理嗎？
要看流程。官方說 3.0 的變更同樣適用 Cloud，用到被移除的節點一樣要換；主機與升級本身由官方處理，Cloud 什麼時候切到 3.0 以官方通知為準。
Q：用 Docker 自架，升級只要換版本號嗎？
同一條版本線裡大多是這樣，但 3.0 是大版本：第一次啟動會把 binaryData 資料夾改名成 storage，也拿掉了幾個環境變數。升級前先備份 .n8n 資料夾與資料庫、看過遷移報告，再把映像換成明確的 3.x 版本號。
資料來源
- n8n 官方部落格：Introducing n8n 3.0
- n8n 官方文件：v3.0 Breaking changes、v3.0 Migration tool、Release notes
- n8n 官方論壇：Announcing n8n version 3.0、2026 年 10 月 28 日資安公告
- n8n GitHub：3.0.0 發行紀錄、3.0.1 發行紀錄
- RoamerHost：n8n 自動化系統方案與常見問題
n8n
