n8n完整教程 - 开源工作流自动化平台

💎 n8n核心优势

🎨

可视化编排

拖拽式界面，无需编码即可构建复杂工作流。

🔌

丰富集成

400+节点，连接Notion、Slack、数据库、AI模型等。

🏠

完全自主

Fair-code许可，可自托管部署，数据完全可控。

🚀 快速开始

📦 安装部署

方法1：Docker（推荐）

# 快速启动
docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  n8nio/n8n

# 或使用docker-compose
version: '3'
services:
  n8n:
    image: n8nio/n8n
    ports:
      - "5678:5678"
    volumes:
      - ~/.n8n:/home/node/.n8n
    environment:
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=password

方法2：npm安装

# 全局安装
npm install n8n -g

# 启动
n8n start

# 访问 http://localhost:5678

方法3：npx

# 无需安装，直接运行
npx n8n

🎯 创建第一个工作流

示例：每日新闻摘要 + AI总结

1
Cron节点：每天早上8点触发
2
HTTP Request：调用新闻API获取最新新闻
3
OpenAI节点：用GPT-4总结新闻要点
4
Slack节点：发送摘要到团队频道

💡 操作步骤：

• 点击右上角"+"创建新工作流
• 搜索并拖入所需节点
• 连接节点，配置参数
• 点击"Execute Workflow"测试
• 激活工作流，开始自动运行

🤖 AI工作流实战

案例1：AI智能客服工作流

工作流设计：

Webhook接收

→

意图识别

→

IF条件分支

→

查询数据库/调用API

→

GPT生成回复

→

返回响应

关键节点配置

• Webhook：接收客户消息
• OpenAI：分析用户意图
• IF：根据意图路由
• Postgres：查询订单/FAQ
• OpenAI：生成友好回复
• HTTP Response：返回给客户

💡 实现效果：

✓ 24/7自动响应客户
✓ 自动查询订单状态
✓ 复杂问题转人工
✓ 多渠道支持（微信、Slack等）

案例2：AI内容生成流水线

工作流：从话题到发布

定时触发

→

热点抓取

→

GPT生成文章

→

DALL-E生成配图

→

发布到CMS

→

社交媒体分发

// n8n工作流JSON示例
{
  "nodes": [
    {
      "name": "Cron",
      "type": "n8n-nodes-base.cron",
      "parameters": {
        "triggerTimes": {
          "mode": "everyDay",
          "hour": 9
        }
      }
    },
    {
      "name": "OpenAI - Generate Article",
      "type": "@n8n/n8n-nodes-langchain.openAi",
      "parameters": {
        "model": "gpt-4",
        "prompt": "基于当前热点写一篇技术文章"
      }
    }
  ]
}

案例3：数据自动同步

Google Sheets ↔ Notion ↔ Airtable 三向同步

📊

Google Sheets

数据源

📝

Notion

知识库

🗂️

Airtable

项目管理

🎓 高级功能

🤖 AI Agent节点

n8n内置LangChain支持，可构建智能Agent

// AI Agent配置示例
{
  "node": "AI Agent",
  "tools": [
    "Search Wikipedia",
    "Calculator",
    "HTTP Request"
  ],
  "model": "gpt-4",
  "prompt": "你是一个研究助手..."
}

💻 代码节点

JavaScript/Python自定义逻辑

// JavaScript
const data = $input.all();
return data.map(item => ({
  ...item,
  processed: processData(item.json)
}));

// Python
import pandas as pd
df = pd.DataFrame($input.all())
result = df.groupby('category').sum()
return result.to_dict()

🛡️ 错误处理

• Try-Catch：节点失败时的处理逻辑
• 重试机制：自动重试失败的请求
• 错误触发器：错误时发送告警
• 降级处理：主流程失败时的备用方案

🔀 条件逻辑

• IF节点：条件分支
• Switch节点：多条件路由
• Merge节点：合并多个分支
• Loop节点：循环处理数据

⭐ 最佳实践

✅ 推荐做法

✓
模块化设计：复杂流程拆分为子工作流
✓
环境变量：API密钥使用环境变量
✓
错误处理：关键节点添加错误捕获
✓
日志记录：记录关键步骤便于排查

❌ 常见陷阱

✗
忘记激活：创建后要激活工作流
✗
硬编码密钥：不要把密钥写在节点里
✗
无限循环：注意循环退出条件
✗
不测试就上线：手动执行测试后再激活

❓ 常见问题

Q1: n8n免费吗？如何选择版本？

社区版：完全免费开源，可自托管，功能完整
云版：托管服务，有免费额度（5000次执行/月）
企业版：SSO、审计日志、优先支持
建议：个人/小团队用社区版自托管，大企业用企业版

Q2: 如何保护工作流中的API密钥？

• 使用n8n的Credentials功能存储密钥
• 环境变量注入（推荐生产环境）
• 使用密钥管理服务（Vault、AWS Secrets Manager）
• 定期轮换密钥

Q3: n8n性能如何？能处理大量数据吗？

性能优化建议：

• 单个工作流：建议处理<10000条数据
• 大数据量：分批处理，使用Loop节点
• 并发执行：多实例部署
• 队列模式：使用Queue mode处理高负载

Q4: 如何调试工作流？

• 使用"Execute Workflow"手动测试
• 查看每个节点的输入输出数据
• 检查执行历史（Executions）
• 启用详细日志
• 使用Sticky Notes添加注释

💼 完整实战案例

案例1：AI自动化内容发布系统

从选题、创作到多平台发布的完整自动化流程

🔄 工作流程：

定时触发

→

搜索热点话题

→

GPT-4生成文章

→

图片生成（DALL-E）

→

发布到多平台

📝 所需节点：

• Schedule Trigger（每天早上8点）
• HTTP Request（搜索API）
• OpenAI（生成文章）
• DALL-E（生成配图）
• Twitter/Medium/WordPress（发布）

✅ 实现效果：

✓ 每天自动发布1篇文章
✓ 同时发布到3个平台
✓ SEO优化和hashtag自动生成
✓ 零人工干预

案例2：CRM数据自动同步

HubSpot、Salesforce、Google Sheets三向同步

工作流逻辑：

1. Webhook触发：HubSpot新客户创建时触发
2. 数据转换：统一字段格式
3. 条件判断：检查客户是否已存在
4. 同步到Salesforce：创建/更新记录
5. 更新Google Sheets：添加到跟踪表
6. 发送通知：Slack通知销售团队

案例3：AI智能客服工作流

结合GPT-4、知识库、人工转接的完整客服系统

🎬 入口

• Webhook（网站）
• Telegram Bot
• 邮件接收

🤖 AI处理

• 意图识别
• 知识库检索
• GPT-4生成回复

📤 响应

• 自动回复
• 人工转接
• 工单创建

🎯 高级工作流模式

⚡ 并行处理模式

同时执行多个任务，提升效率

使用场景：

• 多平台同时发布内容
• 并行调用多个API
• 同时生成多种格式文件

🔗 子工作流模式

将复杂流程拆分为可复用模块

优势：

• 代码复用，减少重复
• 易于维护和测试
• 提升可读性

🔄 错误重试模式

网络不稳定时自动重试

配置：

• 重试次数：3次
• 重试间隔：指数退避
• 失败后降级处理

📊 数据聚合模式

从多个源收集数据后统一处理

应用：

• 多API数据汇总
• 合并多个数据源
• 数据清洗和转换

🔌 400+ 集成节点

🤖 AI服务

• OpenAI
• Anthropic
• Google AI
• Hugging Face

💬 通讯工具

• Slack
• Discord
• Telegram
• 企业微信

🗄️ 数据库

• PostgreSQL
• MySQL
• MongoDB
• Redis

📊 办公软件

• Google Sheets
• Notion
• Airtable
• Trello

开始使用n8n

10分钟构建第一个自动化工作流

快速开始工作流模板返回工具层

n8n 完整教程