n8n 安裝教學：Docker 一行指令實測 45 秒，去哪下載、npm 為什麼快停用了

你照著網路上的教學打 npx n8n，或是貼上一長串 docker run，現在都還跑得起來。

但 n8n 的官方文件在 2026 年換了說法。npm 那一頁寫著 3.0 起停用。docker run 那一頁最上面標了「這份內容已經過時」。現在排在最前面的是一行指令。

舊教學沒有寫錯，只是快要過期了。

我把三種裝法都在乾淨的 Linux 主機上跑了一次，日期是 2026 年 10 月 12 日，n8n 的版本是 2.42.7。這篇講各自花多久、佔多少空間，還有現在該選哪一種。還不確定要不要自己架的話，先看n8n 費用怎麼算，裡面有雲端和自架的比較。

三種裝法，先看我量到的結果

三種都是在 2 核心、4 GB 記憶體、Ubuntu 26.04 的雲端測試機上量的。

時間是在機房的網路上量的。在家裡裝，下載那一段會比較久。

官方現在推的：一行指令

這個方法要先有 Docker。它不用你懂 Docker，裝好、開著就行。

Windows 和 Mac 是裝 Docker Desktop。Linux 主機我是用 Docker 官方的安裝腳本：

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

16 秒裝完，裝進來的是 Docker 29.9 和 Compose 5.6。Docker 官方說這個腳本適合拿來試，正式環境建議照文件用套件庫安裝；這件事和 Docker 的基本指令，我寫在Docker 是什麼。

接著是 n8n 的那一行。官方文件寫的是：

curl -fsSL https://get.n8n.io | sh

我習慣先把腳本存下來看一眼再跑，官方文件也有教這個做法。腳本有 577 行。加上 --version 不會安裝，只會告訴你它打算裝哪一版：

curl -fsSL https://get.n8n.io -o get-n8n.sh
sudo sh get-n8n.sh --version
sudo sh get-n8n.sh

第二行我這邊回的是 installs the latest stable n8n, currently 2.42.7。前面要不要加 sudo，看你的帳號能不能直接用 Docker，我那台不行，所以都加了。

真的開始裝之後，45 秒結束。它做了四件事：確認 Docker 有在跑，在目前的位置建一個叫 n8n 的資料夾，把設定檔寫進去，然後下載並啟動。等 n8n 真的可以用了，它才印出這一行：

n8n is running at: http://localhost:5678

打開這個網址，第一件事是建立一個擁有者帳號。我確認了網頁有回應、它也確實要求先建帳號，但我沒有往下建，所以帳號之後的畫面這篇沒有。

這行指令可以重複執行。我跑第二次，它回 Found an existing install in ./n8n — leaving it untouched，沒有動到原本的東西。

它其實一次起了五個容器

這是我裝完才注意到的。一行指令裝起來的不是只有 n8n。

五個加起來大約 700 MB，整台機器比安裝前多用了大約 1 GB。

多出來的那幾個，是為了 n8n Assistant 這個功能準備的。官方文件說它預設是關的，要你自己填一組 AI 模型的 API key 才會開。也就是說，不用 Assistant 的人，有一半的記憶體是花在用不到的東西上。

官方對這一整組的硬體要求寫得很明確：至少 2 個 vCPU、4 GB 記憶體。

硬碟的部分，五個映像檔合計 3.5 GB，加上它建的資料區 1.3 GB，再加 Docker 本身 0.5 GB，總共大約 5.4 GB。

腳本跑完會印兩條安全提醒，我照翻：只有 5678 這個連接埠可以對外；sandbox-runner 那個容器的權限很高，它的連接埠絕對不要開到網路上。最後還有一句，說這套設定是給你在本機試用的，正式上線要另外處理 HTTPS 和資料庫。

compose.yml 裡面寫了什麼

一行指令做的事，其實是幫你準備好一份 Docker Compose 的設定，再把它啟動。裝完之後，n8n 資料夾裡有三個檔：compose.yml、.env、searxng-settings.yml。

compose.yml 是整組服務的定義。腳本是從 n8n 的 GitHub 把它抓下來的。我 10 月 14 日把來源那一份抓來讀，大小是 4,322 bytes，跟我 10 月 12 日裝出來的那個檔一樣大。

裡面定義了六個服務。五個就是上面表格那五個容器。第六個叫 sandbox-certs，只在啟動時跑一下、產生憑證就結束，所以平常看不到它。

跟你的資料有關的是 n8n 這一個服務，重點在這幾行：

    image: docker.io/n8nio/n8n:${N8N_VERSION}
    ports:
      - '5678:5678' # the only port that should be internet-facing
    env_file: .env
    volumes:
      - n8n-data:/home/node/.n8n

版本號沒有寫死，是從 .env 讀的。連接埠只開 5678，後面那句註解是官方自己寫的，意思是只有這個埠可以對外。流程、帳號、連線設定都存在 n8n-data 這個資料區，容器重建也不會掉。

.env 放的是設定值：n8n 的版本、沙盒的版本，還有腳本幫你隨機產生的幾組金鑰。它的權限是只有擁有者讀得到，檔案開頭註明不要放進版本控制。

官方在 compose.yml 開頭寫了，這個檔下載之後就是你的，可以自己改。之後跑更新，它只會動 .env 裡的兩行版本號，和 compose 裡沙盒映像檔的版本。

想在第一次啟動之前就先改設定，腳本有一個 --no-start 參數：只產生這三個檔，不啟動。腳本自己的說明是，5678 已經被別的程式佔用時，就用這個參數，先去改 compose.yml 裡的連接埠再啟動。這個參數我沒有跑過。

一行指令沒有幫你設時區

讀這兩個檔的時候我注意到一件事：compose.yml 和腳本產生的 .env 裡，都沒有時區的設定。

下面單一容器的指令裡有 GENERIC_TIMEZONE 和 TZ 兩個設定。官方文件寫，不設的話預設是紐約時間。照這樣看，用一行指令裝起來的那一組，排程用的也會是紐約時間，你設每天早上九點，它會在台灣的晚上跑。

n8n 這個服務會讀 .env，所以做法是在 .env 最後加兩行，再重新啟動：

GENERIC_TIMEZONE=Asia/Taipei
TZ=Asia/Taipei

要先講清楚，把這兩行加進 .env 這個做法，是我讀設定檔推出來的，沒有在一行指令裝好的那一組上驗證過。GENERIC_TIMEZONE 這個設定本身我後來用單一容器測過，確實有效：不設的時候流程裡的時間是 -04:00，設成 Asia/Taipei 之後變成 +08:00，過程寫在 n8n 教學。加完之後，請自己建一個流程確認時間對不對。

平常會用到的指令

停掉和再開：

docker compose -f ./n8n/compose.yml down
docker compose -f ./n8n/compose.yml up -d

我實測停掉花 11 秒。再開是 7 秒，之後大約再等 8 秒 n8n 才恢復回應。

出問題要看紀錄，腳本自己在失敗訊息裡給的指令是這一行，我沒有實際用到：

docker compose -f ./n8n/compose.yml logs n8n

有一件事要留意。我停掉再開一次之後，用 docker system df 看，多了 1.28 GB 標示為「可以回收」的資料區。看起來是停掉的時候，舊的那份沒有跟著刪掉。我只試了一次，但如果每次都這樣，常常重開的話硬碟會慢慢被吃掉。清理的指令我沒有實際跑，這裡先不寫。

更新是這一行：

curl -fsSL https://get.n8n.io | sh -s -- --upgrade

移除的指令官方文件有給，是 down 後面加 -v。那個 -v 會把所有 n8n 的資料一起刪掉，流程和帳號連線都會不見。這行我沒有跑。

只想要 n8n 本體：單一容器

不需要 Assistant，或是機器比較小，可以只跑 n8n 一個容器。這就是舊教學裡最常見的那種裝法：

docker volume create n8n_data

docker run -d --name n8n \
  -p 5678:5678 \
  -e GENERIC_TIMEZONE="Asia/Taipei" \
  -e TZ="Asia/Taipei" \
  -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
  -v n8n_data:/home/node/.n8n \
  n8nio/n8n:2.42.7

第一行建一個放資料的地方，容器刪掉重建，流程也還在。-p 5678:5678 是把編輯器的連接埠開出來。兩個時區的設定要填。不填的話，官方文件寫預設是紐約時間，你設的每天早上九點會變成台灣的晚上。最後一行的版本號換成你要的版本。

映像檔已經抓好的狀態下，我這邊 5 秒就能用。啟動一分鐘後，這個容器佔 477 MB。

要提醒的是，官方文件把這一頁標成過時，並且請大家改看 Docker Compose 那一頁。它在 2.42.7 是能用的，之後的版本會不會變，我沒辦法保證。

npm 和 npx：還能用，但新裝不建議

官方文件 npm 那一頁，現在最上面寫著 3.0 起停用。一行指令那一頁講得更白：3.0 之後 n8n 只透過 Docker 發佈，已經用 npm 裝好的可以繼續用，新裝和之後的升級請改用 Docker。

目前最新的穩定版是 2.42，3.0 還沒出，所以這兩種我都還裝得起來。

npm install -g n8n 在 2 核心、4 GB 的機器上花了 2 分 50 秒。安裝過程中 npm 自己就吃掉大約 2 GB 記憶體，硬碟多了 4 GB。裝好之後 n8n start，9 秒就能開編輯器，閒置大約 0.5 GB。

npx n8n 我是在比較小的機器上試的，1 核心、2 GB。從按下去到能開編輯器，5 分 53 秒。中間記憶體被擠到只剩一百多 MB，連我查狀態的指令都卡住。而且 n8n 跑起來之後，npx 那支程序沒有離開，一直佔著 0.9 GB。

所以 npm 這條路，裝得比較慢，安裝時比較吃記憶體，而且快要停了。另外官方文件還註明，用 npm 裝的版本沒有 n8n Assistant。除非你的環境真的不能裝 Docker，不然我不會選它。

要用的話，Node.js 的版本要在 20.19 到 24 之間。

裝在自己的電腦，還是租一台主機

只是想學、想做幾條流程試試，裝在自己的電腦就好。缺點有兩個：電腦一睡眠它就停了，還有外面的服務連不進來。你的流程如果要等別的服務主動通知它，在自己的電腦上會卡住。

要它整天開著、又要能從外面連進來，就要租主機。

規格照前面的數字挑。要裝官方那一整組，照官方的要求是 2 個 vCPU、4 GB 記憶體起跳。只跑單一容器的話，我量到 0.5 GB，小一點的機器也夠。這兩種大小各家賣多少，我整理在VPS 推薦哪一家。

拿 Hostinger 當例子，它最小的 KVM 1 是 1 核心、4 GB 記憶體，跑單一容器沒問題，但核心數比官方對整組的要求少一個。上一級的 KVM 2 是 2 核心、8 GB，才符合整組的要求。它的方案頁還寫，有一個已經裝好 n8n 的主機範本可以選。這個範本我沒有用過。各種租期的實際金額，我整理在費用那篇。n8n 要選 Hostinger 哪一級方案、續約價多少，我整理在 Hostinger 評價。

主機要對外的話，還有網域和 HTTPS 要處理。一行指令的腳本自己都說了，它是給本機試用的。正式上線的做法在官方 Docker Compose 那一頁；我後來在雲端測試機上部署了一次，接上 HTTPS 網址、從台灣打 webhook，要設哪些環境變數、會遇到什麼坑，寫在 n8n 部署教學。

完全不想碰主機的人，直接用 n8n 的雲端版，有 14 天的試用。

裝好之後的第一個流程怎麼做，在 n8n 教學，流程檔可以直接匯入。

這篇沒有測到的

為了讓你知道這篇的邊界，把沒做的列在這裡。

Windows 和 Mac 上的 Docker Desktop 我沒有測，上面的數字都是 Linux 主機的。建立擁有者帳號之後的畫面和操作沒有，因為我沒有建帳號。對外的網址和 HTTPS 沒有設。更新只在已經是最新版的情況下跑過一次。清理和移除的指令沒有跑。