n8n 中文文档

执行环境变量

提示

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 工作流库 找现成的中文工作流。