n8n 自架 10 月起只認 Docker:npm 安裝會被停掉,開站指令、搬家步驟與會消失的節點一次列給你
文章最後更新:2026-08-30
自架 n8n 是目前少數「真的可以永久免費、而且沒有執行次數上限」的自動化工具。但官方在 3.0 的破壞性變更說明裡寫了一句話,會讓一部分人的安裝方式在今年 10 月之後失效:
Self-hosted n8n will require a Docker-based deployment. n8n 3.0 will no longer support installations run using
npmornpx n8n. (自架 n8n 將需要以 Docker 部署。n8n 3.0 不再支援以npm或npx n8n執行的安裝。)
同一頁寫明 3.0「scheduled for October 2026」(排定 2026 年 10 月)。
這篇不是新聞複述。這篇是教你現在就用 Docker 把它開起來,指令可以直接複製;順便把「搬家前不備份就救不回來」的那個資料夾、以及 3.0 會一起拿掉的節點講清楚。
三句話先講完
- 自架免費是真的:Community Edition 永久免費、沒有執行次數上限、使用者與工作流不限(限制來自你自己的主機)。
- 但安裝方式要換:3.0 起自架只認 Docker。現在用
npx n8n的人,10 月前要搬。 - 官方 Cloud 沒有永久免費層:只有 14 天試用(1,000 次執行、免信用卡),到期未升級直接刪工作區,工作流可在 90 天內下載備份。
一、誰要動、誰不用動
| 你現在怎麼跑 n8n | 3.0 之後 | 要不要現在動 |
|---|---|---|
npx n8n 或 npm install -g n8n | ❌ 不再支援 | 要,10 月前搬到 Docker |
Docker(n8nio/n8n 映像) | ✅ 不受影響 | 不用 |
| Docker Compose | ✅ 不受影響 | 不用 |
| 官方 Cloud | ✅ 不受影響 | 不用(這是託管的,不是自架) |
二、照做:三行把 n8n 開起來
以下指令逐字取自官方 Docker 安裝文件,只把時區換成台灣:
docker volume create n8n_data
docker run -it --rm \
--name n8n \
-p 5678:5678 \
-e GENERIC_TIMEZONE="Asia/Taipei" \
-e TZ="Asia/Taipei" \
-e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
-e N8N_RUNNERS_ENABLED=true \
-v n8n_data:/home/node/.n8n \
n8nio/n8n
跑起來之後,瀏覽器開 http://localhost:5678 就是編輯器。
逐項解釋,尤其最後一行:
-p 5678:5678:n8n 的預設連接埠。要換成別的埠,改冒號左邊那個數字就好。GENERIC_TIMEZONE:給排程(Schedule)節點用的。沒設會照容器預設時區跑,你設「每天早上 9 點」可能會在奇怪的時間觸發。TZ:給容器裡其他程式(例如寫進日誌的時間)用的。官方文件把這兩個分開列,兩個都要設。-v n8n_data:/home/node/.n8n:這一行最重要。上面的指令帶了--rm,容器一停就會被刪掉;資料能留下來,靠的完全是這個 volume。少打這一行,你的工作流與憑證會跟著容器一起消失。
三、搬家:從 npm 版搬到 Docker,先備份這個資料夾
關鍵是家目錄底下的 .n8n 資料夾。它裡面不只是資料庫——官方在 Docker 文件裡特別提醒:
When using PostgreSQL, n8n doesn’t need to use the
.n8ndirectory for the SQLite database file. However, the directory still contains other important data like encryption keys, instance logs, and source control feature assets. (改用 PostgreSQL 時,n8n 不需要用.n8n目錄放 SQLite 資料庫檔。但該目錄仍存放其他重要資料,例如加密金鑰、執行個體日誌與版本控管功能的資產。)
加密金鑰(encryption key)就在裡面。 你所有串接的憑證——Google、Slack、資料庫密碼——都是用它加密的。金鑰弄丟,憑證全部解不開,只能一個一個重設。
所以搬家順序是:
- 停掉現在的 n8n。
- 完整備份
~/.n8n(含隱藏檔,cp -a或打包成 tar,不要只複製看得見的檔案)。 docker volume create n8n_data。- 把備份內容放進這個 volume(對應到容器內的
/home/node/.n8n)。 - 用上面第二段的
docker run起來。 - 登入確認:工作流在不在、憑證能不能正常連線、排程有沒有照你設的時間跑。全部確認過,才刪掉 npm 版。
⚠️ 這一段要誠實標示:官方在 3.0 破壞性變更頁寫的是「Step-by-step migration guidance will be coming soon」(逐步遷移指南即將推出)——也就是說,官方到 2026-08-30 為止還沒有發布正式的遷移手冊。上面六步是依官方 Docker 安裝文件與資料目錄說明推導出來的做法,不是官方遷移步驟。正式搬之前請先在測試機演練一次,並保留原本的 ~/.n8n 備份不要刪。
四、之後怎麼更新
用 Docker Compose 的話,官方給的更新三步:
docker compose pull
docker compose down
docker compose up -d
先拉新映像、停舊的、再用新的起來。資料放在 volume,不會跟著容器走。
五、3.0 還會拿掉什麼(現在就別再用了)
如果你正在建新的工作流,這些東西已經不值得再用,因為 3.0 會移除:
節點
- Function(舊版)
- Function Item(舊版)
- Item Lists(舊版)
運算式
$getPairedItem將被移除
功能
- Chat Hub
- 編輯器內的「從 URL 匯入工作流」
安全預設收緊(會影響既有流程能不能跑)
- 金鑰輪替(key rotation)預設開啟
- Compression 節點的解壓上限:2 GiB → 256 MiB
- ZIP 最大條目數:5,000 → 1,000
最後兩項要特別注意:你原本能處理的大檔,3.0 之後可能直接失敗。 有在用 Compression 節點拆大量檔案的人,升級前先量一下自己的檔案有多大、幾個檔。
六、免費到什麼程度(站上查核值,2026-08-28 官方頁直讀)
| 路線 | 額度 | 期限 | 到期怎麼辦 |
|---|---|---|---|
| 自架 Community Edition | 無執行次數限制(受自己主機資源限制) | 永久 | 不會到期 |
| 官方 Cloud 免費試用 | 1,000 次執行 | 14 天 | 未升級即刪工作區;工作流 90 天內可下載 |
自架版免費包含:視覺化編輯器與 400+ 整合節點、AI Agent/LangChain 節點(自備 LLM 金鑰,模型費用另計)、自寫 JavaScript/Python 的 Code 節點。
不含(付費或 Enterprise 專屬):SSO(SAML)/LDAP、環境管理(Git 版控多環境)、log streaming、外部密鑰管理;Insights 儀表板、全域變數、執行搜尋則屬 Cloud Pro 以上。
七、授權的坑:fair-code 不等於開源
自架版採 Sustainable Use License,官方自稱 fair-code,不是 OSI 認證的開源授權。實際界線是:
- ✅ 自己公司內部商業用途,可以。
- ✅ 幫客戶做顧問、幫人建流程收服務費,可以。
- ❌ 拿 n8n 白牌轉售,不行。
- ❌ 架成託管服務向第三方收費,不行。
想接案的人這條要看清楚:賣你的工,可以;賣它的軟體,不行。
八、要付錢的話(官方以歐元計價)
站上查核紀錄註明:以下為官方定價頁的歐元原始數字,未做匯率換算。
| 方案 | 月費(年繳月均) | 每月執行次數 |
|---|---|---|
| Starter | EUR 20 | 2,500 次、5 個並行 |
| Pro | EUR 50 | 10,000 次、20 個並行 |
| Business | EUR 667 | 40,000 次、並行自動擴展 |
| Enterprise | 報價制 | 自訂、200+ 並行 |
計價單位是**「每月執行次數」不是任務數**:一條十幾個步驟的複雜工作流跑一次,只算 1 次執行。這對步驟多的流程比按 task 計費的對手划算——這也是很多人從別家搬過來的原因。
九、還查不到的(不猜,照實寫)
- 官方逐步遷移指南:尚未發布(官方原文「coming soon」)。
- 3.0 確切上線日期:官方只寫「October 2026」,沒有給日。
- npm 裝的舊版在 3.0 之後還能不能繼續跑:官方未說明。合理推測是「舊版還在你機器上就還能跑,但不會再有更新」,但這是推測不是官方說法,待查核。
- 台灣本地付款方式:站上記錄為未確認。
建議
- 現在用
npx n8n的人:別等 10 月。搬家最花時間的是驗證憑證還能不能用,那件事你會想在有空的時候做,不是在官方停止支援的那一週做。 - 還沒開始的人:直接照第二段的 Docker 指令開,一步到位。
- 只是想試試看的人:Cloud 14 天試用不用信用卡,但記得它到期會刪工作區,做出來的流程要在 90 天內下載。
官方連結
- n8n 官方 Docker 安裝文件:https://docs.n8n.io/deploy/host-n8n/install-options/install-with-docker
- n8n 3.0 破壞性變更說明:https://docs.n8n.io/changelog/v30-breaking-changes
- n8n 官方定價頁:https://n8n.io/pricing/
站內延伸
