第三方工具更新 2026.11.18

n8n 本機安裝教學:Windows Docker 設定與第一個工作流程

在 Windows 用 Docker 安裝 n8n,確認資料庫就緒,再匯入、執行與匯出帳款工作流程。附完整 JSON、實際結果與啟動排錯。

n8n 用節點串起觸發、資料轉換與外部服務,適合會重複執行、之後還要接通知或其他系統的工作。如果只算一次加總,試算表或腳本比較直接。這篇帶你在 Windows 啟動 n8n,跑出結果可核對的帳款流程,再匯出重用,先理解資料怎麼走,再考慮接 AI 模型。

用 Docker 安裝到 Windows

需要已啟動的 Docker Desktop、Linux containers 模式與 Docker Compose。尚未安裝者先依 Docker Windows 文件完成環境。本篇固定使用 n8n 2.47.7,讓指令與結果有明確對照,不表示它是最新版本。

在 PowerShell 建立新的練習資料夾:

docker version
docker compose version
mkdir invoice-automation
cd invoice-automation
mkdir n8n-data, files

建立 compose.yaml,貼入以下內容:

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n:2.47.7
    ports:
      - "127.0.0.1:${N8N_LOCAL_PORT:-5678}:5678"
    environment:
      TZ: Asia/Taipei
      GENERIC_TIMEZONE: Asia/Taipei
      N8N_DIAGNOSTICS_ENABLED: "false"
      N8N_VERSION_NOTIFICATIONS_ENABLED: "false"
      N8N_TEMPLATES_ENABLED: "false"
      N8N_RUNNERS_MODE: internal
    volumes:
      - ./n8n-data:/home/node/.n8n
      - ./files:/files

啟動服務並確認是否就緒:

docker compose up -d
docker compose ps
Invoke-RestMethod http://localhost:5678/healthz/readiness

要等這個 readiness 查詢成功回應 status: ok,才可繼續;連不上或非200回應時,等幾秒再試,不要在初始化中途停止服務。編輯器網址是 http://localhost:5678。這份設定只綁本機;n8n-data 保留資料庫與執行個體設定,重建容器後仍能使用;files 則用來在 Windows 與容器間交換流程檔。官方 Compose 文件已涵蓋更新且更大的部署組合,這裡的精簡設定則對準實測的2.47.7流程。

首次開啟編輯器會進入 owner 設定;想用圖形介面建流程,可接著看官方第一個工作流程教學。下面提供能直接核對結果的完整 CLI 路線,不必先完成 owner 設定。

先停止常駐服務。接下來三個用途都用同一份本機資料,執行這些一次性 CLI 命令時保持服務停止:

docker compose stop n8n

第一個工作流程:已付款帳款合計 200

n8n 在節點之間傳遞的是 item,每筆資料放在 json 物件。第一個 Code 節點提供三張發票,第二個篩選已付款資料並加總。這樣能驗證結果對不對,不只是看到命令結束。

將以下完整 JSON 存成 files/paid-invoices.json:

{
  "id": "PaidInvoiceReport",
  "name": "PaidInvoiceReport",
  "active": false,
  "nodes": [
    {
      "id": "start",
      "name": "When clicking Execute",
      "type": "n8n-nodes-base.manualTrigger",
      "typeVersion": 1,
      "position": [
        0,
        0
      ],
      "parameters": {}
    },
    {
      "id": "data",
      "name": "Sample invoices",
      "type": "n8n-nodes-base.code",
      "typeVersion": 2,
      "position": [
        220,
        0
      ],
      "parameters": {
        "jsCode": "return [{json:{invoice:\"A\",amount:120,status:\"paid\"}},{json:{invoice:\"B\",amount:80,status:\"paid\"}},{json:{invoice:\"C\",amount:50,status:\"open\"}}];"
      }
    },
    {
      "id": "report",
      "name": "Invoice report",
      "type": "n8n-nodes-base.code",
      "typeVersion": 2,
      "position": [
        440,
        0
      ],
      "parameters": {
        "jsCode": "const paid=$input.all().filter(x=>x.json.status===\"paid\"); return [{json:{count:paid.length,total:paid.reduce((n,x)=>n+x.json.amount,0)}}];"
      }
    }
  ],
  "connections": {
    "When clicking Execute": {
      "main": [
        [
          {
            "node": "Sample invoices",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Sample invoices": {
      "main": [
        [
          {
            "node": "Invoice report",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  },
  "settings": {
    "executionOrder": "v1"
  }
}

三個實際用途

1. 產生已付款摘要

先匯入,再執行:

docker compose run --rm --no-deps n8n import:workflow --input=/files/paid-invoices.json
docker compose run --rm --no-deps n8n execute --id=PaidInvoiceReport --rawOutput
$LASTEXITCODE

匯入應成功;執行輸出中,最後的 Invoice report 節點應有 {"count":2,"total":200},退出碼為 0。A=120、B=80 已付款,C=50 尚未付款,所以不計入總額。啟動訊息可能出現在 JSON 前面;--rawOutput 不代表整段終端輸出都能直接當成純 JSON 解析。

2. 列出待追蹤的未付款項目

把 files/paid-invoices.json 複製為 files/open-invoices.json。將最外層 id、name 都改成 OpenInvoiceReport,只把 Invoice report 節點的 jsCode 改成:

return $input.all().filter(x => x.json.status === "open");
docker compose run --rm --no-deps n8n import:workflow --input=/files/open-invoices.json
docker compose run --rm --no-deps n8n execute --id=OpenInvoiceReport --rawOutput

最後應只有一筆:發票 C、金額 50、狀態 open。使用不同工作流程 ID,已付款摘要也能保留。之後要接催款通知時,可把這個篩選放在通知節點前面。

3. 匯出可重用的工作流程

docker compose run --rm --no-deps n8n export:workflow --id=PaidInvoiceReport --output=/files/paid-invoices-export.json

在 Windows 開啟 files/paid-invoices-export.json,應有一個工作流程、三個節點與原本的報表程式。改流程前先留一份匯出檔,方便比對修改或匯入其他相容的執行個體。它不等於整台 n8n 的完整備份,沒有涵蓋資料庫、憑證與加密所需資料。

做完後可用 docker compose up -d 重新啟動編輯器。再次對同一資料夾執行 CLI 前,先 docker compose stop n8n。

若用 Codex 維護流程,可貼:「讀取 paid-invoices.json,解釋為什麼排除發票 C。在服務停止時執行匯入與執行指令,核對 count=2、total=200。」n8n 本身獨立運作;AI 程式工具可透過工作流程 JSON 與 CLI 協作,不需要為這個用途另設 n8n MCP。

常見錯誤與解法

Health 查詢成功,匯入卻出現資料庫遷移錯誤

用 /healthz/readiness,不要只看 /healthz。一次全新 Windows 重跑中,liveness 先回 OK,但資料庫尚未完成遷移;立刻停止後,匯入出現 Column "description" was not found in table "agents"。官方監控文件有區分程序存活與資料庫就緒。若是可拋棄的新練習環境,保留失敗資料夾,在新資料夾重做並等到 readiness;不要刪除或重設既有執行個體的資料。

npm 取得套件逾時,或 Docker 連不上

我們先走 npm 時遇到下載逾時,改用固定的官方 Docker 映像後完成工作流程,也避開主機 Node 環境差異。如果 docker version 無法連到 server,先啟動 Docker Desktop,等待 Linux engine 就緒再重試。映像下載失敗則應查網路或 registry,不是改工作流程程式。

找不到指定的 workflow id

我們用 MissingInvoiceReport 重現 The workflow with the id ... does not exist。先確認匯入成功,執行時填工作流程最外層 id,不是節點 ID 或檔名。兩個命令也要使用相同的 n8n-data;匯入另一個執行個體,不會讓這裡自動多出流程。

Code 節點格式不對,或執行時拋錯

回傳 [{json:{total:200}}] 這種 item 陣列,不要只回傳一個數字。本例使用 Code 預設的全部項目模式,以 $input.all() 彙整資料,詳見 Code 節點文件。另一個負面測試中,我們刻意拋出錯誤,得到 Invoice amount must be a positive number [line 1]。這是我們寫的錯誤訊息,不是 n8n 內建發票檢查;處理真實資料仍要自己加上型別與金額驗證。

5678 埠被占用,或看到 Python 警告

埠被占用時,設 $env:N8N_LOCAL_PORT='5679',重新執行 docker compose up -d,瀏覽器改開 5679;容器內仍使用 5678。我們的 JavaScript 流程在出現選用內部 Python runner 缺少 Python 3 警告時仍成功執行。要跑 Python 節點,須另外設定支援 Python 的 runner,只在 Windows 主機裝 Python 不會把它裝進容器。

費用、授權與適用限制

n8n 自架社群功能依 Sustainable Use License提供,可用於個人與企業內部需求,但對部分販售 n8n 存取服務的方式有限制,不是 MIT 授權。企業功能、代管服務與串接的外部 API 可能另計費;Docker Desktop 也有自己的授權條件。

電腦休眠後,排程就無法持續運作;外部服務也不能直接打進 localhost webhook。需要全天候自動化時,依官方部署文件規劃安全、存取與備份,別把這個練習執行個體直接開放到網際網路。

若主要需求是以程式碼控制代理狀態,可看 LangGraph;若只需要把文件轉成文字,再交給後續處理,可以先用 MarkItDown,不一定需要整套流程平台。

FAQ

n8n 如何安裝在 Windows 本機?

啟動 Docker Desktop 的 Linux containers,存好上面的 Compose 設定後執行 docker compose up -d。確認 health endpoint 回應,再開啟 http://localhost:5678。掛載的資料夾會保留執行個體資料,重建容器後仍可使用。

n8n 應該用 Docker 還是 npm 安裝?

Docker 將 n8n 執行環境和主機 Node 分開,我們在 npm 下載逾時後改走這條路完成測試。本篇固定使用 2.47.7 映像,所有指令都依 Docker 路線。安裝其他版本時,先看該版當前文件,不要把不同版本的 npm 與 Docker 步驟混在一起。

n8n 本地部署是免費的嗎?

社群版在 Sustainable Use License 允許的範圍內,不需要 n8n 訂閱。這不包含外部模型 API、主機或企業功能的費用。組織使用 Docker Desktop 時,也應確認它的授權條件。

n8n 本機能跑 AI 工作流程嗎?

可以串接模型與其他服務,但 n8n 跑在本機,不代表模型也在本機。憑證、資料傳送與推論費用取決於所選 provider。建議先跑通這種結果可核對的資料流程,再依官方整合文件接上模型。

我們測了什麼

團隊於 2026-11-16 透過 Windows 上的 Codex,呼叫真正的 n8n 2.47.7 Linux Docker 映像匯入、執行與匯出工作流程。 核對已付合計200/兩筆、未付一筆、匯出保留節點及刻意錯誤;另重跑本文 Compose 啟動與 health 檢查。 使用合成發票與 JavaScript Code 節點;未測 Windows 原生 npm 執行、編輯器帳號設定、Python 與 AI 模型。 官方 Docker、CLI 與 Code 節點文件查閱日為 2026-11-16。

訂閱 AI 工具精選與使用建議

有值得推薦的新工具、實測發現或重要更新時,寄到你的信箱。

訂閱後先寄給你一份每月更新的 AI 工具與 Skill 清單。有值得推薦的工具、實測發現或重要更新時才寄信,隨時可以退訂。隱私權說明

快完成了,請到信箱收確認信點信裡的按鈕確認訂閱,就會收到工具清單的下載連結。沒看到的話,看一下垃圾郵件或「促銷內容」分頁。

看過去幾期

也可以在這些平台追蹤: