跳到主要内容

端点环境变量

信息

通过文件配置

可以为单个变量添加 _FILE 后缀，通过单独的文件提供配置。更多信息请参阅将敏感数据保存在单独的文件中。

本页列出用于自定义 n8n 端点的环境变量。

变量类型默认值说明
N8N_PAYLOAD_SIZE_MAXNumber16请求负载大小上限，单位为 MiB。默认为 16 MiB，可通过增大此变量提高上限。需要重启 n8n 实例才能应用新设置。增加负载上限会需要更多内存和 CPU 资源，可能影响性能，请确认基础设施能够处理更大的负载。
N8N_FORMDATA_FILE_SIZE_MAXNumber200form-data Webhook 负载中文件的大小上限，单位为 MiB。
N8N_METRICSBooleanfalse是否启用 /metrics 端点。
N8N_METRICS_PREFIXStringn8n_n8n 专有指标名称的可选前缀。
N8N_METRICS_INCLUDE_DEFAULT_METRICSBooleantrue是否提供默认的系统和 Node.js 指标。
N8N_METRICS_INCLUDE_CACHE_METRICSBooleanfalse是否包含缓存命中和未命中的指标，true 表示包含，false 表示不包含。
N8N_METRICS_INCLUDE_MESSAGE_EVENT_BUS_METRICSBooleanfalse是否包含事件指标，true 表示包含，false 表示不包含。
N8N_METRICS_INCLUDE_WORKFLOW_ID_LABELBooleanfalse是否在工作流指标中包含工作流 ID 标签。
N8N_METRICS_INCLUDE_NODE_TYPE_LABELBooleanfalse是否在节点指标中包含节点类型标签。
N8N_METRICS_INCLUDE_CREDENTIAL_TYPE_LABELBooleanfalse是否在凭据指标中包含凭据类型标签。
N8N_METRICS_INCLUDE_API_ENDPOINTSBooleanfalse是否提供 API 端点指标。
N8N_METRICS_INCLUDE_API_PATH_LABELBooleanfalse是否包含 API 调用路径标签。
N8N_METRICS_INCLUDE_API_METHOD_LABELBooleanfalse是否包含 API 调用的 HTTP 方法标签，例如 GET、POST。
N8N_METRICS_INCLUDE_API_STATUS_CODE_LABELBooleanfalse是否包含 API 调用的 HTTP 状态码标签，例如 200、404。
N8N_METRICS_INCLUDE_QUEUE_METRICSBooleanfalse是否包含扩展模式下的任务指标。
N8N_METRICS_QUEUE_METRICS_INTERVALInteger20更新队列指标的频率，单位为秒。
N8N_METRICS_INCLUDE_SCHEDULER_METRICSBooleanfalse是否包含持久调度器指标，例如队列深度、调度延迟、分发吞吐量、重试和死信。仅适用于主实例。各指标含义请参阅持久调度器可观测性。
N8N_METRICS_SCHEDULER_INTERVALInteger20刷新持久调度器队列健康仪表指标的频率，单位为秒。参阅持久调度器可观测性。
N8N_METRICS_INCLUDE_POLL_TRIGGER_METRICSBooleanfalse是否包含轮询触发器指标，例如轮询耗时、轮询错误、重叠轮询和游标提交。仅适用于主实例。各指标含义请参阅轮询触发器指标。
N8N_METRICS_INCLUDE_SYSTEM_TASK_METRICSBooleanfalse是否包含 n8n 内部维护任务指标，例如运行时长、最近成功时间、跳过次数和定时器延迟。仅适用于主实例。各指标含义请参阅系统任务可观测性。
N8N_METRICS_INCLUDE_SSRF_METRICSBooleanfalse是否包含 SSRF 防护检查指标。
N8N_METRICS_INCLUDE_DNS_CACHE_METRICSBooleanfalse是否包含 DNS 缓存指标，目前仅 SSRF 防护使用该缓存。
N8N_ENDPOINT_RESTStringrestREST 端点路径。
N8N_ENDPOINT_WEBHOOKStringwebhookWebhook 端点路径。
N8N_ENDPOINT_WEBHOOK_TESTStringwebhook-test测试 Webhook 端点路径。
N8N_ENDPOINT_WEBHOOK_WAITStringwebhook-waiting等待 Webhook 端点路径。
N8N_ENDPOINT_HEALTHStringhealthz健康检查端点路径。
N8N_WEBHOOK_URLString-在反向代理后运行 n8n 时，设置测试及生产 Webhook 的基础 URL。请使用此变量，而非上方仅设置端点路径的 N8N_ENDPOINT_* 变量，后者不是 URL。参阅配置反向代理下的 Webhook URL。
WEBHOOK_URLString-自 n8n 2.35.0 起弃用，是 N8N_WEBHOOK_URL 的别名。仍然有效，但 n8n 启动时会记录弃用警告。
N8N_DISABLE_PRODUCTION_MAIN_PROCESSBooleanfalse禁用主进程中的生产 Webhook。使用专用 Webhook 进程时，可避免 HTTP 流量给主进程带来负载。

相关资源 ​

本文为社区中文翻译。查看对应英文原文