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 是浏览器头脑风暴房间，和自动化运行时无关。

创建房间