n8n 自建自动化工作流:Docker 部署、定时触发与 Webhook 实战(2026)

n8n 社区版用一条 docker compose up -d 就能在自己的服务器上跑起来,拖拽式编排工作流、自带 400 多个节点连接器,定时任务、Webhook 回调、跨服务串联都能做——但 WEBHOOK_URL 和 GENERIC_TIMEZONE 这两个环境变量不配好,部署完必然踩两个坑:外网回调 404、定时任务按 UTC 跑。 我在 Ubuntu 22.04 + Docker 27 上部署了 n8n 1.x 社区版实测,从零到第一个工作流跑通大约 30 分钟。它和青龙面板不是替代关系,而是分工关系,文末会说怎么分。

这篇按顺序给:为什么选 n8n、compose 部署、第一个定时工作流、Webhook 对外接口、凭据管理,最后是排错。

n8n 自建工作流的整体结构

为什么选 n8n 而不是青龙?

结论:脚本型定时任务用青龙,流程编排和跨服务自动化用 n8n,两者共存。 青龙的本质是"cron + 脚本运行时",你得自己写代码;n8n 的本质是可视化流程引擎,逻辑用节点连线表达,改流程不用改代码。放一张对比:

维度 n8n 社区版 青龙面板
上手方式 拖拽节点,不写代码 写 JS/Python 脚本
触发方式 定时、Webhook、队列等多种 cron 定时为主
外部服务对接 400+ 内置节点 自己封装请求
执行历史 每次执行的数据快照可查 文本日志
适合场景 跨服务自动化、对外接口 签到、薅羊毛类脚本

判断标准很简单:要对接的服务在 n8n 节点列表里有现成的,就用 n8n;要跑一段自定义逻辑的脚本,就用青龙。 我的机器上两个都跑着,签到类归青龙,数据同步和通知编排归 n8n。

怎么用 Docker Compose 部署?

# Ubuntu 22.04,Docker 27,docker compose v2
$ mkdir -p /opt/n8n && cd /opt/n8n

docker-compose.yml 这样写:

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n:latest
    container_name: n8n
    restart: always
    ports:
      - "5678:5678"
    environment:
      - N8N_HOST=n8n.example.com
      - WEBHOOK_URL=https://n8n.example.com/
      - GENERIC_TIMEZONE=Asia/Shanghai
      - TZ=Asia/Shanghai
    volumes:
      - n8n_data:/home/node/.n8n
volumes:
  n8n_data:

四个环境变量各有用途:N8N_HOST 是界面里生成回调地址用的主机名;WEBHOOK_URL 是外部访问你的完整基础地址,反代之后必须和真实域名一致;GENERIC_TIMEZONE 管工作流调度的时区;TZ 管容器系统时间。数据全部落在 n8n_data 卷里,备份这个卷就等于备份全部工作流和凭据。

启动并验证:

$ docker compose up -d
$ docker compose logs -f n8n     # 看到 "Editor is now accessible" 即成功

浏览器打开 http://服务器IP:5678,首次访问注册本地管理员账号(账号数据存在你自己的库里,不走官方)。生产环境建议按 Nginx 反代加证书 的做法挂到域名下,再用 127.0.0.1:5678:5678 只监听回环,别裸奔公网。

步骤 1:编写 compose 并启动

第一个工作流:定时抓取并发飞书通知

目标:每天早上 9 点抓一个 API 的数据,把结果推到飞书群。 新建工作流,拖三个节点连线:

  1. Schedule Trigger:选 Every Day,Trigger at Hour 填 9。注意这个时间按 GENERIC_TIMEZONE 解释,配了 Asia/Shanghai 才是北京时间 9 点;
  2. HTTP Request:Method 填 GET,URL 填目标 API 地址;
  3. 飞书节点或 HTTP Request:用飞书的自定义机器人 Webhook 地址,Body 里用表达式引用上个节点的字段,比如 {{ $json.title }}。

点右上角 Execute Workflow 手动跑一次,每个节点上会出现绿色标记和本次执行的数据快照——点开节点能看到输入和输出长什么样,这是 n8n 调试最省心的地方。确认无误后点 Activate,工作流进入后台调度。

步骤 2:编排第一个工作流

Webhook Trigger 怎么让外部系统调用你?

n8n 不只能定时跑,还能当一个轻量接口服务:Webhook Trigger 节点会生成一个 URL,外部一请求,工作流就执行。 典型用途:监控告警回调、表单提交入库、CI 完成后触发通知。

新建工作流,第一个节点选 Webhook,HTTP Method 选 POST,路径填 alert。保存后节点上会显示两个 URL:Test URL 和 Production URL——前者只在点 Listen for test event 时有效,后者要工作流 Activate 之后才生效,这是新手最容易混淆的一点。

# 外部模拟一次调用(生产 URL,路径前缀是 /webhook/)
$ curl -X POST https://n8n.example.com/webhook/alert \
    -H "Content-Type: application/json" \
    -d '{"title":"CPU 过高","value":"95%"}'

后面接飞书节点把 {{ $json.body.title }} 推出去,一个告警通道就搭好了。同样的思路可以接 Uptime-Kuma 的告警,让监控事件直接流进 n8n 再做分发。

步骤 3:配置 Webhook 触发器

凭据怎么管理?数据放在哪?

n8n 有独立的凭据(Credentials)体系:API key、Token 存在凭据库里,节点里只引用名字,不出现明文。 左侧 Credentials 页新建,比如飞书机器人、各类 API 的 key 都建在这里;节点配置时下拉选择即可。凭据落库时用加密密钥加密——加密密钥默认随机生成存在数据卷里,换机器迁移时必须带上 N8N_ENCRYPTION_KEY,否则凭据解不开,这是迁移时最容易丢的东西。

数据持久化清单:

内容 位置
工作流、执行历史 SQLite(默认,在卷里)
凭据 同上,加密存储
加密密钥 卷内配置文件,或用环境变量显式指定

任务量大了以后建议把数据库换成 Postgres(加 DB_TYPE=postgresdb 等一组环境变量),Compose 多服务编排 的写法直接套用。

步骤 4:管理凭据与数据持久化

三个真会踩的坑

  1. WEBHOOK_URL 没配,外网回调 404:我一开始以为只要反代配好了,Webhook 自然能用,后来发现 n8n 生成的回调地址用的是 WEBHOOK_URL 这个环境变量——不配的话它默认拿容器内部主机名拼地址,外部访问必然 404。正确姿势:WEBHOOK_URL=https://n8n.example.com/,结尾带斜杠,和反代域名一字不差。已经配错了的话,改完环境变量还要把工作流重新 Activate 一次才刷新。
  2. 时区不是北京时间:只配 TZ 不够,工作流调度看的是 GENERIC_TIMEZONE。两个都配成 Asia/Shanghai 才稳。症状很典型:Schedule Trigger 设的 9 点,实际北京时间下午 5 点触发——正好差 8 小时,就是 UTC。
  3. 测试 URL 和生产 URL 搞混:拿 Test URL 在生产环境里调,curl 一直挂着没响应,其实是因为没点 "Listen for test event"。生产调用一律用 /webhook/ 前缀的生产 URL,并确认工作流是 Active 状态。

常见问题(2026)

Q:社区版免费, limits 在哪?
A:n8n 社区版(Sustainable Use License)自用免费,没有工作流数量和执行次数的硬限制,高级功能(SSO、多环境、外部密钥存储)在企业版。个人和中小团队自建,社区版够用。

Q:SQLite 够用吗?什么时候换 Postgres?
A:每天几十上百次执行,SQLite 完全够。执行历史堆积很快或者多人协作时换 Postgres,迁移时老卷里的 SQLite 文件用 n8n 自带的导出命令搬。

Q:升级 n8n 版本要注意什么?
A:docker compose pull && docker compose up -d 即可,数据在卷里不丢。升级前把 N8N_ENCRYPTION_KEY 备份好,并看一眼官方的 breaking changes——大版本之间偶有节点字段改名。

一句总结

n8n 自建的完整链路是:compose 起服务、配对两个时区变量和 WEBHOOK_URL、凭据进 Credentials 库、数据卷定期备份。做完这四件事,它就是一个长期可靠的自动化中台;漏掉任何一件,症状都会在几天内的某个深夜找上门。

运维侧最后补两句:n8n 的凭据都存在 postgres volume 里,备份策略是每周 docker run --rm -v n8n_data:/data alpine tar czf - /data/.n8n 打包丢进 MinIO,恢复就是反向解包;升级走 docker compose pull && up -d,大版本升级前先看 changelog,1.x 时代有过节点改名导致工作流断掉的先例。工作流 JSON 也可以定期导出,进了 git 之后,工作流本身也有版本和回滚。

常见问题

相关阅读

上一篇 接口从 80ms 涨到 4 秒的那天下午:一次 MySQL 慢查询完整排查记录(2026)