wbstorm

如何在本機安裝並執行 n8n：Docker 或 npm 建第一個 Webhook

Docker 或 npx 起 n8n，打開 5678 編輯器，建 Webhook 節點，用測試 URL 收到第一筆請求。

要把 HTTP 請求接到一段自動化，不必先買雲帳號。n8n 可以在本機跑：編輯器在瀏覽器裡，資料預設落在本機。

對照官方文件，用 Docker 或 npm 在本機執行 n8n，打開 localhost:5678，再建第一條 Webhook 工作流。這是開發者工具教學，不是腦力激盪產品說明書。

安裝打開編輯器Webhook

先選一條安裝路徑

文件在 docs.n8n.io/hosting/installation。本機試跑選 Docker 或 Node；生產再談 Postgres 與佇列。

5678
預設編輯器埠
2 條
官方入門安裝
Webhook
第一條工作流
方式前提適合誰
Docker本機有 Docker Engine隔離資料卷，易刪易起
npx / npmNode.js（官方寫支援的 LTS）不想裝容器，先看編輯器
n8n Cloud瀏覽器註冊不要本機行程；本文不走這條

五步跑通第一條 Webhook

  1. 1

    用 Docker 或 npm 啟動

    Docker：先 docker volume create n8n_data，再 docker run -it --rm --name n8n -p 5678:5678 -v n8n_data:/home/node/.n8n docker.n8n.io/n8nio/n8n。Node：在空目錄執行 npx n8n，或全域安裝後 n8n start。對照 docs.n8n.io 目前命令，映像標籤會變。

  2. 2

    打開編輯器並建 owner

    瀏覽器打開 http://localhost:5678。首次造訪建立 email / 密碼，這是本機 owner，不是雲訂閱。設定精靈可先跳過，直接進空白畫布。

  3. 3

    新建工作流，拖 Webhook

    左上角 New workflow。加節點選 Webhook。HTTP Method 用 POST。Path 可留隨機，或改成 hello。先不要接生產金鑰。

  4. 4

    Listen 並用 curl 打 Test URL

    在節點裡點 Listen for test event，複製 Test URL。另開終端：curl -X POST 你的測試URL -H 'Content-Type: application/json' -d '{"ping":true}'。編輯器應停 Listen 並顯示 JSON。

  5. 5

    接到 Respond，再決定是否 Activate

    Webhook 後加 Set 或 Respond to Webhook，回傳 {"ok":true}。本機聯調只用 Test URL。要給同事一個穩定地址，先儲存再 Activate，改用 Production URL。本機 5678 預設不暴露公網。

docker volume create n8n_data
docker run -it --rm --name n8n \
  -p 5678:5678 \
  -v n8n_data:/home/node/.n8n \
  docker.n8n.io/n8nio/n8n

# 或：npx n8n
# 然後打開 http://localhost:5678

編輯器裡先認這三塊

01

畫布與節點

每個節點是一步：觸發、變換、輸出。Webhook 是觸發器。右側面板改 method、path、鑑權。

02

Test URL 與 Production URL

測試地址只在 Listen 時活著。生產地址要工作流 Active。混用會看到 404 或空回應。

03

憑證與環境變數

第三方 API 放 Credentials，不要寫進節點明文。本機可用 .n8n 目錄裡的設定；勿把該目錄提交進 git。

常見坑

埠被占：改 -p 5679:5678 或停掉舊容器。Docker 裡資料要掛卷，否則 --rm 會丟掉工作流。Node 版本過舊時 npx n8n 會直接報錯，換官方支援的 LTS。

工作流跑通、要攤草圖時，回 wbstorm 用房間號即可，另見 建立或加入房間 和 白板基礎。Cursor 規則見 如何寫 Cursor Rules。

必須用 Docker 嗎？

不必。官方同時維護 npm 安裝。本機先看編輯器用 npx 更快；要可丟棄的乾淨環境用 Docker 加命名卷。

Test URL 為什麼 404？

工作流要打開，Webhook 節點要處於 Listen for test event。關掉分頁或沒點 Listen，測試地址不會收包。

和 n8n Cloud 是同一回事嗎？

編輯器類似，託管與計費不同。Cloud 不用本機埠。本文只涵蓋自託管本機。

這是 wbstorm 的功能嗎？

不是。本文只講 n8n 本機安裝與 Webhook。wbstorm 是瀏覽器腦力激盪房間，和自動化執行環境無關。

建立房間