n8n 完全入门指南：从零开始构建你的第一个工作流

什么是 n8n？

n8n 是一个开源的工作流自动化工具，让你可以通过可视化界面连接不同的应用和服务，实现业务流程的自动化。与传统的编程方式不同，n8n 采用节点式的图形化界面，让非技术用户也能轻松创建复杂的自动化流程。

n8n 的核心优势

• 开源免费：完全开源，可自由部署和定制
• 可视化设计：拖拽式界面，无需编程基础
• 丰富集成：支持 400+ 应用和服务的连接
• 灵活部署：支持云端、自托管等多种部署方式
• 强大扩展：支持自定义节点和代码执行

安装 n8n

方法一：使用 npm 安装（推荐）

确保你的系统已安装 Node.js 18.10 或更高版本，然后运行：

npm install n8n -g

安装完成后，启动 n8n：

n8n start

方法二：使用 Docker

如果你熟悉 Docker，可以使用以下命令快速启动：

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  n8nio/n8n

方法三：使用 n8n 云服务

如果你不想自己部署，可以直接使用我们的 n8n 云服务：

1. 访问 cloud.n8ncn.io
2. 注册账户并创建工作空间
3. 立即开始创建工作流

安装完成后，在浏览器中访问 http://localhost:5678 即可看到 n8n 的管理界面。

创建你的第一个工作流

让我们通过一个简单的例子来学习如何使用 n8n。我们将创建一个自动化工作流，当收到新邮件时，自动将邮件信息发送到 Slack 频道。

步骤 1：创建新工作流

1. 在 n8n 界面中点击 "New Workflow"
2. 你会看到一个空白的画布，中央有一个 "Start" 节点

步骤 2：添加触发器节点

1. 点击 "Start" 节点右侧的 "+" 按钮
2. 在弹出的节点面板中搜索 "Gmail Trigger"
3. 选择并添加 Gmail Trigger 节点

步骤 3：配置 Gmail 触发器

1. 点击 Gmail Trigger 节点

2. 在右侧面板中配置以下参数：

   • Credential: 点击创建新的 Gmail 凭证
   • Event: 选择 "Message Received"
   • Simple: 选择 "No"，以获取更多邮件详细信息

3. 配置 Gmail 凭证：

   • 点击 "Create New Credential"
   • 选择 "Gmail OAuth2 API"
   • 按照指引完成 Google OAuth 授权

步骤 4：添加 Slack 节点

1. 点击 Gmail Trigger 节点右侧的 "+" 按钮
2. 搜索并选择 "Slack" 节点
3. 选择 "Post Message" 操作

步骤 5：配置 Slack 节点

1. 创建 Slack 凭证：

   • 在 Slack 应用中创建一个应用
   • 获取 Bot Token
   • 在 n8n 中创建 Slack OAuth2 API 凭证

2. 配置消息参数：

   • Channel: 选择要发送消息的频道
   • Text: 编写消息内容，可以使用表达式引用 Gmail 数据

示例消息内容：

新邮件提醒 📧

发件人：{{$node["Gmail Trigger"].json["payload"]["headers"][0]["value"]}}
主题：{{$node["Gmail Trigger"].json["payload"]["headers"][1]["value"]}}
时间：{{$node["Gmail Trigger"].json["internalDate"]}}

步骤 6：测试工作流

1. 点击界面顶部的 "Test Workflow" 按钮
2. 工作流会开始监听 Gmail 触发器
3. 向你的 Gmail 账户发送一封测试邮件
4. 查看 Slack 频道是否收到通知消息

步骤 7：保存并激活工作流

1. 点击 "Save" 按钮保存工作流
2. 为工作流命名，例如 "Gmail to Slack 通知"
3. 点击右上角的开关按钮激活工作流

工作流基础概念

节点类型

• 触发器节点（Trigger Nodes）：启动工作流执行的节点，如定时器、Webhook、文件监控等
• 常规节点（Regular Nodes）：执行特定操作的节点，如发送邮件、API 调用、数据处理等
• 控制流节点（Control Flow Nodes）：控制工作流执行逻辑，如条件判断、循环、合并等

数据流转

n8n 中的数据以 JSON 格式在节点之间传递：

{
  "id": 1,
  "name": "John Doe",
  "email": "[email protected]",
  "timestamp": "2025-01-30T10:00:00Z"
}

表达式和函数

n8n 支持强大的表达式系统，让你可以动态处理数据：

• {{$json.fieldName}}：访问当前节点的 JSON 数据
• {{$node["NodeName"].json.fieldName}}：访问指定节点的数据
• {{$now}}：获取当前时间戳
• {{$json.name.toLowerCase()}}：使用 JavaScript 函数处理数据

常用工作流模式

1. 数据同步

定期从一个系统读取数据，并同步到另一个系统：

Schedule Trigger → Read Data → Transform Data → Write Data

2. 通知系统

监听事件并发送通知：

Event Trigger → Condition Check → Send Notification

3. 数据处理管道

处理和转换数据：

Data Input → Validate → Transform → Filter → Output

实用技巧

1. 使用错误处理

为关键节点添加错误处理，确保工作流稳定运行：

1. 右键点击节点
2. 选择 "Add Error Trigger"
3. 配置错误处理逻辑

2. 调试工作流

• 使用 "Execute Node" 功能单独测试节点
• 查看节点执行结果中的 JSON 数据
• 使用 "Set" 节点添加调试信息

3. 优化性能

• 使用批处理减少 API 调用次数
• 合理设置触发器频率
• 避免创建过于复杂的单个工作流

下一步

现在你已经掌握了 n8n 的基础知识！接下来可以：

1. 探索更多节点和集成选项
2. 学习高级功能如子工作流、代码节点
3. 加入 n8n 社区获取更多资源和支持
4. 查看我们的其他教程了解最佳实践

常见问题

Q: n8n 免费吗？

A: n8n 核心功能完全免费开源。n8n.cloud 提供免费套餐，包含 5,000 次工作流执行。

Q: 可以连接哪些应用？

A: n8n 支持 400+ 应用，包括 Google Workspace、Microsoft 365、Slack、Notion、Airtable 等主流服务。

Q: 数据安全如何保障？

A: 如果使用自托管部署，所有数据都在你的控制下。我们的云服务也提供企业级安全保障。

通过这个入门指南，你应该能够开始使用 n8n 创建自己的自动化工作流了。记住，最好的学习方式就是动手实践！

相关资源

• n8n 中文官方文档
• n8n 云服务平台
• n8n 入门教程
• 工作流最佳实践
• n8ncn.io 官方网站
• 更多工作流案例