自承载并发控制
提示
Only for self-hosted n8n 仅适用于自托管 n8n
本文档用于自托管并发控制。阅读 云并发 了解并发如何与 n8n 云帐户配合使用。
在常规模式下,n8n 不限制可以同时运行多少个生产执行。这可能导致过多的并发执行使事件循环过载,导致性能下降和无响应的情况。
为了防止这种情况,您可以在常规模式下为生产执行设置并发限制。使用此功能来控制有多少个生产执行并发运行,并将超过限制的任何并发生产执行排队。这些执行保留在队列中,直到并发容量释放,然后按 FIFO 顺序处理。
并发控制默认情况下是禁用的。要启用它:
export N8N_CONCURRENCY_PRODUCTION_LIMIT=20
请记住:
- 并发控制仅适用于生产执行:从 webhook 或触发器[^1] 节点启动的生产执行。它不适用于任何其他类型,例如手动执行、子工作流执行、错误执行或从 CLI 启动。
- 您无法重试排队执行。取消或删除排队执行也会将其从队列中删除。
-
实例启动时,n8n 恢复排队执行直至并发限制,并将其余执行重新排队。
-
要监视并发控制,请观察日志以了解添加到队列和释放的执行。在未来的版本中,n8n 将在 UI 中显示并发控制。
启用并发控制时,您可以在项目或工作流的执行选项卡顶部查看活动执行数和配置的限制。
与队列模式的比较
在队列模式下,您可以使用 --concurrency 标志 控制一个工作线程可以同时运行多少个作业。
队列模式中的并发控制是与常规模式中的并发控制分离的机制,但环境变量 N8N_CONCURRENCY_PRODUCTION_LIMIT 控制两者。在队列模式下,如果设置为 -1 以外的值,n8n 从此变量获取限制,否则回退到 --concurrency 标志或其默认值。
评估并发数
评估测试运行使用与生产执行不同的并发限制。默认情况下,限制遵循实例的许可证层(社区/专业版 1、商业版 3、企业版 5)。使用 N8N_CONCURRENCY_EVALUATION_LIMIT 覆盖它。请参阅基于指标的评估,了解滑块在 UI 中的行为方式。
[^1]:触发节点是一种特殊节点,负责响应特定条件执行工作流。所有生产工作流程都需要至少一个触发器来确定工作流程何时应运行。