n8n-io/n8n · 上手攻略

• 仓库：n8n-io/n8n
• 链接：https://github.com/n8n-io/n8n
• 分类：agent / workflow-automation
• 作者：Jay
• 更新：2026-07-09

是什么

n8n（发音 "n-eight-n"，即 "nodemation"）是一个 fair-code 模式的工作流自动化平台，融合可视化画布（canvas）和代码能力，支持自托管或云端部署，内置 AI 原生功能，宣称拥有 1500+ 集成节点、9000+ 模板。

核心理念："Visual building meets custom code" —— 非技术人员用拖拽画布搭工作流，技术团队在需要时写 JavaScript / Python 或引入 npm 包扩展。

许可证模式：Sustainable Use License（自定义 fair-code 许可证）。源码可见（始终开放），可自托管、可扩展，添加自己的节点；但商业使用有条件限制，企业功能需购买 n8n Enterprise License。注意：含 .ee. 的源码文件不在开源范围内。

Stars：195,743 · 周增：+406 · 语言：TypeScript/Node.js

解决什么问题

1. 跨系统自动化：将 CRM、邮件、数据库、Slack、GitHub 等 1500+ 服务串联，无需写胶水代码。
2. AI 工作流平权：让非 ML 工程师也能通过拖拽构建多步骤 AI Agent、LangChain 链、RAG Pipeline。
3. 数据主权：支持全自托管，数据不出本地，适合金融、医疗等敏感行业。
4. 从原型到生产：同一套工作流可先在本地快速原型验证，再部署到生产环境。
5. 复杂逻辑支持：分支、循环、等待、人工审批、错误处理等企业级控制流。

快速安装

方式一：npx（最简，无需安装）

# 需先安装 Node.js (https://nodejs.org/)
npx n8n
# 访问 http://localhost:5678

方式二：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

方式三：npm 全局安装

npm install -g n8n
n8n

方式四：云端（无需自托管）

直接访问 app.n8n.cloud 注册使用，付费版提供企业功能。

核心用法

1. 基本概念

2. 第一个工作流：定时抓取 RSS → 发送 Slack

[Schedule Trigger] → [HTTP Request] → [Slack Message] → [Error Workflow]

步骤： 1. 打开 http://localhost:5678，点击 + New Workflow 2. 在触发区域搜索 Schedule Trigger，设置每 1 小时执行 3. 点击 + 添加节点，搜索 HTTP Request，填入 RSS URL 4. 再添加 Slack 节点，配置 Webhook URL（Incoming Webhook） 5. 在 Slack 消息内容中用表达式引用 {{ $json["items"][0]["title"] }} 等字段 6. 点击 Activate 激活工作流

3. AI Agent 工作流（核心 AI 功能）

n8n 内置多类 AI 节点，支持构建多步骤 Agent：

[Chat Trigger] → [AI Agent] → [Tool: Wikipedia] → [Tool: Calculator] → [Respond to User]

关键节点： - AI Agent：支持 OpenAI、Anthropic、Google、Ollama 等模型，可配置系统提示、工具集 - LangChain Chain：RAG、摘要、提取等预制链 - Embeddings：本地或 API 向量化 - Vector Store：Pinecone、Weaviate、Qdrant 等

4. 自定义代码节点

在任意位置插入 Code 节点，写 JavaScript：

// 读取上一个节点的输出
const items = $input.all();
const processed = items.map(item => {
  const text = item.json.text;
  return {
    json: {
      wordCount: text.split(/\s+/).length,
      uppercase: text.toUpperCase()
    }
  };
});
return processed;

5. 手动触发与 Webhook

手动触发（测试用）：点击 workflow 页面右侧 Test Workflow
Webhook 触发（生产）：创建 Webhook 节点，复制 URL 供外部调用

# 触发一个 n8n webhook
curl -X POST https://your-n8n.com/webhook/your-workflow-id \
  -H "Content-Type: application/json" \
  -d '{"key": "value"}'

6. 错误处理

• Error Workflow：为整个 workflow 设置全局错误处理分支
• Retry：节点级别设置失败重试次数和间隔
• Continue: 在节点配置中决定出错时的下一步行为（继续/停止/分支）

7. 模板市场

访问 n8n.io/workflows 直接导入 9000+ 模板，快速启动常见场景（CRM 同步、邮件自动化、社交媒体管理等）。

典型适用场景

1. AI + 业务系统集成：定时调用 LLM 分析客户邮件、自动分类写入 CRM，零代码链路。
2. 跨平台数据同步：HubSpot ↔ Salesforce ↔ Google Sheets 双向同步，用 workflow 编排字段映射。
3. 无服务器后端（Backendless）：用 Webhook + Code 节点做轻量 API，不需要独立后端服务。
4. 数据 ETL Pipeline：从多个 API 拉取数据 → 清洗 → 写入数据仓库。
5. 监控告警自动化：服务器告警 → 分析日志 → 判断级别 → 发 Slack / 邮件 / 创建 Jira 工单。
6. RAG 数据管道：PDF/文档提取 → 向量化 → 存入向量数据库，配合 AI Agent 做问答。

坑与注意

1. 许可证限制：Sustainable Use License 禁止商业收费分发（不得作为 SaaS 服务提供给第三方免费使用）；企业内部使用需确认许可证条款，复杂商业场景建议购 Enterprise License。
2. .ee. 企业代码不开源：部分高级功能（如特定审计、合规功能）在 .ee. 目录下，源码可见但许可证限制使用，需购买企业授权。
3. 大规模并发的长尾延迟：n8n 基于 Node.js 单线程，适合中低频、中等复杂度任务；高频海量并发场景（如每秒数千次触发）建议评估是否有更合适的方案。
4. 凭证安全：n8n 凭证加密存储在本地数据库，但自托管时需确保数据库访问控制，否则凭证文件可能泄露。
5. Docker 持久化：务必备份 n8n_data volume，否则 workflow 配置和凭证会随容器销毁丢失。
6. 更新频率高但 breaking change 有时存在：大版本升级时自定义节点或表达式语法可能不兼容，升级前建议在测试环境验证。
7. AI 节点 Token 消耗：AI Agent 节点在循环/长对话中 Token 消耗较快，建议设置最大迭代次数和 Token 限制，防止意外超额。

与同类对比

核心差异： - n8n vs Zapier/Make：n8n 源码开放、允许自托管，但 UI 友好度略低，更适合技术团队。 - n8n vs Windmill：Windmill 用 TypeScript/Bun，n8n 用 Node.js/TypeScript；n8n 可视化更强，Windmill 代码原生更好。 - n8n 许可证较特殊（可持续使用许可证），非完全开源，介意者需注意商业使用合规性。

一句话推荐结论

技术团队如果需要完全掌控数据、同时享用强大 AI Agent 能力和 1500+ 集成的可视化工作流，n8n 是最平衡的开源选择；但部署前务必确认 Sustainable Use License 的商业使用限制条款是否符合你的场景。