执行环境变量(Executions environment variables)#
File-based configuration
You can add _FILE to individual variables to provide their configuration in a separate file. Refer to Keeping sensitive data in separate files for more details.
本页列出用于配置工作流执行设置的环境变量。
🌐 This page lists environment variables to configure workflow execution settings.
| 变量 | 类型 | 默认值 | 描述 |
| :------- | :---- | :------- | :---------- |
| EXECUTIONS_MODE | 枚举字符串：regular，queue | regular | 执行是否应直接运行或使用队列。
更多详情请参阅队列模式。 |
| EXECUTIONS_TIMEOUT | 数字 | -1 | 为所有工作流设置默认超时时间（以秒为单位），超过该时间 n8n 会停止其执行。用户可以为单个工作流覆盖此设置，但最长不超过 EXECUTIONS_TIMEOUT_MAX 中设置的时间。将 EXECUTIONS_TIMEOUT 设置为 -1 可禁用此功能。 |
| EXECUTIONS_TIMEOUT_MAX | 数字 | 3600 | 用户可以为单个工作流设置的最大执行时间（以秒为单位）。 |
| N8N_AI_TIMEOUT_MAX | 数字 | 3600000 | 设置 AI 和 LLM 节点（如 OpenAI、Anthropic、Mistral 和 Ollama）的 HTTP 请求超时时间（以毫秒为单位）。这控制 n8n 在超时之前等待 AI 服务响应的时间。对于较慢的本地 AI 服务或需要更长处理时间的复杂提示非常有用。 |
| EXECUTIONS_DATA_SAVE_ON_ERROR | 枚举字符串：all，none | all | n8n 在出错时是否保存执行数据。 |
| EXECUTIONS_DATA_SAVE_ON_SUCCESS | 枚举字符串：all，none | all | n8n 在成功时是否保存执行数据。 |
| EXECUTIONS_DATA_SAVE_ON_PROGRESS | 布尔值 | false | 是否保存每个执行节点的进度（true 表示保存，false 表示不保存）。 |
| EXECUTIONS_DATA_SAVE_MANUAL_EXECUTIONS | 布尔值 | true | 是否在手动启动时保存执行的数据。 |
| EXECUTIONS_DATA_PRUNE | 布尔值 | true | 是否按滚动方式删除过去执行的数据。 |
| EXECUTIONS_DATA_MAX_AGE | 数字 | 336 | 删除前的执行年龄（以小时计）。 |
| EXECUTIONS_DATA_PRUNE_MAX_COUNT | 数字 | 10000 | 数据库中保留的最大执行次数。0 = 不限制 |
| EXECUTIONS_DATA_HARD_DELETE_BUFFER | 数字 | 1 | 要进行硬删除的已完成执行数据的年龄（小时）。默认情况下，此缓冲区会排除最近的执行数据，因为用户在构建工作流时可能需要它们。 |
| EXECUTIONS_DATA_PRUNE_HARD_DELETE_INTERVAL | 数字 | 15 | 应该多频繁（分钟）执行数据的硬删除。 |
| EXECUTIONS_DATA_PRUNE_SOFT_DELETE_INTERVAL | 数字 | 60 | 应多久（分钟）对执行数据进行软删除。|
| N8N_CONCURRENCY_PRODUCTION_LIMIT | 数字 | -1 | 允许同时运行的最大生产执行次数，在常规模式和扩展模式下均适用。-1 表示在常规模式下禁用。 |
| N8N_WORKFLOW_AUTODEACTIVATION_ENABLED | 布尔值 | false | 工作流在多次执行失败后是否会自动取消发布。 |
| N8N_WORKFLOW_AUTODEACTIVATION_MAX_LAST_EXECUTIONS | 数字 | 3 | 在取消发布工作流之前失败的执行次数。 |