执行环境变量
提示
File-based configuration 基于文件的配置
您可以将 _FILE 添加到各个变量,以在单独的文件中提供其配置。有关更多详细信息,请参阅将敏感数据保存在单独的文件中。
本页列出用于配置工作流执行设置的环境变量。
| 变量 | 类型 | 默认值 | 说明 |
|---|---|---|---|
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 |
手动启动时是否保存执行数据。 |
N8N_EXECUTION_DATA_STORAGE_MODE |
枚举字符串:database、filesystem、s3、azure |
database |
其中 n8n 存储执行数据。s3 和 azure 模式需要自托管 Business 或 Enterprise 计划。相关存储变量请参考外部数据存储。 |
N8N_STORAGE_PATH |
字符串 | N8N_USER_FOLDER/storage |
文件系统存储的基本路径。当N8N_EXECUTION_DATA_STORAGE_MODE为filesystem时,n8n在此存储执行数据。 n8n 也使用此路径来存储文件系统二进制数据。 |
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 |
应软删除执行数据的频率(分钟)。 |
EXECUTIONS_DATA_MAX_DISPLAY_SIZE |
数量 | 104857600 |
n8n 在显示执行(编辑器、执行详情和 Public API)时加载的最大执行数据大小(字节)。对于更大的执行,n8n 会省略数据(显示为「too large to display」),以避免低资源实例耗尽内存。不影响重试或恢复执行,这些操作始终会加载完整数据。设置为 0 可禁用此限制。 |
N8N_CONCURRENCY_PRODUCTION_LIMIT |
数量 | -1 |
允许在常规模式和扩展模式下同时运行最大生产执行。 -1 在常规模式下禁用。 |
N8N_CONCURRENCY_EVALUATION_LIMIT |
数量 | 许可层级默认值 | 单次评估测试运行中可并行运行的最大测试用例数。未设置时,限制遵循许可层级:自托管 Community:1,n8n Cloud Pro:1,自托管 Business:3,n8n Cloud Enterprise 和自托管 Enterprise:5。设置此变量会覆盖层级默认值。 |
N8N_WORKFLOW_AUTODEACTIVATION_ENABLED |
布尔 | false |
重复执行崩溃后工作流程是否自动取消发布。 |
N8N_WORKFLOW_AUTODEACTIVATION_MAX_LAST_EXECUTIONS |
数量 | 3 |
取消发布工作流之前崩溃的执行次数。 |
相关资源
不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。