目录
n8n 教程
n8n 是一款开源的工作流自动化工具。你可以通过拖放节点,将 Google 试算表、Gmail、Slack、Telegram、数据库、各种 API 以及 AI 模型连接起来,让重复性工作自动完成。
例如:
- 每天早上 8 点获取天气和日历信息,整理后发送到 Telegram
- 有人提交表单时,自动写入试算表、发送确认邮件并通知业务人员
- 收到客户来信时,用 AI 分类并起草回复
- 打造一个能查询公司文档、会使用工具的 AI 助手
与 Zapier、Make 等服务相比,n8n 最大的特色是可以自行托管,数据保存在自己的服务器上,执行次数也不受套餐限制。
你将学到什么
- n8n 的基本概念:工作流、节点、触发器、项目(items)
- 使用 Docker 安装 n8n,并创建第一个自动化流程
- 表达式、凭据、常用核心节点的用法
- 使用 Webhook 接收外部数据,使用代码节点处理复杂逻辑
- 错误处理与通知
- 使用 AI Agent 节点打造 AI 助手,连接本地 Ollama 模型与知识库(RAG)
- 自托管部署、备份与更新
适合哪些人
- 想将日常重复工作自动化的职场人士、市场营销、客服和运营人员
- 想快速连接各种服务,但不想从零开始编写代码的开发者
- 想打造 AI 自动化流程与 AI Agent 的人
基本操作完全不需要编写代码。进阶章节会用到一些 JavaScript。
本教程以 n8n 2.x 版为准。n8n 更新频繁,界面细节可能与你看到的略有不同。
从 什么是 n8n 开始吧。
基础入门
- 什么是 n8n
了解 n8n 的用途与核心概念,包括工作流、节点和触发器;比较 n8n 与 Zapier、Make 的差异,并了解云端版、自托管版本及 Sustainable Use License 的限制。
- 安装 n8n
一步步在自己的电脑上安装 n8n:使用 Docker 快速启动、设置时区并保存数据,也可以用 npx / npm 直接运行,完成首次打开时的账号设置。
- 界面指南
了解 n8n 界面:主页与项目、工作流编辑器、添加和连接节点、节点设置面板、测试执行、保存与发布(Publish)、执行记录,以及常用快捷键。
- 第一个工作流
跟着步骤创建第一个 n8n 自动化流程:使用 Schedule Trigger 每天定时运行,通过 HTTP Request 获取天气 API 数据,使用 Edit Fields 整理数据,再发送 Email 通知,并学习测试、发布和查看执行记录。
- 数据结构与 items
理解 n8n 最核心的数据概念:节点之间传递的是 items 数组,每个节点会对每条 item 执行一次。了解 JSON 与二进制数据、项目配对、拆分与合并数据,以及常见的“为什么执行了好几次”问题。
核心概念
- 表达式
n8n 表达式完整教程:用 {{ }} 读取数据,了解 $json 与 $('节点名称') 的区别,处理字符串和数组、进行条件判断,以及使用日期时间(Luxon)、$now、$execution 等内置变量,并附大量实用示例。
- 凭证管理
n8n 凭证教程:了解如何添加 API 密钥和 OAuth 凭证、在自托管 n8n 上设置 Google OAuth(表格、Gmail、云端硬盘)、在 HTTP Request 节点中使用凭证,以及凭证的加密和共享。
- 常用核心节点
介绍 n8n 最常用的核心节点及其使用场景:HTTP Request 调用 API、Edit Fields 整理字段、If 与 Switch 条件分支、Filter、Merge 合并、Loop Over Items 分批处理、Wait 等待、Execute Workflow 子流程和定时触发器。
- Webhook
使用 n8n Webhook 节点接收表单、支付平台、GitHub 等外部服务发送的数据:测试 URL 与正式 URL 的区别、HTTP 方法和路径、读取 body 与 query、验证请求、使用 Respond to Webhook 自定义响应,以及常见问题。
- 代码节点
n8n Code 节点完整教程:Run Once for All Items 与 Run Once for Each Item 两种模式、读取和返回 items 的格式、常见数据处理示例、使用外部包,以及 n8n 2.x 的 Python 和安全性变更。
- 错误处理
让 n8n 自动化流程更稳定:使用 Retry On Fail 自动重试、On Error 失败后继续或走错误分支、Stop and Error 主动中止,并通过 Error Trigger 建立全局错误通知工作流。
AI 自动化
- AI Agent 入门
使用 n8n 的 AI Agent 节点打造 AI 助手:了解 Chat Trigger、聊天模型、记忆(Memory)、工具(Tools)的概念与连接方式,逐步创建能查天气、读取电子表格的聊天机器人,并介绍系统提示词和常见问题。
- 接入 Ollama 本地模型
让 n8n 使用 Ollama 在本地运行的开源模型(Qwen、Llama、Gemma),无需 API 费用,数据不会外传。介绍连接地址设置(Docker 环境)、Ollama Chat Model 和 Embeddings 节点、模型选择及常见错误。
- RAG 知识库问答
使用 n8n 构建 RAG(检索增强生成)知识库:将 Google Drive 或上传的文档切块、生成嵌入并存入向量数据库,再让 AI Agent 通过向量检索工具根据文档回答问题。介绍 Simple Vector Store、Qdrant 和 PGVector 的选择。
实战示例
- Google Sheets 自动化
使用 n8n 操作 Google Sheets:配置授权、读取数据行、新增和更新数据(Append or Update)、监听新数据行,并实现“表单报名自动写入表格并发送确认邮件”的完整示例。
- Telegram AI 机器人
一步步用 n8n 创建 Telegram 机器人:用 BotFather 创建 Bot、通过 Telegram Trigger 接收消息、用 AI Agent 生成回复、按用户记忆对话、限制用户,以及发送图片和按钮。
部署与运维
- 自托管部署
将 n8n 部署到云主机以供正式使用:通过 Docker Compose 配置 PostgreSQL 和 Caddy 自动 HTTPS,并设置域名、Webhook URL、加密密钥、时区及安全选项。
- 备份与更新
保护你的 n8n 工作流与凭据:使用 CLI 导出工作流和凭据、备份 PostgreSQL 与数据目录、迁移到新主机,以及安全更新 n8n 版本和从 1.x 升级到 2.x 的注意事项。
- 常见问题与故障
n8n 常见问题汇总:Webhook URL 显示 localhost、计划时间相差 8 小时、节点重复运行、OAuth 授权失败、内存不足、执行记录占用空间、工作流未自动运行等问题的原因与解决方法。
更新于 2026年10月12日