n8n 快速入门

一句话卖点:开源、可自托管、400+ 集成的可视化工作流,自动化圈的事实标准之一。

这是什么?适合谁?

n8n(读作「n-eight-n」)是一款开源的工作流自动化平台,主域名 n8n.io,采用「Sustainable Use License」协议(对个人和小公司免费,商业用途需付费 License,具体看官方条款)。它在自动化赛道跟 Make、Zapier、Activepieces 是同梯队,但 n8n 的核心标签是开源 + 自托管 + 高度可定制。

主要特点:

• 400+ 集成:覆盖大多数 SaaS(GitHub、Slack、Notion、Stripe、Telegram、Discord、Postgres 等);
• 可视化节点编辑:拖拽节点连成流程,每个节点是一个步骤;
• Code 节点:可以在流程里写 JavaScript / Python,做复杂数据处理;
• AI 节点:内置 OpenAI / Anthropic / Hugging Face / Ollama 集成,流程里直接跑 AI;
• 自托管:用 Docker 一行命令部署,数据完全在自己手里;
• SaaS 版:不想自己运维也可以用官方 n8n.cloud;
• 公平开源许可:核心代码可见、可改,Self-hosted 永久免费。

适合谁?开发者(用 Code 节点写复杂逻辑)、DevOps(自托管,数据合规)、小企业 / 创业团队(成本敏感)、需要对接私有系统 / 内部 API 的企业、自动化爱好者。

不适合完全不想碰命令行的纯运营人员——n8n 学习曲线比 Make 略陡。

准备工作

1. 一个邮箱(用 SaaS 版)或一台能跑 Docker 的服务器(自托管);
2. 想自动化的应用账号;
3. 基本的命令行 / Docker 知识(自托管时需要);
4. 一个明确的自动化场景。

3 步快速上手

第 1 步:启动 n8n

SaaS 版:访问 https://n8n.io,点「Start Free」注册,登录后直接进入工作台。

自托管版(推荐,数据自己掌控):

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

启动后浏览器访问 http://localhost:5678,首次会让你创建 owner 账号。

第 2 步:新建 Workflow,加第一个节点

点「New Workflow」,进入可视化编辑器。

左侧「Nodes」面板搜 Webhook,拖一个 Webhook 节点到画布。Webhook 节点会生成一个 URL(如 http://localhost:5678/webhook/xxx),任何 POST 请求到这个 URL 都会触发流程。

接着拖第二个节点 Set,用于设置变量;再拖第三个节点 HTTP Request,用于发请求到外部 API。

最简单的流程:Webhook 收到 POST → Set 一个变量 → HTTP Request 把变量发给外部 URL。

第 3 步:测试 + 启用

点底部「Execute Workflow」测试一次。在另一个终端:

curl -X POST http://localhost:5678/webhook/xxx \
  -H "Content-Type: application/json" \
  -d '{"name":"hello"}'

回到 n8n,会看到每个节点的执行结果。

确认 OK 后,把 Workflow 右上方开关切到「Active」,n8n 会持续监听这个 Webhook,真实请求来时自动跑流程。

常见踩坑

1. 自托管 Webhook 收不到请求:Webhook URL 是 localhost 时,外部网络访问不到,要么用内网穿透(ngrok / frp),要么部署到公网服务器;
2. OAuth 授权失败:部分应用(Google、Slack)需要严格配置 scope,授权时仔细选;
3. Code 节点报错:JS / Python 写错语法时,错误信息藏在 execution log 里,点节点查看;
4. 超时:HTTP Request 默认 30 秒超时,长任务调 timeout 参数;
5. 数据格式问题:Webhook 收到的可能是 string 或 object,在 Set 节点用表达式转换;
6. 自托管备份:数据库在 ~/.n8n/ 目录,定期备份,丢数据很麻烦。

初级用法

• Webhook 转发:收到 Webhook → 转发到 Slack / 飞书;
• 定时任务:用 Schedule Trigger 节点,每天 9 点跑一次;
• RSS 自动汇总:RSS 节点 → OpenAI 节点(总结) → Telegram 节点(发送);
• 表单自动入库:Typeform / Tally 提交 → 自动存 Postgres / Airtable。

高级玩法

• AI Agent 流程:Webhook → OpenAI 节点 → Postgres(存对话历史)→ HTTP(回调);
• 复杂分支:用 Switch 节点做条件分支,Loop 节点做迭代;
• 错误处理:每个节点可以配置「On Error」,失败时发告警;
• Sub-workflow:把常用流程做成子工作流,主流程调用;
• 自定义节点:用 npm 包写自定义节点,扩展 n8n 能力。

小技巧

1. 用 Expression 调字段:节点之间传数据用 {{$node["Webhook"].json["body"]["name"]}} 这种表达式;
2. 每个节点单独测试:右键节点 → 「Execute Node」,不用每次跑全流程;
3. 保存 credentials 到文件:自托管时把 OAuth credential 备份,迁移时直接复用;
4. 钉钉 / 飞书机器人:用 HTTP Request 节点调 webhook,代替官方节点缺失的情况;
5. 生产环境用 Postgres:默认 SQLite 适合个人,生产换 Postgres,稳定性和并发更好。

常见问题 FAQ

Q1: n8n 是免费的吗？

A: 自托管 Community 版完全免费，无执行次数限制、无工作流数量限制，只需自己准备服务器（VPS 约 $5-20/月）。Cloud 托管版 Starter $24/月（2,500 次执行）、Pro $60/月（10,000 次执行）、Enterprise 为定制价格。自托管版适合有运维能力的开发者，Cloud 版适合不想管服务器的用户。

Q2: n8n 和 Make、Zapier 有什么区别？

A: n8n 的核心优势是开源+可自托管：数据完全在自己手里，无执行次数限制。Make 的可视化体验更友好、学习曲线更平；Zapier 集成数量最多但最贵。有运维能力的团队推荐 n8n，个人用户推荐 Make。

Q3: n8n 自托管需要什么配置？

A: Docker 一行命令即可部署。最低配置 1 核 CPU、1GB 内存可跑，生产环境建议 2 核 4GB+。默认使用 SQLite，生产环境建议切换 PostgreSQL。国内服务器部署时，部分境外 API 调用可能需代理。

Q4: n8n 支持 AI 工作流吗？

A: 支持。n8n 内置 OpenAI、Anthropic、Google AI、Ollama 等 AI 节点，可以在工作流中直接调用大模型做文本生成、总结、分类、图片分析等。也可以结合 Code 节点自定义 AI 处理逻辑，构建 AI Agent 流程。

Q5: n8n 的”公平开源许可”是什么意思？

A: n8n 采用 Sustainable Use License，核心代码可见可改。个人和小公司可以免费自托管使用；商业用途（大型企业）需要购买 License。具体条款请查阅 n8n 官方许可页面。

进阶学习建议

如果想进一步用好 n8n,建议按以下路径学习:

第 1 周:熟练基础

• 完成 3 步快速上手,跑通第一个任务
• 试 2-3 个不同场景的真实任务
• 记录”哪些操作有效、哪些没用”——形成自己的笔记

第 2 周:探索功能

• 把界面上的按钮/菜单都点一遍
• 找到最常用的 3-5 个功能
• 配置个性化设置(主题、快捷键、默认参数)

第 3-4 周:融入工作流

• 找到 n8n 与你现有工具的结合点
• 用快捷键/模板/批处理提高效率
• 考虑付费升级(如果免费版够用就不必)

长期:进阶玩法

• 探索 n8n 的 API/SDK 集成
• 写自己的脚本/扩展/插件
• 关注官方博客/更新日志,第一时间用上新功能

推荐资源:

• 官方文档:https://n8n.io
• 官方 YouTube/B 站频道(看产品演示)
• 国内社区:CSDN/掘金/知乎搜 “n8n 教程”
• 国外社区:Reddit、Product Hunt 评论区

避免的坑:

• 不要追求”全能工具”——n8n 不可能满足所有需求
• 不要盲目订阅付费版——先用免费版验证价值
• 不要忽略数据备份——重要内容定期导出
• 不要被新功能冲昏头脑——核心功能用熟再拓展

参考链接

• n8n 官方主页:https://n8n.io
• n8n 文档:https://docs.n8n.io
• n8n GitHub:https://github.com/n8n-io/n8n
• n8n 节点市场:https://n8n.io/integrations
• Make 对比:https://www.make.com

本文基于官方文档和公开资料整理，AI辅助生成，MagicNetWorld 尚未完成独立实测。如有错误或过时信息，请通过 contact@magicnetworld.com 反馈。