n8n开源工作流自动化平台本地部署实战
资源概览
项目名称： n8n
开源协议： Sustainable Use License（fair-code）
资源类型： 工作流自动化平台（SaaS/自托管）
GitHub： https://github.com/n8n-io/n8n
官方文档： https://docs.n8n.io
最新版本： v2.39.x（2026年9月）
n8n 是一款强调"fair-code"理念的工作流自动化平台，允许企业免费自托管使用，但不允许将其作为竞品服务出售。平台提供1500+集成节点、可视化工作流编辑器、AI Agent 工作流支持，适合技术团队、开发者、自动化爱好者自建私有化自动化中枢。相比 Zapier、Make（Integromat）等 SaaS 工具，n8n 的最大优势是完全数据主权掌控——所有数据在自有服务器上处理，不会经过第三方云服务。
核心功能
1500+ 集成节点
n8n 内置了大量常用服务的连接器，涵盖：
- 云服务：AWS、GCP、Azure、Cloudflare
- 数据库：MySQL、PostgreSQL、MongoDB、Redis
- 即时通讯：Slack、Discord、Telegram、微信（企业微信）
- AI 服务：OpenAI、Anthropic、Google Gemini、Ollama
- 办公协作：Notion、Google Workspace、Microsoft 365、飞书
- 电商支付：Shopify、Stripe、支付宝（插件）
AI Agent 工作流
v2.x 版本强化了 AI 原生能力：
- 多步 AI 编排：串联多个 LLM 调用，实现复杂推理链
- 工具使用（Function Calling）：让 AI Agent 调用外部 API
- 记忆管理：持久化对话历史，支持上下文连续交互
- 向量数据库集成：配合 Pinecone、Weaviate 等实现 RAG
可视化工作流构建
采用"节点 + 连线"的图形化编辑器，每个节点代表一个操作，连接后形成执行流。支持：
- 条件分支（IF/ELSE）
- 并行执行
- 循环迭代
- 错误处理与重试
- 调试模式实时查看节点输出
自托管与云版并行
自托管：Docker、npm、Kubernetes 多种部署方式
n8n Cloud：官方托管 SaaS，适合不想运维的团队
下载与安装
Docker 一键部署（推荐）
# 创建数据卷 docker volume create n8n_data # 启动容器 docker run -it --rm \ --name n8n \ -p 5678:5678 \ -v n8n_data:/home/node/.n8n \ docker.n8n.io/n8nio/n8n
访问 http://localhost:5678 即可进入初始化页面，创建管理员账号。
Docker Compose 生产部署
version: '3.8' services: n8n: image: docker.n8n.io/n8nio/n8n ports: - "5678:5678" environment: - N8N_ENCRYPTION_KEY=your-secret-key - GENERIC_TIMEZONE=Asia/Shanghai volumes: - n8n_data:/home/node/.n8n restart: unless-stopped volumes: n8n_data:
保存为 docker-compose.yml，执行 docker-compose up -d 即可。
npm 安装（需要 Node.js 18+）
npm install -g n8n n8n start
官方提供 Docker 镜像和源码，建议从 https://github.com/n8n-io/n8n 下载最新 release。
快速上手：创建 AI 工作总结工作流
场景：每天早上 9 点自动读取邮件中的待办事项，用 AI 总结生成日报发送到 Slack。
步骤 1：创建新工作流
登录 n8n → 点击"新建工作流" → 命名为"每日AI工作总结"。
步骤 2：添加触发节点
搜索"Schedule Trigger"节点，设置定时规则：
Cron: 0 9 * * * 时区: Asia/Shanghai
步骤 3：添加 Gmail 节点
搜索"Gmail"节点，配置 OAuth2 授权，读取最近24小时的未读邮件：
Operation: Read Label: INBOX,UNREAD
步骤 4：添加 OpenAI Chat Completion 节点
搜索"OpenAI Chat Completion"节点：
Model: gpt-4o
Temperature: 0.3
系统提示词: |
你是一位工作效率助手。请将以下邮件内容总结为简洁的待办事项清单，
按优先级排序，输出Markdown格式。
用户消息: {{ $json.body }}步骤 5：添加 Slack 消息节点
搜索"Slack"节点，选择"Send Message"，配置通道和目标用户。
步骤 6：激活工作流
点击右上角"激活"，等待次日 9 点自动执行。首次运行可手动点击"执行节点"测试。
同类工具对比
| 特性 | n8n | Zapier | Make | Node-RED |
|---|---|---|---|---|
| 开源协议 | fair-code | 闭源 | 闭源 | Apache 2.0 |
| 自托管 | ✅ 完全免费 | ❌ | ❌ | ✅ |
| 免费额度 | 无限（自托管） | 100条/月 | 1000 ops/月 | 无限 |
| 集成数量 | 1500+ | 7000+ | 2000+ | 社区插件 |
| AI Agent 支持 | ✅ 原生 | ✅ 付费 | ✅ 付费 | ❌ 需开发 |
| 可视化编辑器 | ✅ | ✅ | ✅ | ✅ |
| 编程扩展 | JavaScript/Python | JavaScript | JavaScript | JSON |
| 数据主权 | 完全掌控 | 第三方存储 | 第三方存储 | 完全掌控 |
| 学习曲线 | 中等 | 简单 | 中等 | 较陡 |
| 适用场景 | 技术团队、隐私敏感 | 非技术人员、快速集成 | 复杂逻辑编排 | IoT、硬件控制 |
选择建议：
- 重视数据隐私、有运维能力的团队 → n8n
- 非技术用户、追求开箱即用 → Zapier
- 需要复杂分支逻辑 → Make
- IoT、嵌入式场景 → Node-RED
注意事项
许可证限制
n8n 采用 Sustainable Use License（fair-code），允许：
- ✅ 个人学习使用
- ✅ 企业内部自托管使用
- ✅ 为客户定制开发部署
- ❌ 将 n8n 作为竞品服务出售（如"我们的平台基于 n8n"）
- ❌ 去除版权信息重新分发
商业使用建议参考官方定价：https://n8n.io/pricing
数据安全
自托管版本的所有数据存储在本地服务器，不经过 n8n 官方云。建议：
- 使用 HTTPS（反向代理 + Let's Encrypt）
- 设置强密码 + 2FA
- 定期备份 .n8n 目录
性能调优
并发工作流：增加
N8N_CONCURRENCY_PRODUCTION环境变量数据库选择：小团队用 SQLite 即可，生产环境建议 PostgreSQL
内存限制：Docker 容器设置
--memory=2g避免 OOM
官方提供详细的功能对比表和企业版特性说明，访问 https://n8n.io/pricing 查看。
踩坑记录
OAuth 回调地址配置：Gmail、Slack 等第三方应用需要配置回调 URL，格式为
http://your-domain/auth/n8n/oauth2-callback时区问题：Schedule Trigger 默认 UTC，需在环境变量设置
GENERIC_TIMEZONE=Asia/Shanghai大文件处理：附件超过 50MB 可能触发超时，建议拆分或使用对象存储中转
节点版本兼容：升级 n8n 版本后部分节点可能需要重新配置参数
资源来源：https://github.com/n8n-io/n8n
本文发布于：2026-09-19
资源标识：n8n-v2.39.x