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,两者共存。 青龙的本质是"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 只监听回环,别裸奔公网。

第一个工作流:定时抓取并发飞书通知
目标:每天早上 9 点抓一个 API 的数据,把结果推到飞书群。 新建工作流,拖三个节点连线:
- Schedule Trigger:选 Every Day,Trigger at Hour 填 9。注意这个时间按
GENERIC_TIMEZONE解释,配了 Asia/Shanghai 才是北京时间 9 点; - HTTP Request:Method 填 GET,URL 填目标 API 地址;
- 飞书节点或 HTTP Request:用飞书的自定义机器人 Webhook 地址,Body 里用表达式引用上个节点的字段,比如
{{ $json.title }}。
点右上角 Execute Workflow 手动跑一次,每个节点上会出现绿色标记和本次执行的数据快照——点开节点能看到输入和输出长什么样,这是 n8n 调试最省心的地方。确认无误后点 Activate,工作流进入后台调度。

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 再做分发。

凭据怎么管理?数据放在哪?
n8n 有独立的凭据(Credentials)体系:API key、Token 存在凭据库里,节点里只引用名字,不出现明文。 左侧 Credentials 页新建,比如飞书机器人、各类 API 的 key 都建在这里;节点配置时下拉选择即可。凭据落库时用加密密钥加密——加密密钥默认随机生成存在数据卷里,换机器迁移时必须带上 N8N_ENCRYPTION_KEY,否则凭据解不开,这是迁移时最容易丢的东西。
数据持久化清单:
| 内容 | 位置 |
|---|---|
| 工作流、执行历史 | SQLite(默认,在卷里) |
| 凭据 | 同上,加密存储 |
| 加密密钥 | 卷内配置文件,或用环境变量显式指定 |
任务量大了以后建议把数据库换成 Postgres(加 DB_TYPE=postgresdb 等一组环境变量),Compose 多服务编排 的写法直接套用。

三个真会踩的坑
- WEBHOOK_URL 没配,外网回调 404:我一开始以为只要反代配好了,Webhook 自然能用,后来发现 n8n 生成的回调地址用的是
WEBHOOK_URL这个环境变量——不配的话它默认拿容器内部主机名拼地址,外部访问必然 404。正确姿势:WEBHOOK_URL=https://n8n.example.com/,结尾带斜杠,和反代域名一字不差。已经配错了的话,改完环境变量还要把工作流重新 Activate 一次才刷新。 - 时区不是北京时间:只配
TZ不够,工作流调度看的是GENERIC_TIMEZONE。两个都配成 Asia/Shanghai 才稳。症状很典型:Schedule Trigger 设的 9 点,实际北京时间下午 5 点触发——正好差 8 小时,就是 UTC。 - 测试 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 之后,工作流本身也有版本和回滚。