目錄
安裝 n8n：用 Docker、npx 或 Docker Compose
n8n 有幾種安裝方式，最推薦用 Docker：環境乾淨、升級方便，和正式部署的方式也一致。
方法一：Docker（推薦）
先安裝 Docker（Windows、macOS 請安裝 Docker Desktop，見 安裝 Docker）。
建立一個 Volume 保存 n8n 的資料：
docker volume create n8n_data啟動 n8n：
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 \
--restart unless-stopped \
n8nio/n8n打開瀏覽器到 http://localhost:5678。
| 參數 | 說明 |
|---|---|
-p 5678:5678 | n8n 預設使用 5678 連接埠 |
GENERIC_TIMEZONE | 排程節點使用的時區，一定要設，否則排程時間會差 8 小時 |
TZ | 容器系統時區 |
-v n8n_data:/home/node/.n8n | 保存工作流程、憑證、加密金鑰 |
n8n_dataVolume 千萬不要刪除。 裡面除了資料庫，還有用來加密憑證的金鑰。金鑰遺失，所有已儲存的憑證都將無法解密。
查看日誌：
docker logs -f n8n方法二：Docker Compose
更推薦的做法是把設定寫成檔案，方便日後修改與升級。建立資料夾 n8n，新增 compose.yaml：
services:
n8n:
image: n8nio/n8n
ports:
- "5678:5678"
environment:
GENERIC_TIMEZONE: Asia/Taipei
TZ: Asia/Taipei
N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS: "true"
volumes:
- n8n_data:/home/node/.n8n
restart: unless-stopped
volumes:
n8n_data:docker compose up -d要部署到伺服器、使用 PostgreSQL 和 HTTPS，請看 自架部署。
方法三：npx / npm
電腦已經安裝 Node.js（請使用 n8n 官方文件指定的版本）時，可以直接執行：
npx n8n或全域安裝：
npm install -g n8n
n8n start資料會存在使用者資料夾下的 .n8n 中。這種方式適合快速試用，長期使用仍建議 Docker。
第一次開啟
- 打開
http://localhost:5678。 - 建立擁有者帳號（Owner account）：輸入 Email、姓名、密碼。這個帳號只存在你的 n8n 中，不會傳到 n8n 官方。
- 可以選擇填寫問卷，或直接略過。
- n8n 可能會提供免費啟用部分付費功能的授權金鑰（需要輸入 Email 取得），可依需要決定。
完成後就會進入主畫面。
確認版本
docker exec n8n n8n --version常見問題
打開後顯示「secure cookie」相關錯誤
用 http:// 從其他電腦（非 localhost）連線時，瀏覽器會因為不是 HTTPS 而無法設定安全 Cookie。正式使用請設定 HTTPS（見 自架部署）。只在內網測試時，可以暫時加上環境變數 N8N_SECURE_COOKIE=false。
排程時間不對
沒有設定 GENERIC_TIMEZONE。也可以在每個工作流程的設定中個別指定時區。
連接埠被佔用
把 -p 5678:5678 改成 -p 5679:5678，然後連到 http://localhost:5679。
更新於 2026年10月12日