执行环境变量(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_CONCURRENCY_EVALUATION_LIMIT	数字	许可证等级默认值	在单个 evaluation 测试运行中可以并行运行的最大测试用例数。未设置时，限制遵循许可证等级（Community/Pro: 1, Business: 3, Enterprise: 5）。设置此值将覆盖等级默认值。
N8N_WORKFLOW_AUTODEACTIVATION_ENABLED	布尔值	false	工作流在多次执行失败后是否会自动取消发布。
N8N_WORKFLOW_AUTODEACTIVATION_MAX_LAST_EXECUTIONS	数字	3	在取消发布工作流之前失败的执行次数。