n8n 中文文档

端点环境变量

提示

File-based configuration 基于文件的配置

您可以将 _FILE 添加到各个变量,以在单独的文件中提供其配置。有关更多详细信息,请参阅将敏感数据保存在单独的文件中。

本页列出了在 n8n 中自定义端点的环境变量。

变量 类型 默认值 描述
N8N_PAYLOAD_SIZE_MAX Number 16 最大负载大小(以 MiB 为单位)。默认值为 16 MiB,可将此变量设为更高的值来增大限制。新设置需要重启 n8n 实例才能生效。请注意,增大负载大小需要更多内存和 CPU 资源,并可能影响性能。请确保基础设施能够处理更大的负载。
N8N_FORMDATA_FILE_SIZE_MAX Number 200 form-data Webhook 负载中文件的最大大小(以 MiB 为单位)。
N8N_METRICS Boolean false 是否启用 /metrics 端点。
N8N_METRICS_PREFIX String n8n_ n8n 专用指标名称的可选前缀。
N8N_METRICS_INCLUDE_DEFAULT_METRICS Boolean true 是否公开默认的系统和 Node.js 指标。
N8N_METRICS_INCLUDE_CACHE_METRICS Boolean false 是否包含缓存命中和未命中的指标(true 为包含,false 为不包含)。
N8N_METRICS_INCLUDE_MESSAGE_EVENT_BUS_METRICS Boolean false 是否包含事件指标(true 为包含,false 为不包含)。
N8N_METRICS_INCLUDE_WORKFLOW_ID_LABEL Boolean false 是否在工作流指标中包含工作流 ID 标签。
N8N_METRICS_INCLUDE_NODE_TYPE_LABEL Boolean false 是否在节点指标中包含节点类型标签。
N8N_METRICS_INCLUDE_CREDENTIAL_TYPE_LABEL Boolean false 是否在凭据指标中包含凭据类型标签。
N8N_METRICS_INCLUDE_API_ENDPOINTS Boolean false 是否公开 API 端点指标。
N8N_METRICS_INCLUDE_API_PATH_LABEL Boolean false 是否包含 API 调用路径标签。
N8N_METRICS_INCLUDE_API_METHOD_LABEL Boolean false 是否包含 API 调用的 HTTP 方法(GET、POST 等)标签。
N8N_METRICS_INCLUDE_API_STATUS_CODE_LABEL Boolean false 是否包含 API 调用的 HTTP 状态码(200、404 等)标签。
N8N_METRICS_INCLUDE_QUEUE_METRICS Boolean false 是否包含扩展模式下的作业指标。
N8N_METRICS_QUEUE_METRICS_INTERVAL Integer 20 更新队列指标的频率(秒)。
N8N_METRICS_INCLUDE_SCHEDULER_METRICS Boolean false 是否包含持久调度器指标,例如队列深度、调度延迟、分派吞吐量、重试和死信。仅适用于主实例。有关各指标的含义,请参阅持久调度器可观测性。
N8N_METRICS_SCHEDULER_INTERVAL Integer 20 刷新持久调度器队列健康状况仪表的频率(秒)。请参阅持久调度器可观测性。
N8N_METRICS_INCLUDE_POLL_TRIGGER_METRICS Boolean false 是否包含轮询触发器节点的指标,例如轮询持续时间、轮询错误、重叠轮询和游标提交。仅适用于主实例。有关各指标的含义,请参阅轮询触发器指标。
N8N_METRICS_INCLUDE_SYSTEM_TASK_METRICS Boolean false 是否包含 n8n 内部维护任务的指标,例如运行持续时间、最后成功时间、跳过的发生次数和计时器延迟。仅适用于主实例。有关各指标的含义,请参阅系统任务可观测性。
N8N_METRICS_INCLUDE_SSRF_METRICS Boolean false 是否包含 SSRF 保护检查指标。
N8N_METRICS_INCLUDE_DNS_CACHE_METRICS Boolean false 是否包含 DNS 缓存指标(目前仅由 SSRF 保护使用)。
N8N_ENDPOINT_REST String rest REST 端点使用的路径。
N8N_ENDPOINT_WEBHOOK String webhook Webhook 端点使用的路径。
N8N_ENDPOINT_WEBHOOK_TEST String webhook-test test-webhook 端点使用的路径。
N8N_ENDPOINT_WEBHOOK_WAIT String webhook-waiting waiting-webhook 端点使用的路径。
N8N_ENDPOINT_FORM String form 表单端点使用的路径。
N8N_ENDPOINT_FORM_TEST String form-test test-form 端点使用的路径。
N8N_ENDPOINT_FORM_WAIT String form-waiting waiting-form 端点使用的路径。
N8N_ENDPOINT_HEALTH String healthz 健康检查端点使用的路径。
N8N_WEBHOOK_URL String - 在反向代理后运行 n8n 时,为测试和生产 Webhook 设置 base URL。请使用此变量,而不是上方仅设置端点_路径_(而非 URL)的 N8N_ENDPOINT_* 变量。请参阅使用反向代理配置 Webhook URL。
WEBHOOK_URL String - 自 n8n 2.35.0 起弃用;它是 N8N_WEBHOOK_URL 的别名,仍然有效,但 n8n 会在启动时记录弃用警告。
N8N_DISABLE_PRODUCTION_MAIN_PROCESS Boolean false 禁止主进程处理生产 Webhook。使用 Webhook 专用进程时,这有助于确保主进程不承担 HTTP 流量负载。

相关资源

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。