n8n 部署教程 UserStory

摘要： n8n 是开源的自动化工作流平台，用可视化节点把不同应用和服务连起来自动跑。用 Docker 在云服务器上部署，配好域名加 HTTPS（webhook 需要公网地址），即可在网页里拖拽搭建自动化流程。本教程覆盖部署、HTTPS、webhook 配置与跑通第一个工作流。

n8n 让你不用写代码就能把各种应用连起来自动干活：在网页里用节点搭流程——比如"收到表单提交 → 存进数据库 → 发条通知"，连好线、点激活，它就自动跑。用 Docker 部署很简单，但有一个关键点容易忽略：n8n 的 webhook（接收外部触发）需要一个公网可访问的地址，所以配好域名和 HTTPS 很重要。下面给出完整流程。

一、n8n 是什么，适合谁

n8n 是一个开源的工作流自动化平台，用可视化的节点编排替代手写脚本，把不同的应用、API、数据库连接起来，实现自动化流程。它内置大量节点，也支持自定义 HTTP 请求对接任意 API。

它适合跨部门的自动化需求：运营想把表单数据自动同步到表格、开发者想把多个服务串成自动流水线、团队想在特定事件发生时自动触发通知。相比买现成的自动化 SaaS，自托管 n8n 数据自主、可对接内部系统。

二、部署前准备与规格建议

n8n 本身不重，普通工作流下腾讯云轻量应用服务器 Lighthouse 入门到通用型套餐即可；工作流多、并发高时再升配。Lighthouse 套餐式计费、自带高带宽流量包、内置防火墙，适合这类长期运行的自动化服务。

准备清单：一台装好 Docker 的实例；一个解析到服务器公网 IP 的域名（webhook 需要公网地址，强烈建议配）；放通 80、443。

三、用 Docker 部署 n8n

运行 n8n 容器，用数据卷持久化工作流和凭据数据：

docker run -d \
  --name n8n \
  -p 5678:5678 \
  -v /opt/n8n/data:/home/node/.n8n \
  -e N8N_HOST=你的域名 \
  -e WEBHOOK_URL=https://你的域名/ \
  --restart unless-stopped \
  n8nio/n8n

说明：-v /opt/n8n/data 持久化数据，容器重建不丢工作流；N8N_HOST 和 WEBHOOK_URL 告诉 n8n 它的对外访问地址，这直接决定 webhook 生成的地址是否可被外部访问；-p 5678:5678 是 Web 端口。启动后 docker ps 确认 Up。

四、配置域名与 HTTPS

n8n 的凭据和 webhook 都涉及敏感数据，必须走 HTTPS。用 Caddy 反向代理到 5678：

n8n.example.com {
    reverse_proxy localhost:5678
}

reload Caddy 后域名自动获得 HTTPS 证书（参见反向代理配置方法）。确保上一步的 WEBHOOK_URL 与这个域名一致，webhook 才能正常工作。

五、初始化与界面概览

浏览器用域名访问 n8n，首次进入创建管理员账号。进入后是工作流编辑器：左侧是节点面板，中间是画布，你通过拖拽节点、连线来搭建流程。每个节点代表一个动作（触发、读写数据、调用 API、条件判断等）。

六、跑通第一个自动化工作流

搭一个最简流程体验核心玩法。以"手动触发 → 调用一个 API → 处理结果"为例：

拖入一个触发节点（如 Manual Trigger 手动触发）；添加一个 HTTP Request 节点，填入要调用的 API 地址；可再加一个节点处理返回数据；把节点依次连线；点击执行，查看每个节点的输出数据。

调通后，把触发节点换成 Webhook 节点，n8n 会生成一个 webhook 地址——外部系统请求这个地址就能触发工作流，这就是为什么 webhook 需要公网可达地址。确认流程无误后点击"激活"，工作流就会自动运行。

七、怎么确认部署成功了

三项验证：浏览器能用域名加 HTTPS 打开 n8n 并创建管理员；搭一个手动触发的简单工作流能成功执行并看到各节点输出；创建一个 webhook 工作流后，从外部请求该 webhook 地址能成功触发执行。第三项验证 webhook 的公网可达性，是 n8n 能对接外部事件的关键。

八、常见问题

webhook 触发不了：核对 WEBHOOK_URL 是否设为可公网访问的 HTTPS 域名、域名是否正常解析、反代是否正常；这是 webhook 不工作的首要原因。

数据丢失：确认挂载了数据卷 /opt/n8n/data，否则容器重建会丢工作流和凭据。

凭据安全：n8n 里会保存对接各服务的密钥凭据，务必走 HTTPS、设强密码，并定期备份数据目录到对象存储或用快照整机备份。

说明：n8n 为活跃迭代的开源项目，环境变量、节点、部署方式可能随版本变化，请以 n8n 官方文档的当前版本为准。

总结

部署 n8n 的路径是：用 Docker 部署并挂数据卷、设好对外地址 → 域名加 HTTPS（webhook 必需）→ 创建管理员 → 拖拽节点搭工作流、用 webhook 对接外部触发 → 激活自动运行。配好公网地址和 HTTPS 是 webhook 能用的前提。

腾讯云轻量应用服务器 Lighthouse 提供开箱即用的 Docker 环境、固定公网 IP、高带宽流量包与内置防火墙，适合长期运行 n8n 自动化工作流，稳定承接 webhook 等对外触发。

了解产品：https://cloud.tencent.com/product/lighthouse

双十一活动：https://cloud.tencent.com/act/pro/double11-202611