n8n 完全入门指南:从零开始构建你的第一个工作流
2025/01/30

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

详细介绍如何安装配置 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 创建自己的自动化工作流了。记住,最好的学习方式就是动手实践!

相关资源

邮件列表

加入我们的社区

订阅邮件列表,及时获取最新消息和更新