目录

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 开始吧。

基础入门

  1. 什么是 n8n

    了解 n8n 的用途与核心概念,包括工作流、节点和触发器;比较 n8n 与 Zapier、Make 的差异,并了解云端版、自托管版本及 Sustainable Use License 的限制。

  2. 安装 n8n

    一步步在自己的电脑上安装 n8n:使用 Docker 快速启动、设置时区并保存数据,也可以用 npx / npm 直接运行,完成首次打开时的账号设置。

  3. 界面指南

    了解 n8n 界面:主页与项目、工作流编辑器、添加和连接节点、节点设置面板、测试执行、保存与发布(Publish)、执行记录,以及常用快捷键。

  4. 第一个工作流

    跟着步骤创建第一个 n8n 自动化流程:使用 Schedule Trigger 每天定时运行,通过 HTTP Request 获取天气 API 数据,使用 Edit Fields 整理数据,再发送 Email 通知,并学习测试、发布和查看执行记录。

  5. 数据结构与 items

    理解 n8n 最核心的数据概念:节点之间传递的是 items 数组,每个节点会对每条 item 执行一次。了解 JSON 与二进制数据、项目配对、拆分与合并数据,以及常见的“为什么执行了好几次”问题。

核心概念

  1. 表达式

    n8n 表达式完整教程:用 {{ }} 读取数据,了解 $json 与 $('节点名称') 的区别,处理字符串和数组、进行条件判断,以及使用日期时间(Luxon)、$now、$execution 等内置变量,并附大量实用示例。

  2. 凭证管理

    n8n 凭证教程:了解如何添加 API 密钥和 OAuth 凭证、在自托管 n8n 上设置 Google OAuth(表格、Gmail、云端硬盘)、在 HTTP Request 节点中使用凭证,以及凭证的加密和共享。

  3. 常用核心节点

    介绍 n8n 最常用的核心节点及其使用场景:HTTP Request 调用 API、Edit Fields 整理字段、If 与 Switch 条件分支、Filter、Merge 合并、Loop Over Items 分批处理、Wait 等待、Execute Workflow 子流程和定时触发器。

  4. Webhook

    使用 n8n Webhook 节点接收表单、支付平台、GitHub 等外部服务发送的数据:测试 URL 与正式 URL 的区别、HTTP 方法和路径、读取 body 与 query、验证请求、使用 Respond to Webhook 自定义响应,以及常见问题。

  5. 代码节点

    n8n Code 节点完整教程:Run Once for All Items 与 Run Once for Each Item 两种模式、读取和返回 items 的格式、常见数据处理示例、使用外部包,以及 n8n 2.x 的 Python 和安全性变更。

  6. 错误处理

    让 n8n 自动化流程更稳定:使用 Retry On Fail 自动重试、On Error 失败后继续或走错误分支、Stop and Error 主动中止,并通过 Error Trigger 建立全局错误通知工作流。

AI 自动化

  1. AI Agent 入门

    使用 n8n 的 AI Agent 节点打造 AI 助手:了解 Chat Trigger、聊天模型、记忆(Memory)、工具(Tools)的概念与连接方式,逐步创建能查天气、读取电子表格的聊天机器人,并介绍系统提示词和常见问题。

  2. 接入 Ollama 本地模型

    让 n8n 使用 Ollama 在本地运行的开源模型(Qwen、Llama、Gemma),无需 API 费用,数据不会外传。介绍连接地址设置(Docker 环境)、Ollama Chat Model 和 Embeddings 节点、模型选择及常见错误。

  3. RAG 知识库问答

    使用 n8n 构建 RAG(检索增强生成)知识库:将 Google Drive 或上传的文档切块、生成嵌入并存入向量数据库,再让 AI Agent 通过向量检索工具根据文档回答问题。介绍 Simple Vector Store、Qdrant 和 PGVector 的选择。

实战示例

  1. Google Sheets 自动化

    使用 n8n 操作 Google Sheets:配置授权、读取数据行、新增和更新数据(Append or Update)、监听新数据行,并实现“表单报名自动写入表格并发送确认邮件”的完整示例。

  2. Telegram AI 机器人

    一步步用 n8n 创建 Telegram 机器人:用 BotFather 创建 Bot、通过 Telegram Trigger 接收消息、用 AI Agent 生成回复、按用户记忆对话、限制用户,以及发送图片和按钮。

部署与运维

  1. 自托管部署

    将 n8n 部署到云主机以供正式使用:通过 Docker Compose 配置 PostgreSQL 和 Caddy 自动 HTTPS,并设置域名、Webhook URL、加密密钥、时区及安全选项。

  2. 备份与更新

    保护你的 n8n 工作流与凭据:使用 CLI 导出工作流和凭据、备份 PostgreSQL 与数据目录、迁移到新主机,以及安全更新 n8n 版本和从 1.x 升级到 2.x 的注意事项。

  3. 常见问题与故障

    n8n 常见问题汇总:Webhook URL 显示 localhost、计划时间相差 8 小时、节点重复运行、OAuth 授权失败、内存不足、执行记录占用空间、工作流未自动运行等问题的原因与解决方法。

更新于 2026年10月12日