N8N中文教程
使用 n8n/Getting_started/Quickstarts

你的第一个工作流#

本指南将向你展示如何在 n8n 中构建一个 工作流，并在过程中解释关键概念。你将完成以下任务：

  • 从零开始创建一个工作流。
  • 理解关键概念和技能，包括：
    • 使用触发节点（trigger nodes）启动工作流
    • 配置 凭据（credentials）
    • 处理数据
    • 在 n8n 工作流中表示逻辑
    • 使用 表达式（expressions）

"已完成工作流的截图" 本快速入门使用 n8n Cloud，这是推荐给新用户的选项。提供免费试用——如果你尚未注册，请立即注册一个账户。

第一步：创建一个新的工作流#

打开 n8n 后，你会看到以下两种界面之一：

  • 一个带有欢迎信息的窗口，以及两个大按钮：选择 Start from Scratch（从空白开始） 来创建新的工作流。
  • 概览（Overview） 页面上的 工作流（Workflows） 列表。点击 Create Workflow（创建工作流） 来新建一个工作流。

第二步：添加一个触发节点#

n8n 提供了两种启动工作流的方式：

  • 手动方式：通过点击 Execute Workflow（执行工作流）。
  • 自动方式：使用一个触发节点作为第一个节点。该触发节点会根据外部事件或你的设置自动运行工作流。

在本教程中，我们将使用 Schedule trigger（计划触发器）。这允许你按计划运行工作流：

  1. 点击 Add first step（添加第一步）。
  2. 搜索 Schedule（计划）。n8n 将显示与搜索匹配的节点列表。
  3. 选择 Schedule Trigger（计划触发器） 将该节点添加到画布上。n8n 会自动打开该节点配置面板。
  4. 在 Trigger Interval（触发间隔） 中选择 Weeks（周）。
  5. 在 Weeks Between Triggers（触发器之间的周数） 中输入 1。
  6. 设置具体的时间和日期。本示例中，在 Trigger on Weekdays（在工作日触发） 中选择 Monday（星期一），在 Trigger at Hour（小时触发） 中选择 9am（上午9点），在 Trigger at Minute（分钟触发） 中输入 0。
  7. 关闭节点详情视图，返回画布。

第三步：添加 NASA 节点并设置凭证#

NASA 节点 可与 NASA 的公共 API 交互，以获取有用的数据。我们将使用该 API 的实时数据来查找太阳活动事件。

凭证（Credentials）

凭证是应用程序或服务颁发的私密信息，用于验证您的用户身份，并允许您在应用/服务与 n8n 节点之间建立连接并共享信息。不同应用/服务所需的凭证信息类型各不相同。请务必谨慎对待凭证，切勿在 n8n 外部随意分享或泄露。

  1. 在“计划触发器”（Schedule Trigger）节点上选择 添加节点（Add node）!Add node icon 连接器。
  2. 搜索 NASA。n8n 将显示与搜索词匹配的节点列表。
  3. 选择 NASA，查看可用的操作列表。
  4. 搜索并选择 Get a DONKI solar flare（获取 DONKI 太阳耀斑数据）。此操作将返回有关最近太阳耀斑的报告。选择该操作后，n8n 会将该节点添加到画布中并自动打开。
  5. 要访问 NASA 的 API，您需要设置凭证：
  6. 选择 Credential for NASA API（NASA API 凭证）下拉菜单。
  7. 选择 Create new credential（创建新凭证）。n8n 将打开凭证配置界面。
  8. 前往 NASA APIs 页面，点击 Generate API Key（生成 API 密钥）链接并填写表单。NASA 网站将生成密钥并通过电子邮件发送至您提供的邮箱地址。
  9. 查看您的邮箱以获取 API 密钥。复制该密钥，并粘贴到 n8n 中的 API Key（API 密钥）字段。
  10. 点击 Save（保存）。
  11. 关闭凭证配置界面。n8n 将返回节点编辑界面，新的凭证应已自动选中并显示在 Credential for NASA API 中。
  12. 默认情况下，DONKI Solar Flare 提供过去 30 天的数据。若要限制为仅过去一周的数据，请使用 附加字段（Additional Fields）：
  13. 点击 Add field（添加字段）。
  14. 选择 Start date（开始日期）。
  15. 若要获取从一周前开始的报告，可以使用表达式：在 Start date 旁边，选择 Expression（表达式）选项卡，然后点击展开按钮 !Add node icon 打开完整的表达式编辑器。
  16. 在 Expression（表达式）字段中输入以下内容：
{{$today.minus(7,'days')}}

---|---
这将生成一个正确格式的日期，即当前日期的七天前。
[显示上述表达式生成日期的图片](https://docs.n8n.io/_images/try-it-out/tutorial-date.png)
n8n 中的日期和时间格式...
n8n 使用 Luxon 来处理日期和时间，并提供了两个便捷变量：`$now` 和 `$today`。更多信息请参见 Expressions > Luxon。
  7. 关闭 **Edit Expression**（编辑表达式）弹窗，返回到 NASA 节点。
  8. 现在可以检查节点是否正常工作并返回预期的日期：选择 **Execute step**（执行步骤）以手动运行该节点。n8n 将调用 NASA API，并在 **OUTPUT**（输出）部分显示过去七天内太阳耀斑的详细信息。
  9. 关闭 NASA 节点，返回工作流画布。

## 第四步：使用 If 节点添加逻辑 #
n8n 支持在工作流中实现复杂的逻辑。本教程中，我们将使用 If 节点 创建两个分支，分别基于 NASA 数据生成报告。太阳耀斑有五种可能的分类；我们将添加逻辑，将较低级别的分类发送到一个输出，更高级别的分类发送到另一个输出。
添加 If 节点：
  1. 在 NASA 节点上选择 **Add node**（添加节点）!Add node icon 连接器。
  2. 搜索 **If**。n8n 会显示与搜索匹配的节点列表。
  3. 选择 **If** 将该节点添加到画布。n8n 会打开该节点。
  4. 你需要检查 NASA 数据中 `classType` 属性的值。为此：
    1. 将 **classType** 拖入 **Value 1**（值 1）。
> **确保已在上一步中运行了 NASA 节点**
> 如果你没有按照上一节中的步骤运行 NASA 节点，则在此步骤中将看不到任何可用数据。

    2. 将比较操作更改为 **String > Contains**（字符串 > 包含）。
    3. 在 **Value 2**（值 2）中输入 **X**。这是太阳耀斑的最高级别分类。在下一步中，你将创建两份报告：一份用于 X 级太阳耀斑，另一份用于所有较小级别的太阳耀斑。
    4. 现在可以检查节点是否正常工作并返回预期结果：选择 **Execute step**（执行步骤）以手动运行节点。n8n 会根据条件测试数据，并在 **OUTPUT**（输出）面板中显示哪些结果为 true 或 false。
> **没有大级别太阳耀斑的周**
> 本教程使用的是实时数据。如果你运行工作流时发现没有任何 X 级太阳耀斑，可以尝试将 **Value 2** 中的 **X** 替换为 **A**、**B**、**C** 或 **M**。

  5. 当你确认节点能够返回一些事件后，即可关闭节点，返回画布。

第五步：从工作流输出数据#

工作流的最后一步是发送两条关于太阳耀斑的报告。在本示例中，你将把数据发送到 Postbin。Postbin 是一项接收数据并在临时网页上显示数据的服务。

  1. 在 If 节点上，选择标记为 true 的 添加节点 !Add node icon 连接器。
  2. 搜索 PostBin。n8n 会显示与搜索匹配的节点列表。
  3. 选择 PostBin。
  4. 选择 Send a request（发送请求）。n8n 会将该节点添加到画布并打开它。
  5. 前往 Postbin 并点击 Create Bin（创建 Bin）。请保持该标签页打开，以便稍后测试工作流时使用。
  6. 复制 bin ID，其格式类似于 1651063625300-2016451240051。
  7. 在 n8n 中，将你的 Postbin ID 粘贴到 Bin ID 字段中。
  8. 接下来，配置要发送到 Postbin 的数据。在 Bin Content（Bin 内容）旁边，选择 Expression（表达式）选项卡（需要将鼠标悬停在 Bin Content 上才会显示该选项卡），然后选择展开按钮 !Add node icon 以打开完整的表达式编辑器。
  9. 现在，你可以直接从 If 节点的输出中点击并拖拽正确的字段到表达式编辑器中，从而自动生成对该字段的引用。本例中我们所需的输入是 'classType'。
  10. 将该字段拖入表达式编辑器后，会自动转换为如下引用形式：{{$json["classType"]}}。为其添加一条消息，使完整表达式变为：
1

| ``` Therewasasolarflareofclass{{$json["classType"]}}


---|---
[image showing the expression above generating output](https://docs.n8n.io/_images/try-it-out/tutorial-expression.png)
11. 关闭表达式编辑器，返回节点配置界面。
12. 关闭 Postbin 节点，返回画布。
13. 添加另一个 Postbin 节点，用于处理 If 节点的 **false** 输出路径：
    1. 将鼠标悬停在 Postbin 节点上，然后选择 **Node context menu**（节点上下文菜单）!Node context menu icon > **Duplicate node**（复制节点），以复制第一个 Postbin 节点。
    2. 将 If 节点的 **false** 连接器拖动到新 Postbin 节点的左侧。

## 第六步：测试工作流#
  1. 现在你可以测试整个工作流了。选择 **Execute Workflow（执行工作流）**。n8n 将运行该工作流，并显示每个阶段的执行进度。
  2. 返回到你的 Postbin 存储桶（bin）。刷新页面以查看输出结果。
  3. 如果你希望使用此工作流（换句话说，希望它每周自动运行一次），你需要通过点击 **Active（激活）** 开关来激活它。

时间限制
Postbin 的存储桶在创建后仅保留 30 分钟。如果你超出此时间限制，可能需要创建一个新的存储桶，并在 Postbin 节点中更新其 ID。

## 恭喜！#
你现在拥有了一个功能完整且能完成实际任务的工作流！它应该看起来像这样：
查看工作流文件

在此过程中，你已经学会了：
  * 如何查找所需的节点并将其连接起来
  * 如何使用表达式（expressions）来处理数据
  * 如何创建凭据（credentials）并将其附加到节点上
  * 如何在工作流中使用逻辑控制

你可以在此基础上添加更多功能（例如增加更多凭据，或添加一个节点将结果通过电子邮件发送给你），或者你可能已经有具体项目计划。无论下一步是什么，以下推荐资源都会对你有所帮助。

## 下一步#
  * 对 AI 功能感兴趣？了解 如何使用 n8n 构建 AI 聊天代理。
  * 参加 n8n 的 文本课程 或 视频课程。
  * 在 工作流模板库 中探索更多示例。

选择你的 n8n

Previous Page

极速快速入门

Next Page