开源自动化工具 n8n 实战：从部署到创建AI工作流

n8n 是一款开源且功能强大的工作流自动化工具。它允许用户通过可视化方式连接不同的应用程序和服务，将 AI 功能与业务流程自动化相结合，帮助开发者和非技术人员创建复杂的数据处理与传输流程。

GitHub: https://github.com/n8n-io/n8n
官网: https://n8n.io
文档: https://docs.n8n.io

安装

1. npx 安装

若要在本地快速体验，可以使用 npx 方式启动，前提是已安装 Node.js。

npx n8n

2. Docker 安装

使用 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

常用数据卷操作命令：

# 列出所有卷
docker volume ls
# 查看卷详情
docker volume inspect <name>
# 删除单个卷
docker volume rm <name>
# 清理无用卷
docker volume prune
# 强制删除卷
docker volume rm -f <name>
# 手动删除文件
sudo rm -rf /var/lib/docker/volumes/<name>

直接挂载宿主机目录
如果不习惯使用 Docker 数据卷，也可以直接挂载宿主机目录。

cd /opt/n8n
# 创建目录并赋予正确权限
mkdir data
sudo chown -R 1000:1000 ./data  # n8n容器默认以用户 node（UID 1000）运行
sudo chmod -R 755 ./data
# 运行容器
docker run -itd --name n8n -p 5678:5678 -v ./data:/home/node/.n8n docker.n8n.io/n8nio/n8n

注册账号

启动成功后，在浏览器中访问 http://localhost:5678，首先需要注册一个管理员账号。

接着，根据提示完善账号信息，例如公司规模、个人角色等。

注册流程中，n8n 会提供一个免费获取高级功能（如工作流历史、高级调试等）永久激活密钥的机会，只需输入邮箱接收许可证密钥即可。

收到许可证密钥后，在 Settings -> Usage and plan 项下输入密钥以激活这些额外的付费功能。

核心概念

综述

在深入实践前，了解 n8n 的几个核心概念至关重要，这有助于你更好地设计工作流。n8n 的 技术文档 对这些概念有更深入的阐述。

1. 工作流 (Workflow)：由多个节点组成的自动化流程，可以手动触发或按计划执行。
2. 节点 (Node)：工作流的基本构建块，每个节点代表一个特定操作：
   • 触发器节点（如：定时器、Webhook）
   • 工作节点（如：HTTP请求、数据库查询）
   • 逻辑节点（如：IF条件、合并）
3. 连接 (Connection)：节点间的箭头，定义了数据流动的方向和处理的顺序。

触发器

创建工作流的第一步就是选择一个触发器。触发器决定了工作流在什么条件下启动。

• 手动触发：点击 n8n 中的按钮即可运行流程。
• 应用事件：当 Telegram、Notion 或 Airtable 等应用中发生某些事情时运行流程。
• 按计划进行：每天、每小时或自定义间隔运行流程。
• 在 webhook 调用时：在收到 HTTP 请求时运行流程。
• 表单提交时：在 n8n 中生成 Web 表单并将其响应传递给工作流。
• 由另一个工作流执行时：当被来自不同工作流的“执行工作流”节点调用时运行。
• 在聊天消息中：当用户发送聊天消息时运行此流程。适用于 AI 节点。
• 其他方法：在工作流错误、文件更改等情况下运行流程。

工作节点

添加触发器后，需要添加工作节点来执行具体任务。n8n 提供了丰富的节点库，按功能分类。

• 人工智能：构建自主代理，总结或搜索文档等。
• 应用程序中的操作：在 Google Sheets、Telegram 或 Notion 等应用或服务中执行某些操作。
• 数据转换：操作、过滤或转换数据。
• 流动：分支、合并或循环流程等。
• 核心：运行代码、发出 HTTP 请求、设置 webhook 等。
• 人机互动：等待批准或人工输入后再继续。

实战：创建一个 AI 工作流

接下来，我们通过一个具体案例来学习如何构建一个完整的工作流：定时获取微博热点数据，交由 AI 大模型分析整理，最后通过邮件发送结果。

1. 设置定时触发器

新建一个工作流，选择能定时执行的触发器：On a Schedule。

配置触发规则。例如，设置每间隔 10 秒执行一次（仅用于测试）。特别注意 TimeZone 时区的设置，确保与你的实际需求一致。

如需修改整个工作流的默认时区，可以在工作流设置中进行更改。

2. 添加 HTTP 请求节点

在 Core 节点分类下，添加一个 HTTP Request 节点，用于定时发送请求获取微博热点数据。

在节点配置中，填入微博热点 API 的 URL 和必要的参数，然后点击 Test Step 测试接口，确保能正确获取数据。

3. 数据转换处理

在 Data transformation 分类下，添加一个 Edit Fields (Set) 节点，用于提取和重塑我们需要的数据字段。

在字段编辑界面，左侧是上一节点输出的原始数据。将需要的字段（例如 data 数组）拖拽到中间的 Fields to Set 区域，并设置好数据类型，然后点击 Test Step 查看输出结果。

4. 集成 AI 智能体

接下来，让 AI 来处理这些数据。在 AI Nodes 分类下，添加一个 AI Agent 节点。

配置 AI Agent 的自定义提示词。一个方便的特性是，你可以直接从左侧的数据面板拖拽字段（如 $json.data）到提示词输入框中，实现动态数据注入。

5. 连接大语言模型

添加 AI Agent 后，工作流图上会出现一个子节点 Chat Model，点击它来配置具体使用的大语言模型。

这里以 DeepSeek 模型为例。首先需要添加模型 API 的令牌凭证，然后在模型列表中选择 deepseek-chat。

配置完成后，回到 AI Agent 节点的详情页，再次点击 Test Step，右侧将输出 AI 整理后的最终结果。

6. 添加邮件发送节点

AI 处理的结果可以通过多种方式输出。例如，我们可以使用 Send Email 节点将结果发送到指定邮箱。

7. 测试与激活工作流

工作流配置完成后，点击画布右上角的 Test workflow 按钮进行端到端测试。

测试无误后，返回工作流列表页面，将工作流的状态开关设置为 Active，即可激活这个自动化流程。

在 Executions 标签页下，可以清晰地看到工作流每一次的执行记录，包括状态、开始时间、运行时长等，验证其是否按计划（每10秒）运行。

使用工作流模板

n8n 提供了海量的预制工作流模板，涵盖 AI、运维、市场、销售等各种场景，能让你快速上手。

例如，在“新手必备”模板中，有一个“创建 API 端点”的教程模板。

点击 Use for free，然后选择 Copy template to clipboard [JSON]，即可将模板复制到剪贴板。

在 n8n 中新建一个空白工作流，使用 Ctrl + V 粘贴，即可将完整的模板工作流导入到你的工作区，直接使用或学习其结构。

丰富的应用集成

n8n 的强大之处在于其庞大的集成生态，支持超过一千种应用和服务，可以实现真正意义上的“万物互联”。

点击任意一个集成（如 MySQL），会跳转到详细的集成指南页面，其中包含使用说明和示例工作流模板。

社区与支持

n8n 拥有一个活跃的官方社区论坛。在这里，你可以提问、寻找答案、分享自己构建的自动化方案，或者学习社区教程。对于希望深入掌握这一 开源实战 工具的朋友来说，这里是宝贵的资源库。

通过以上步骤，我们完成了一个从零开始，涵盖触发器、数据处理、AI集成到结果输出的完整自动化工作流构建。n8n 以其可视化、模块化的设计，极大地降低了 工作流自动化 的入门门槛，无论是简单的数据同步还是复杂的智能业务流程，都能找到用武之地。如果你对这类提升效率的工具感兴趣，不妨在 云栈社区 与其他开发者交流更多使用心得和创意玩法。