n8n自动化工作流教程：从零搭建智能工作流

在数字化转型的浪潮中，重复性事务消耗了大量时间与精力。n8n作为一款开源、低代码的工作流自动化工具，通过直观的节点拖拽和可视化编排，将分散的应用与服务串联成自动化流程，帮助用户把精力从重复劳动中释放出来。本文将全面讲解 n8n自动化工作流教程，涵盖核心概念、安装部署、节点详解、AI智能体集成以及完整实战案例，助你快速掌握这一强大的自动化工具。

一、n8n是什么

1.1 定义与核心定位

n8n是“nodemation”的缩写，一款开源的低代码自动化工作流工具。它通过可视化的节点设计来连接不同的应用程序和服务，就像一条数字装配线——每个节点代表流程中的一个步骤。用户无需深入编程，只需拖拽配置节点，即可创建复杂的自动化流程。

n8n的核心定位是连接各类应用与API以创建工作流，将那些需要人来回倒腾数据、点按钮、发通知、调API的场景，全部交给n8n在后台自动运行。截至2026年，官方维护400多个核心节点，社区贡献节点达1800多个，覆盖了绝大多数主流应用和服务。

1.2 n8n vs 主流自动化工具对比

n8n最大的差异化优势在于：开源可自托管，数据完全自主可控，同时以极低的成本提供了媲美商业工具的自动化能力。

1.3 典型应用场景

• 数据同步：在不同系统间自动同步数据（如CRM→数据库→报表工具）
• 邮件自动化：自动处理Gmail邮件，提取关键信息存入电子表格
• 服务器监控告警：通过Webhook接收监控数据，自动判断并推送Telegram告警
• AI模型集成：将大语言模型嵌入业务流程，实现智能问答、内容生成
• 社交媒体运营：自动发布内容、收集互动数据
• ERP与RPA整合：串联ERP内部审批与外部系统

二、安装与部署

2.1 方式一：n8n Cloud（推荐新手）

对于初次接触的用户，最快捷的方式是直接使用n8n Cloud：

1. 访问 n8n.io/cloud 注册账户
2. 注册后即可获得免费试用额度
3. 登录后直接进入工作流画布，无需任何配置

2.2 方式二：Docker部署（推荐自托管）

Docker是部署n8n最推荐的方式：

使用docker run快速启动：

# 创建数据卷
docker volume create n8n_data

# 运行容器
docker run -d \
  --name n8n \
  -p 5678:5678 \
  -v n8n_data:/home/node/.n8n \
  n8nio/n8n:latest

使用docker-compose部署（生产推荐） ：

创建docker-compose.yml文件：

services:
  n8n:
    image: docker.n8n.io/n8nio/n8n:latest
    restart: always
    ports:
      - "5678:5678"
    environment:
      - N8N_HOST=localhost
      - N8N_PORT=5678
      - N8N_PROTOCOL=http
      - NODE_ENV=production
      - GENERIC_TIMEZONE=Asia/Shanghai
      - TZ=Asia/Shanghai
    volumes:
      - n8n_data:/home/node/.n8n

volumes:
  n8n_data:

启动命令：

docker compose up -d

启动后，通过浏览器访问 http://localhost:5678 即可打开n8n界面。

2.3 方式三：npm安装

在本地Node.js环境中直接运行：

# 安装Node.js后，使用npx直接运行
npx n8n

运行后访问 http://localhost:5678 即可。

2.4 关键配置说明

三、核心概念与界面认知

3.1 工作流（Workflow）

工作流是n8n中的核心概念，是一系列节点连接而成的自动化流程。数据从触发节点开始，依次流经各个节点，每个节点接收数据、处理数据，并将结果传递给下一个节点。用户在工作流画布上通过拖拽和连线完成流程编排。

3.2 节点（Node）

节点是工作流的基本构建块，每个节点代表流程中的一个步骤。节点主要分为三类：

触发器节点根据外部事件或条件启动工作流。动作节点在工作流中执行具体任务，如获取数据、发送通知、操作外部系统。核心节点提供逻辑判断、数据转换等内置功能。

3.3 数据流（Data Flow）

在n8n中，数据以JSON格式在节点间流动。当一个节点处理完数据后，会将结果传递给下一个连接的节点。每个节点可以处理多个数据项，当接收到数组时，会逐项处理。

3.4 凭证（Credentials）

凭证是连接外部服务所需的认证信息，如API Key、用户名密码等。n8n使用加密方式存储凭证，节点在需要时请求相应的凭证信息。

四、核心节点详解

4.1 触发器节点

Manual Trigger（手动触发） ：最基础的触发器，点击“Execute Workflow”按钮即可启动，适合测试和临时任务。

Schedule Trigger（定时触发） ：按设定的时间计划自动运行，支持周、月、自定义Cron表达式。例如设置每周一上午9点运行。

Webhook（Webhook触发） ：接收外部HTTP请求触发工作流。支持GET、POST、PUT等多种HTTP方法。提供测试和生产两套URL。最大Payload为16MB。

配置要点：

• 路径（Path）：可自定义URL路径，支持动态参数
• 认证方式：支持Basic Auth、Header Auth、JWT Auth
• 响应模式：可选择“立即响应”或“等待最后节点完成”

4.2 动作节点

HTTP Request：调用任意HTTP API，是最通用的集成节点。支持所有标准HTTP方法，可配置Headers、Body、Query参数。

Email（发送邮件） ：通过SMTP发送邮件。需配置SMTP服务器、发件人、收件人等信息。

Google Sheets：读写Google Sheets表格数据，实现数据自动录入和导出。

4.3 核心逻辑节点

If（条件判断） ：根据条件将数据路由到不同分支。支持多条件组合（AND/OR），可创建多个分支。

Switch（多路分支） ：类似编程中的switch语句，根据字段值路由到不同分支。

Code（代码节点） ：执行自定义JavaScript代码，实现复杂数据转换。例如Token验证和配置初始化：

const CONFIG = {
  MONITOR_AUTH_TOKEN: 'YOUR_TOKEN_HERE',
  TELEGRAM_CHAT_ID: 'YOUR_CHAT_ID'
};
// 验证逻辑
if (inputData.auth_token !== CONFIG.MONITOR_AUTH_TOKEN) {
  throw new Error('Invalid authentication token');
}

Merge（合并） ：将多个分支的数据合并为一个输出。

Aggregate（聚合） ：将多个数据项聚合成单个项。

4.4 AI Agent节点

n8n 2.0版本强化了AI能力，提供了原生的AI Agent支持：

AI Agent（智能体节点） ：作为决策者，可调用工具完成复杂任务。支持多种Agent类型，可根据设置切换。

AI Agent Tool（智能体工具节点） ：允许根级Agent调用其他Agent作为工具。可嵌套多层，实现复杂任务分工。需配置描述（Description）和提示词（Prompt）。

配置参数：

• 最大迭代次数（Max Iterations）：控制模型运行次数
• 系统消息（System Message）：对话开始前的系统提示
• 批量处理（Batch Processing）：控制并行处理数量

五、构建第一个工作流：5步实战

我们以“手动触发 → 发送测试邮件”为例，快速上手。

5.1 第1步：创建新工作流

登录n8n后，点击左侧菜单栏的“+”或“新建工作流”按钮，为工作流命名（如“测试邮件发送”），点击创建进入空白画布。

5.2 第2步：添加触发节点

点击画布中间的“+”或“Add first step”，搜索“Manual Trigger”并选择。该节点无需额外配置，点击即运行。

5.3 第3步：添加动作节点

点击Manual Trigger节点右侧的箭头，再点击“+”添加节点。搜索“Email”并选择Email节点。在节点配置中：

• 操作（Operation） ：选择“Send Email”
• 凭证（Credential） ：创建或选择SMTP凭证
• 收件人（To Email） ：填写目标邮箱
• 主题（Subject） ：如“测试邮件”
• 正文（Body） ：如“这是n8n发送的第一封测试邮件！”

5.4 第4步：配置凭证

在Email节点中，选择“Create new credential”。填写SMTP服务器信息（如QQ邮箱：smtp.qq.com，端口465或587），输入邮箱账号和授权码，保存。

5.5 第5步：执行与测试

点击画布右上角的“Execute Workflow”按钮，手动触发工作流。查看执行状态——绿色表示成功，红色表示失败。检查邮箱是否收到测试邮件。

5.6 第6步：保存与发布

测试通过后，点击“Save”保存工作流。如需定时自动运行，可将Manual Trigger替换为Schedule Trigger。

六、进阶实战案例

6.1 案例一：服务器监控与Telegram告警

此案例展示如何用n8n搭建完整的服务器监控告警系统。

工作流设计 ：

1. Webhook节点：接收服务器上报的监控数据（POST请求，路径/server-monitor）
2. Code节点：验证Token，提取CPU、内存、磁盘使用率等字段
3. If节点：判断是否超过告警阈值（如CPU>80%）
4. Telegram节点：超过阈值则推送告警消息

数据格式示例 ：

{
  "server_name": "web-server-01",
  "cpu_usage": 85.5,
  "memory_usage": 72.3,
  "disk_usage": 68.0,
  "auth_token": "YOUR_SECURE_TOKEN"
}

6.2 案例二：AI邮件自动处理

此案例展示如何将AI能力嵌入工作流。

工作流设计：

1. Gmail Trigger节点：监听新邮件
2. AI Agent节点：调用大模型分析邮件内容，提取关键信息（如发票ID、金额）
3. Google Sheets节点：将提取的信息写入电子表格

6.3 案例三：定时公众号AI排版发布

此案例展示定时内容生成与发布的自动化：

1. Schedule Trigger节点：设定每日发布时间
2. HTTP Request节点：获取内容数据源
3. AI Agent节点：对内容进行智能排版和润色
4. HTTP Request节点：调用公众号API发布内容

七、n8n 2.0新特性

2025年底发布的n8n 2.0引入了多项重要更新：

八、常见问题（FAQ）

Q1：n8n是免费的吗？

n8n采用Fair-code许可协议，自托管版本完全免费，可使用绝大部分功能。n8n Cloud提供14天免费试用。

Q2：n8n和Zapier有什么区别？

n8n是开源可自托管的，数据完全自主可控；Zapier是闭源的云端SaaS服务。自托管n8n可无限量执行工作流，而Zapier按执行次数收费。

Q3：n8n支持哪些应用集成？

官方维护400多个核心节点，社区贡献节点达1800多个，覆盖主流应用如Gmail、Google Sheets、Slack、Telegram、Notion、GitHub等。未覆盖的应用可通过HTTP Request节点自定义集成。

Q4：n8n如何与AI大模型集成？

n8n提供原生的AI Agent节点，支持调用OpenAI、Anthropic等大模型API。可构建智能客服、自动邮件处理、文档问答等AI工作流。

Q5：n8n能在Windows上运行吗？

可以。推荐通过Docker Desktop在Windows上运行。也可通过WSL2或直接使用npm安装。

Q6：工作流执行失败如何处理？

n8n提供Error Handler节点，可捕获异常并执行重试或告警逻辑。每次执行都会记录在Executions面板中，方便排查问题。

Q7：n8n的数据存储在哪里？

自托管时，数据存储在你自己的数据库中（默认SQLite，生产推荐PostgreSQL）。n8n Cloud的数据存储在n8n的云端服务器。

Q8：如何保证n8n的安全性？

n8n支持OAuth2.0、JWT等多因素认证，传输层支持TLS 1.3加密，凭证信息加密存储。自托管时可部署在内网或配置防火墙。

Q9：n8n支持中文界面吗？

n8n官方界面为英文，社区提供了汉化方案。节点配置和表达式语法保持英文。

Q10：n8n适合企业级应用吗？

适合。n8n支持PostgreSQL持久化、Kubernetes高可用部署、任务隔离执行等功能，已有多家金融、制造企业用于生产环境。