512 lines
13 KiB
Markdown
512 lines
13 KiB
Markdown
# 常用节点
|
||
|
||
## 📚 学习资源
|
||
|
||
- **图文教程**：[n8n工作流创建完整指南](https://mp.weixin.qq.com/s/oIcmTW0Gg2r63C0Tn91r2Q)
|
||
- **视频教程**：[从零开始的n8n实战](https://www.bilibili.com/video/BV1nejbz6Eip)
|
||
- **官方文档**：[n8n Workflow Examples](https://docs.n8n.io/workflows/)
|
||
|
||
n8n提供了丰富的节点库，覆盖了工作流自动化的各个方面。掌握这些常用节点是构建高效工作流的基础。
|
||
|
||
|
||
|
||
## 🧩 节点分类概览
|
||
|
||
**触发器**：手动触发、定时触发、Webhook、邮件触发、文件监控
|
||
**输入**：HTTP请求、数据库查询、文件读取、API调用、RSS获取
|
||
**处理**：数据转换、AI处理、代码执行、图像处理、文本分析
|
||
**逻辑**：条件判断、循环处理、数据合并、分支路由、错误处理
|
||
**输出**：邮件发送、文件保存、API推送、通知发送、数据存储
|
||
|
||
## 🔥 触发器节点 (Triggers)
|
||
|
||
触发器是工作流的起点，定义了工作流何时开始执行。
|
||
|
||
### Manual Trigger - 手动触发
|
||
|
||
**功能**: 用户手动启动的工作流执行
|
||
|
||
**使用场景**:
|
||
- 一次性任务执行
|
||
- 工作流测试和调试
|
||
- 按需数据处理
|
||
|
||
**配置**: 通常无需复杂配置，作为工作流的起始点
|
||
|
||
**最佳实践**：Manual Trigger → 数据获取 → 数据处理 → 结果输出
|
||
|
||
### Schedule Trigger - 定时触发
|
||
|
||
**功能**: 基于时间的自动化任务执行
|
||
|
||
**配置选项**:
|
||
- **时间间隔**: 每分钟、小时、天、周、月
|
||
- **Cron表达式**: 高级时间配置
|
||
- **时区设置**: 确保正确的执行时间
|
||
|
||
**常用场景**:
|
||
|
||
=== "每日报告"
|
||
```
|
||
触发时间: 每天 09:00
|
||
时区: Asia/Shanghai
|
||
工作日执行: 周一到周五
|
||
```
|
||
|
||
=== "数据同步"
|
||
```
|
||
触发时间: 每30分钟
|
||
执行条件: 24/7运行
|
||
错误重试: 启用
|
||
```
|
||
|
||
=== "定期清理"
|
||
```
|
||
触发时间: 每周日 02:00
|
||
任务: 清理临时文件
|
||
通知: 完成后发送邮件
|
||
```
|
||
|
||
!!! warning "定时触发注意事项"
|
||
- 确保服务器时区设置正确
|
||
- 考虑服务器维护时间窗口
|
||
- 设置合理的执行超时时间
|
||
- 添加错误处理和重试机制
|
||
|
||
### Webhook - API触发
|
||
|
||
**功能**: 通过HTTP请求触发工作流
|
||
|
||
**配置要素**:
|
||
- **URL路径**: 自定义webhook端点
|
||
- **HTTP方法**: GET、POST、PUT、DELETE
|
||
- **认证方式**: 无认证、基础认证、头部认证
|
||
|
||
**典型应用**:
|
||
|
||
| 场景 | 触发源 | 数据处理 |
|
||
|------|-------|---------|
|
||
| **GitHub集成** | 代码推送事件 | 自动部署、测试通知 |
|
||
| **表单提交** | 网站表单 | 数据验证、邮件通知 |
|
||
| **支付回调** | 支付网关 | 订单处理、发货通知 |
|
||
| **监控告警** | 监控系统 | 故障分析、团队通知 |
|
||
|
||
**安全配置**:
|
||
```yaml
|
||
webhook_url: https://your-n8n.com/webhook/secure-endpoint
|
||
authentication:
|
||
type: header
|
||
name: X-API-Key
|
||
value: your-secret-api-key
|
||
```
|
||
|
||
## 📥 输入节点 (Input)
|
||
|
||
输入节点用于从各种数据源获取信息。
|
||
|
||
### HTTP Request - HTTP请求
|
||
|
||
**功能**: 与外部API和服务进行交互
|
||
|
||
**配置参数**:
|
||
- **请求方法**: GET、POST、PUT、DELETE、PATCH
|
||
- **URL**: 目标API地址
|
||
- **头部**: 认证、内容类型等
|
||
- **请求体**: POST数据、JSON负载
|
||
|
||
**实用示例**:
|
||
|
||
=== "获取天气数据"
|
||
```json
|
||
{
|
||
"method": "GET",
|
||
"url": "https://api.openweathermap.org/data/2.5/weather",
|
||
"qs": {
|
||
"q": "Beijing",
|
||
"appid": "your-api-key",
|
||
"units": "metric"
|
||
}
|
||
}
|
||
```
|
||
|
||
=== "发送Slack消息"
|
||
```json
|
||
{
|
||
"method": "POST",
|
||
"url": "https://hooks.slack.com/services/your/webhook/url",
|
||
"body": {
|
||
"text": "工作流执行完成",
|
||
"channel": "#general"
|
||
}
|
||
}
|
||
```
|
||
|
||
### Read/Write Files from Disk - 文件操作
|
||
|
||
**功能**: 读取和写入本地文件系统
|
||
|
||
**支持格式**:
|
||
- **文本文件**: TXT、CSV、JSON、XML
|
||
- **表格文件**: Excel、CSV
|
||
- **图像文件**: JPG、PNG、PDF
|
||
- **压缩文件**: ZIP、TAR
|
||
|
||
**配置示例**:
|
||
```javascript
|
||
// 读取CSV文件
|
||
{
|
||
"operation": "read",
|
||
"filePath": "/files/data/sales-report.csv",
|
||
"options": {
|
||
"encoding": "utf8",
|
||
"hasHeaders": true
|
||
}
|
||
}
|
||
|
||
// 写入JSON文件
|
||
{
|
||
"operation": "write",
|
||
"filePath": "/files/output/processed-data.json",
|
||
"fileContent": "{{ $json }}",
|
||
"options": {
|
||
"encoding": "utf8"
|
||
}
|
||
}
|
||
```
|
||
|
||
### Database Nodes - 数据库操作
|
||
|
||
支持主流数据库系统：
|
||
|
||
=== "MySQL"
|
||
```sql
|
||
-- 查询示例
|
||
SELECT customer_id, order_date, total_amount
|
||
FROM orders
|
||
WHERE order_date >= CURDATE() - INTERVAL 7 DAY;
|
||
|
||
-- 插入示例
|
||
INSERT INTO logs (timestamp, level, message)
|
||
VALUES (NOW(), 'INFO', '工作流执行成功');
|
||
```
|
||
|
||
=== "PostgreSQL"
|
||
```sql
|
||
-- 复杂查询
|
||
WITH monthly_sales AS (
|
||
SELECT DATE_TRUNC('month', order_date) as month,
|
||
SUM(total_amount) as total
|
||
FROM orders
|
||
GROUP BY DATE_TRUNC('month', order_date)
|
||
)
|
||
SELECT * FROM monthly_sales
|
||
ORDER BY month DESC LIMIT 12;
|
||
```
|
||
|
||
=== "MongoDB"
|
||
```javascript
|
||
// 查询文档
|
||
db.users.find({
|
||
"status": "active",
|
||
"last_login": {
|
||
"$gte": new Date(Date.now() - 30*24*60*60*1000)
|
||
}
|
||
})
|
||
|
||
// 聚合操作
|
||
db.orders.aggregate([
|
||
{$match: {status: "completed"}},
|
||
{$group: {_id: "$product_id", total: {$sum: "$amount"}}},
|
||
{$sort: {total: -1}}
|
||
])
|
||
```
|
||
|
||
## 🔄 处理节点 (Process)
|
||
|
||
处理节点用于数据转换、分析和业务逻辑处理。
|
||
|
||
### Set - 数据设置
|
||
|
||
**功能**: 设置或修改数据字段
|
||
|
||
**操作类型**:
|
||
- **设置字段值**: 添加新字段或修改现有字段
|
||
- **删除字段**: 移除不需要的数据
|
||
- **重命名字段**: 改变字段名称
|
||
- **类型转换**: 字符串、数字、布尔值转换
|
||
|
||
**实用配置**:
|
||
```javascript
|
||
// 设置新字段
|
||
{
|
||
"user_full_name": "={{$json.first_name}} {{$json.last_name}}",
|
||
"processed_at": "={{new Date().toISOString()}}",
|
||
"status": "processed"
|
||
}
|
||
|
||
// 数据转换
|
||
{
|
||
"price": "={{parseFloat($json.price_string)}}",
|
||
"is_active": "={{$json.status === 'active'}}",
|
||
"tags": "={{$json.tag_string.split(',')}}"
|
||
}
|
||
```
|
||
|
||
### Code - 代码节点
|
||
|
||
**功能**: 执行自定义JavaScript或Python代码
|
||
|
||
**JavaScript示例**:
|
||
```javascript
|
||
// 复杂数据处理
|
||
for (const item of $input.all()) {
|
||
// 数据验证
|
||
if (!item.json.email || !item.json.email.includes('@')) {
|
||
continue;
|
||
}
|
||
|
||
// 数据转换
|
||
const processedItem = {
|
||
id: item.json.id,
|
||
email: item.json.email.toLowerCase(),
|
||
domain: item.json.email.split('@')[1],
|
||
processed_at: new Date().toISOString(),
|
||
hash: require('crypto').createHash('md5').update(item.json.email).digest('hex')
|
||
};
|
||
|
||
$return.push({json: processedItem});
|
||
}
|
||
```
|
||
|
||
**Python示例**:
|
||
```python
|
||
import pandas as pd
|
||
import numpy as np
|
||
from datetime import datetime
|
||
|
||
# 处理输入数据
|
||
data = []
|
||
for item in _input.all():
|
||
data.append(item['json'])
|
||
|
||
# 使用pandas处理
|
||
df = pd.DataFrame(data)
|
||
df['processed_at'] = datetime.now().isoformat()
|
||
df['score'] = df['score'].fillna(0)
|
||
df['category'] = df['score'].apply(lambda x: 'high' if x > 80 else 'low')
|
||
|
||
# 返回处理结果
|
||
for _, row in df.iterrows():
|
||
_return.push({'json': row.to_dict()})
|
||
```
|
||
|
||
### AI Agent - AI代理
|
||
|
||
**功能**: 集成大语言模型进行智能处理
|
||
|
||
**支持的AI服务**:
|
||
- OpenAI GPT系列
|
||
- Anthropic Claude
|
||
- Google Gemini
|
||
- 本地Ollama模型
|
||
|
||
**典型应用**:
|
||
|
||
=== "文本分析"
|
||
```javascript
|
||
// 情感分析
|
||
prompt: `分析以下文本的情感倾向，返回正面、负面或中性：
|
||
文本：{{$json.comment}}
|
||
|
||
请以JSON格式返回：{"sentiment": "正面/负面/中性", "confidence": 0.95}`
|
||
```
|
||
|
||
=== "数据提取"
|
||
```javascript
|
||
// 信息提取
|
||
prompt: `从以下邮件中提取关键信息：
|
||
邮件内容：{{$json.email_content}}
|
||
|
||
请提取：
|
||
- 发件人姓名
|
||
- 联系方式
|
||
- 主要需求
|
||
- 紧急程度
|
||
|
||
以JSON格式返回结果。`
|
||
```
|
||
|
||
=== "内容生成"
|
||
```javascript
|
||
// 报告生成
|
||
prompt: `基于以下数据生成每日销售报告：
|
||
销售数据：{{$json.sales_data}}
|
||
|
||
报告应包含：
|
||
1. 销售总结
|
||
2. 重点产品表现
|
||
3. 趋势分析
|
||
4. 改进建议
|
||
|
||
请生成专业的中文报告。`
|
||
```
|
||
|
||
## 🧠 逻辑节点 (Logic)
|
||
|
||
逻辑节点控制工作流的执行路径和数据流向。
|
||
|
||
### IF - 条件判断
|
||
|
||
**功能**: 根据条件将数据流分为不同路径
|
||
|
||
**条件类型**:
|
||
- **数值比较**: 等于、大于、小于
|
||
- **字符串匹配**: 包含、开始于、结束于
|
||
- **逻辑运算**: 与、或、非
|
||
- **存在性检查**: 字段是否存在、是否为空
|
||
|
||
**实用场景**：数据输入 → 判断金额 > 1000？ → 是：高价值客户流程 → 发送VIP邮件；否：普通客户流程 → 发送标准邮件
|
||
|
||
### Switch - 多路分支
|
||
|
||
**功能**: 根据不同值将数据路由到多个分支
|
||
|
||
**配置示例**:
|
||
```javascript
|
||
// 根据订单状态分发处理
|
||
switch_value: "={{$json.order_status}}"
|
||
|
||
// 分支配置:
|
||
// 0: "pending" -> 待处理流程
|
||
// 1: "paid" -> 已付款流程
|
||
// 2: "shipped" -> 已发货流程
|
||
// 3: "completed" -> 已完成流程
|
||
// default: 异常处理流程
|
||
```
|
||
|
||
### Loop Over Items - 循环处理
|
||
|
||
**功能**: 对数据集合中的每个项目执行相同操作
|
||
|
||
**适用场景**:
|
||
- 批量数据处理
|
||
- 文件批量操作
|
||
- API批量调用
|
||
- 报告批量生成
|
||
|
||
**处理流程**：数据列表 → Loop Over Items → 处理单个项目 → API调用 → 结果收集 → 汇总输出
|
||
|
||
## 📤 输出节点 (Output)
|
||
|
||
输出节点将处理结果发送到外部系统或用户。
|
||
|
||
### Email Send - 邮件发送
|
||
|
||
**功能**: 发送电子邮件通知和报告
|
||
|
||
**配置要素**:
|
||
- **收件人**: 支持多个收件人、抄送、密送
|
||
- **邮件内容**: HTML格式、纯文本、动态内容
|
||
- **附件**: 支持文件、图片、报告附件
|
||
|
||
**邮件模板示例**:
|
||
```html
|
||
<!DOCTYPE html>
|
||
<html>
|
||
<head>
|
||
<style>
|
||
.report { font-family: Arial, sans-serif; }
|
||
.header { background-color: #f0f0f0; padding: 10px; }
|
||
.content { padding: 20px; }
|
||
.table { border-collapse: collapse; width: 100%; }
|
||
.table th, .table td { border: 1px solid #ddd; padding: 8px; }
|
||
</style>
|
||
</head>
|
||
<body>
|
||
<div class="report">
|
||
<div class="header">
|
||
<h2>{{$json.report_title}}</h2>
|
||
<p>生成时间: {{$json.generated_at}}</p>
|
||
</div>
|
||
<div class="content">
|
||
<p>尊敬的 {{$json.recipient_name}}，</p>
|
||
<p>以下是您请求的{{$json.report_type}}报告：</p>
|
||
|
||
<table class="table">
|
||
<tr>
|
||
<th>指标</th>
|
||
<th>数值</th>
|
||
<th>变化</th>
|
||
</tr>
|
||
{{#each $json.metrics}}
|
||
<tr>
|
||
<td>{{this.name}}</td>
|
||
<td>{{this.value}}</td>
|
||
<td style="color: {{this.change_color}}">{{this.change}}</td>
|
||
</tr>
|
||
{{/each}}
|
||
</table>
|
||
</div>
|
||
</div>
|
||
</body>
|
||
</html>
|
||
```
|
||
|
||
### Webhook Response - 响应返回
|
||
|
||
**功能**: 向触发Webhook的服务返回响应
|
||
|
||
**响应配置**:
|
||
```javascript
|
||
{
|
||
"status_code": 200,
|
||
"headers": {
|
||
"Content-Type": "application/json",
|
||
"X-Processed-By": "n8n-workflow"
|
||
},
|
||
"body": {
|
||
"success": true,
|
||
"message": "数据处理完成",
|
||
"processed_items": "={{$json.count}}",
|
||
"timestamp": "={{new Date().toISOString()}}"
|
||
}
|
||
}
|
||
```
|
||
|
||
## 📊 节点使用统计和建议
|
||
|
||
### 使用频率统计
|
||
|
||
<div class="stats-grid">
|
||
<div class="stat-item">
|
||
<span class="stat-number">95%</span>
|
||
<span class="stat-label">工作流使用HTTP Request</span>
|
||
</div>
|
||
<div class="stat-item">
|
||
<span class="stat-number">78%</span>
|
||
<span class="stat-label">工作流使用Set节点</span>
|
||
</div>
|
||
<div class="stat-item">
|
||
<span class="stat-number">65%</span>
|
||
<span class="stat-label">工作流使用IF判断</span>
|
||
</div>
|
||
<div class="stat-item">
|
||
<span class="stat-number">52%</span>
|
||
<span class="stat-label">工作流使用Email发送</span>
|
||
</div>
|
||
</div>
|
||
|
||
### 学习建议
|
||
|
||
!!! tip "节点学习路径"
|
||
1. **基础必学**: Manual Trigger + Set + HTTP Request + Email
|
||
2. **进阶掌握**: Schedule Trigger + IF + Code + Database
|
||
3. **高级应用**: AI Agent + Loop + Switch + Webhook
|
||
4. **专业应用**: 根据业务需求选择特定集成节点
|
||
|
||
---
|
||
|
||
掌握这些常用节点后，您已经具备了构建80%常见工作流的能力！
|
||
|
||
[上一章：n8n汉化](../installation/localization/){ .md-button } [下一章：基本工作流创建](basic-workflows/){ .md-button .md-button--primary }
|