n8n — 开源自动化工作流平台完全指南

最简单可靠的部署方式，一行命令启动：

# 快速启动（数据保存在 Docker Volume）
docker run -d --name n8n \
  -p 5678:5678 \
  -v n8n_data:/home/node/.n8n \
  n8nio/n8n

启动后访问 http://localhost:5678 即可使用。

Docker Compose 部署（生产环境推荐）：

适合开发和测试环境：

# 要求 Node.js >= 18
npm install -g n8n

# 启动
n8n start

# 或指定端口
n8n start --port 5678

如果不想自己维护服务器，可以使用 n8n 官方的云服务：
- 访问 n8n.io/cloud 注册账号
- 免费试用 14 天
- 付费方案从 $20/月起
- 自动更新、备份、SSL 等运维由官方处理

多个云平台支持一键部署 n8n：
- Railway：点击即部署，免费额度可用
- Render：支持免费实例（有休眠限制）
- Hetzner / Contabo：便宜的 VPS 自建，4 欧/月起
- 宝塔面板：国内 VPS 用户可通过宝塔 + Docker 快速部署

工作流是 n8n 的核心单元，由一组连接的节点（Nodes）组成，定义了数据从输入到处理到输出的完整流程。每个工作流可以：
- 手动触发或自动触发
- 包含分支（IF/Switch）和循环逻辑
- 处理错误和重试
- 被其他工作流调用（子工作流）

节点是工作流的基本构建块，每个节点执行一个特定操作。n8n 提供 400+ 内置节点，分为几类：

触发节点（Trigger）：工作流的起点
- Webhook — 接收 HTTP 请求触发
- Schedule — 按 cron 表达式定时触发
- Email Trigger — 收到邮件时触发
- Telegram/Slack Trigger — 收到消息时触发

操作节点（Action）：执行具体任务
- HTTP Request — 调用任意 API
- Code — 执行 JavaScript / Python 代码
- Gmail / Outlook — 发送邮件
- Google Sheets — 读写表格
- MySQL / PostgreSQL — 数据库操作
- Slack / 飞书 / Telegram — 发送消息

逻辑节点（Flow）：控制流程
- IF — 条件分支
- Switch — 多条件路由
- Loop — 循环处理
- Merge — 合并多个分支的数据
- Wait — 延时等待

凭据用于安全存储第三方服务的认证信息（API Key、OAuth Token 等）。
- 在 n8n 中统一管理，加密存储
- 一个凭据可以被多个工作流复用
- 支持 OAuth2 自动刷新 Token
- 路径：Settings → Credentials → Add Credential

n8n 使用表达式在节点间传递和转换数据，语法基于 JavaScript：

当有人 Star 你的 GitHub 仓库时，自动发送飞书/Slack 通知： 配置步骤：
1. 添加 GitHub Trigger 节点，选择你的仓库，监听 star 事件
2. 添加 IF 节点，条件：{{ $json.action }} === 'created'（新增 Star）
3. 添加飞书/Slack 节点，消息模板：

🌟 新 Star！{{ $json.sender.login }} 给 {{ $json.repository.full_name }} 点了星
当前 Stars: {{ $json.repository.stargazers_count }}

自动聚合多个英文 RSS 源，翻译成中文后推送到 Telegram： 配置步骤：
1. Schedule Trigger：每小时执行一次
2. RSS Read 节点：配置多个新闻源 URL
3. AI Agent / OpenAI 节点：将标题和摘要翻译成中文
4. Telegram 节点：格式化后发送到指定群组
5. 添加 Remove Duplicates 节点避免重复推送

网站表单提交后，自动发送确认邮件并将数据记录到 Google Sheets： 配置步骤：
1. Webhook 节点：创建接收表单数据的 URL
2. 用 Set 节点规范化字段名
3. 并行输出到三个节点：Gmail 发确认信、Sheets 记录数据、Slack 通知团队
4. 将 Webhook URL 配置到你的网站表单 action 属性

监控电商平台新订单，自动回复客户并更新库存：

每天自动备份数据库，失败时发送告警：

# Code 节点中执行备份命令
const { execSync } = require('child_process');
const filename = `backup_${new Date().toISOString().slice(0,10)}.sql`;
try {
  execSync(`pg_dump -h localhost -U n8n n8n > /backups/${filename}`);
  return [{ json: { status: 'success', file: filename } }];
} catch (err) {
  return [{ json: { status: 'failed', error: err.message } }];
}

配合 IF 节点判断状态，失败时发邮件/飞书告警，成功时上传到 S3/OSS。

写一篇文章，自动同步发布到微信公众号、知乎、掘金、Twitter 等多个平台： 利用 AI 节点自动调整内容长度和格式，适配不同平台的要求。

n8n 内置 AI 节点，支持主流 LLM 提供商：
- OpenAI（GPT-4o / GPT-4 Turbo）
- Anthropic（Claude 4.5/4.6 Sonnet/Opus）
- Google（Gemini Pro/Ultra）
- Ollama（本地模型，如 DeepSeek、Llama、Qwen）
- OpenRouter（聚合多家 API）

AI Agent 节点让 LLM 拥有工具调用能力，可以自主决定使用哪些工具完成任务： 例如：用户问"今天北京天气如何？帮我发到群里"，AI Agent 自动调用天气 API → 格式化结果 → 发送到飞书群。

n8n 支持构建 RAG（检索增强生成）知识库工作流：
1. 向量存储：支持 Pinecone、Qdrant、Supabase、PGVector 等
2. 文档加载：从 PDF、网页、Google Drive、Notion 等导入文档
3. Embedding：使用 OpenAI / Ollama 生成向量
4. 检索问答：用户提问 → 检索相关文档 → LLM 生成回答

示例：客户反馈自动分析 利用 LLM 进行情感分析、内容分类、关键词提取、自动摘要等，替代传统的正则表达式和规则引擎。

生产环境必须配置 HTTPS。使用 Nginx 反向代理： 使用 certbot --nginx 自动配置 Let's Encrypt SSL 证书。

定期备份 n8n 数据，防止丢失工作流和凭据：

# SQLite 备份（默认数据库）
cp ~/.n8n/database.sqlite ~/.n8n/backup/database_$(date +%Y%m%d).sqlite

# PostgreSQL 备份
pg_dump -h localhost -U n8n n8n > n8n_backup_$(date +%Y%m%d).sql

# 备份工作流（导出 JSON）
# 在 n8n UI 中：Settings → Export All Workflows

执行日志：n8n 自带工作流执行历史，可查看每次执行的输入输出和耗时。
外部监控：
- 使用 UptimeRobot / Better Uptime 监控 n8n 服务是否在线
- 配置 Docker 健康检查：healthcheck: curl -f http://localhost:5678/healthz
- 重要工作流失败时通过邮件/飞书告警（在工作流中配置 Error Trigger）

- 认证：启用 Basic Auth 或 JWT 认证，禁止匿名访问
- 网络：n8n 端口不要直接暴露到公网，通过 Nginx 反向代理
- 加密密钥：设置 N8N_ENCRYPTION_KEY 加密敏感凭据
- Code 节点限制：设置 N8N_BLOCK_ENV_ACCESS_IN_NODE=true 阻止代码节点读取环境变量
- 执行模式：生产环境设置 EXECUTIONS_MODE=queue + Redis 实现队列模式
- 更新：定期更新到最新版本修复安全漏洞