【n8n教程】：n8n扩展和性能优化指南

随着n8n自动化流程的运用越来越广泛，当你的工作流数量增多、用户数增加、执行量飙升时，单一实例的n8n将会暴露出性能瓶颈。本教程将从初学者的角度，用通俗易懂的语言，帮助你理解和实现n8n的扩展策略，让你的工作流能够轻松处理大规模业务需求。

核心要点：n8n在单实例下最多能处理220个工作流执行/秒，但通过启用队列模式（Queue Mode），你可以实现水平扩展，添加工作节点以处理更高的并发执行量。

1.1 单实例的局限性

想象一下，你的n8n工作流正在处理来自多个webhook的请求。当请求数超过单个实例能处理的能力时，会发生什么？

• 长响应时间：用户需要等待更长时间才能得到结果
• 队列堆积：新请求排队等待，系统变得不稳定
• 内存溢出：处理大文件时容易出现”JavaScript heap out of memory”错误
• 整个系统崩溃：当负载达到峰值时，甚至无法访问n8n编辑界面

官方基准测试显示，在标准硬件上（4GB内存），单实例n8n在100-200并发用户时就开始出现显著延迟。

1.2 三个关键性能指标

2.1 两种运行模式对比

单一模式（Single/Main Mode）

• 一个n8n实例做所有事情
• 处理webhook请求、执行工作流、管理编辑界面
• 简单但不可扩展

队列模式（Queue Mode）

• 分离职责：主实例、工作节点、webhook节点各司其职
• 主实例：处理UI、API请求、接收webhook
• 工作节点：执行实际的工作流任务
• Redis：作为消息队列连接所有组件
• PostgreSQL：存储数据和执行结果

队列模式的性能提升是显著的：根据官方基准测试，相同硬件下，队列模式的吞吐量比单一模式高出10倍。

2.2 队列模式的执行流程

3.1 前置条件

在开始配置前，请确保你已经准备好：

• PostgreSQL数据库（推荐版本13+）：n8n需要存储所有配置和执行历史
• Redis服务：用作消息队列，连接主实例和工作节点
• 多台服务器或容器：分别运行主实例、工作节点
• 加密密钥：确保主实例和所有工作节点使用相同的加密密钥

3.2 配置加密密钥

所有n8n实例必须共享相同的加密密钥，以访问数据库中的凭证：

3.3 启用Redis

Redis充当主实例和工作节点之间的消息代理：

3.4 配置主实例

3.5 启动工作节点

工作节点是实际执行工作流的地方。每个工作节点都是独立的Node.js进程：

并发参数解析：

• ：每个工作节点最多同时处理10个任务
• 建议值：5-15（太低会浪费资源，太高会耗尽数据库连接）

3.6 可选：配置Webhook处理节点

如果你的工作流接收大量webhook请求，可以部署专门的webhook处理节点：

4.1 数据管理：执行数据裁剪

随着时间推移，n8n数据库会积累大量的执行记录。这会导致数据库变慢。解决方案是启用执行数据自动裁剪：

工作流级别配置：

在工作流设置中，你可以选择只保存失败的执行记录，或者根本不保存执行数据，这样可以大幅减少数据库膨胀：

1. 打开工作流 → 点击设置图标
2. 在”执行”部分，选择”Save only error executions”
3. 保存

4.2 二进制数据处理

处理大型文件（图片、PDF等）时需要特别注意，否则会导致内存溢出：

4.3 并发控制

防止太多并发执行导致系统过载：

4.4 工作流设计优化

问题识别： 使用大型Code节点进行复杂计算

最佳实践：

1. 分批处理数据：不要一次性处理10,000条记录，改为每批处理200条
2. 避免使用Code节点：使用原生节点和表达式替代
3. 避免手动执行大数据：手动执行会在内存中复制数据用于前端显示
4. 使用子工作流：将工作流分解为多个小工作流，每个只处理一批数据

5.1 识别内存问题

常见的内存错误信息：

5.2 解决方案

短期：增加可用内存

长期：优化工作流

• 减少每批处理的数据量
• 在循环中处理数据时及时释放
• 使用过滤节点早期排除不需要的数据

6.1 案例描述

我们要构建一个webhook API，用于：

1. 接收来自外部系统的订单数据
2. 验证订单数据
3. 调用外部API获取汇率
4. 转换为USD货币并保存到Google Sheets

n8n 工作流 教程

5. 返回处理结果给调用者

6.2 工作流JSON代码

复制下面的JSON到n8n中（点击”New” → 选择”Import from URL or File” → 粘贴JSON）：

6.3 测试工作流

1. 激活工作流：点击右上角的”Activate”按钮
2. 获取Webhook URL：从Webhook Trigger节点复制生产URL
3. 发送测试请求：

预期响应：

7.1 关键指标监控

使用这些环境变量启用详细日志：

7.2 常见问题排查

n8n的扩展从简单的配置开始，但需要理解关键概念：

1. 理解瓶颈：单实例模式无法应对高并发
2. 采用队列模式：分离主实例、工作节点、webhook节点
3. 正确配置：Redis、PostgreSQL、加密密钥
4. 持续优化：数据裁剪、二进制数据管理、并发控制
5. 工作流设计：分批处理、避免重型节点、子工作流分解

按照本教程的步骤，你就能够构建一个可以处理数千并发请求的生产级n8n系统。