简介
N8N(发音为 "n-eight-n")是一个开源的工作流自动化平台,旨在帮助用户将各种应用程序和服务连接起来,实现自动化任务处理。N8N的名称来源于"nodemation"的缩写,强调其基于节点(Node)的自动化理念。
什么是N8N?
N8N是一个功能强大的工作流自动化工具,类似于Zapier或Microsoft Power Automate,但它是完全开源的,可以自托管部署。
适用场景
数据同步:在不同系统之间同步数据
通知自动化:自动发送邮件、消息通知
数据处理:批量处理、转换和分析数据
API集成:连接多个API服务
定时任务:执行定时触发的自动化任务
Webhook处理:接收和处理Webhook请求
核心特点
1. 开源免费
N8N采用Apache 2.0开源许可证,可以免费使用和修改。
2. 高度可定制
支持创建自定义节点
内置JavaScript/TypeScript代码执行能力
提供丰富的表达式和函数库
3. 自托管部署
完全控制您的数据
无需依赖第三方服务
4. 丰富的集成
提供超过400+个预构建节点,包括云服务、数据库、通信工具、开发工具等。
5. 可视化界面
直观的拖拽式工作流编辑器
实时数据预览
工作流执行历史记录
6. 强大的数据处理能力
数据转换和映射
条件分支和循环
数据聚合和过滤
基础功能
1. 触发器(Triggers)
触发器是工作流的起点,用于启动自动化流程:
Webhook触发器
HTTP Request:接收HTTP请求
Webhook:接收Webhook事件
定时触发器
Cron:基于Cron表达式的定时任务
Schedule Trigger:简单的定时调度
2. 操作节点(Actions)
执行具体任务的节点:
HTTP请求
HTTP Request:发送HTTP/HTTPS请求
REST API:调用RESTful API
数据处理
Set:设置数据字段
Code:执行JavaScript/TypeScript代码
条件控制
IF:条件判断
Switch:多条件分支
3. 数据转换
数据映射和过滤
数据聚合和汇总
格式转换支持
安装与部署
系统要求
Node.js:v18.10或更高版本
Docker:Docker 20.10+和Docker Compose 1.29+
内存:至少2GB RAM
存储:至少10GB可用空间
安装方式
方式一:使用npx(最快)
npx n8n
访问http://localhost:5678即可使用。
方式二:npm全局安装
npm install -g n8n
n8n start
方式三:Docker快速启动
docker run -it --rm \
--name n8n \
-p 5678:5678 \
-v ~/.n8n:/home/node/.n8n \
n8nio/n8n
Docker部署详解
基础Docker部署
创建docker-compose.yml:
version: '3.8'
services:
n8n:
image: n8nio/n8n:latest
container_name: n8n
restart: always
ports:
- "5678:5678"
environment:
- N8N_BASIC_AUTH_ACTIVE=true
- N8N_BASIC_AUTH_USER=admin
- N8N_BASIC_AUTH_PASSWORD=your-secure-password
- N8N_HOST=localhost
- N8N_PORT=5678
- N8N_PROTOCOL=http
volumes:
- n8n_data:/home/node/.n8n
volumes:
n8n_data:
启动服务:
docker-compose up -d
生产环境配置
完整的docker-compose.yml(生产环境):
version: '3.8'
services:
n8n:
image: n8nio/n8n:latest
container_name: n8n
restart: unless-stopped
ports:
- "5678:5678"
environment:
- N8N_BASIC_AUTH_ACTIVE=true
- N8N_BASIC_AUTH_USER=admin
- N8N_BASIC_AUTH_PASSWORD=${N8N_PASSWORD}
- DB_TYPE=postgresdb
- DB_POSTGRESDB_HOST=postgres
- DB_POSTGRESDB_DATABASE=n8n
- N8N_ENCRYPTION_KEY=${N8N_ENCRYPTION_KEY}
volumes:
- n8n_data:/home/node/.n8n
depends_on:
- postgres
postgres:
image: postgres:15-alpine
container_name: n8n-postgres
environment:
- POSTGRES_USER=n8n
- POSTGRES_PASSWORD=${POSTGRES_PASSWORD}
- POSTGRES_DB=n8n
volumes:
- postgres_data:/var/lib/postgresql/data
volumes:
n8n_data:
postgres_data:
创建.env文件:
N8N_PASSWORD=your-strong-password-here
POSTGRES_PASSWORD=your-postgres-password
N8N_ENCRYPTION_KEY=your-32-character-encryption-key
工作流构建指南
创建第一个工作流
步骤1:访问N8N界面
打开浏览器,访问
http://localhost:5678使用设置的用户名和密码登录
步骤2:创建新工作流
点击左侧菜单的"Workflows"
点击"Add workflow"按钮
给工作流命名
步骤3:添加触发器
点击"+"按钮添加节点
搜索"Manual Trigger"或"Webhook"
选择并添加触发器节点
步骤4:添加操作节点
从触发器节点拖出连接线
点击"+"添加新节点
选择需要的操作节点
工作流示例
示例1:定时发送邮件
[Schedule Trigger] → [HTTP Request] → [Email Send]
示例2:Webhook数据处理
[Webhook] → [Code] → [IF] → [HTTP Request] → [Database]
节点配置技巧
使用表达式
{{ $json.fieldName }}
{{ $node["节点名称"].json.fieldName }}
{{ $now.format('YYYY-MM-DD HH:mm:ss') }}
代码节点示例
const items = $input.all();
const results = items.map(item => {
return {
id: data.id,
name: data.name.toUpperCase(),
timestamp: new Date().toISOString()
};
});
return results;
常用节点介绍
1. HTTP Request节点
用于发送HTTP请求,支持GET、POST、PUT、DELETE等方法。
配置项:
Method:HTTP方法
URL:请求地址
Authentication:认证方式
2. Code节点
执行JavaScript/TypeScript代码,用于复杂的数据处理。
3. IF节点
条件判断节点,根据条件路由数据流。
4. Switch节点
多条件分支节点,根据不同的条件值路由到不同的输出。
5. Set节点
设置和修改数据字段。
高级功能
1. 自定义节点开发
N8N支持创建自定义节点以满足特定需求。
创建自定义节点
git clone https://github.com/n8n-io/n8n.git
cd n8n
npm install
npm run build:custom-nodes
2. 环境变量
使用环境变量存储敏感信息。
设置环境变量
export N8N_API_KEY=your-api-key
3. 凭证管理
N8N提供安全的凭证管理系统。
最佳实践
1. 工作流设计原则
保持简单
每个工作流专注于单一任务
避免过度复杂的嵌套逻辑
错误处理
为关键节点添加错误处理
使用Try-Catch节点捕获错误
2. 安全建议
凭证管理
✅ 使用凭证系统存储敏感信息
✅ 定期轮换API密钥
❌ 不要在代码中硬编码密码
3. 监控和维护
监控指标
工作流执行成功率
平均执行时间
错误频率
故障排查
常见问题
问题:无法访问N8N界面
可能原因:
端口被占用
防火墙阻止访问
服务未正常启动
问题:工作流执行失败
可能原因:
节点配置错误
API认证失败
网络连接问题
调试技巧
启用详细日志
environment:
- N8N_LOG_LEVEL=debug
参考资料
官方资源
官方网站:https://n8n.io
官方文档:https://docs.n8n.io
GitHub仓库:https://github.com/n8n-io/n8n
社区资源
Discord社区:https://discord.gg/n8n