端点环境变量

基于文件的配置

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

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

变量	类型	默认值	描述
N8N_PAYLOAD_SIZE_MAX	数字	16	最大有效负载大小（MiB）。默认值为 16 MiB，可将变量设为更大的值。n8n 实例需要重启才能应用新设置。注意：增加有效负载大小需要更多内存和 CPU 资源，并可能影响性能。请确保基础设施能够处理更大的有效负载。
N8N_FORMDATA_FILE_SIZE_MAX	数字	200	form-data webhook 有效负载中文件的最大大小（MiB）。
N8N_METRICS	布尔值	false	是否启用 /metrics 端点。
N8N_METRICS_PREFIX	字符串	n8n_	n8n 特定指标名称的可选前缀。
N8N_METRICS_INCLUDE_DEFAULT_METRICS	布尔值	true	是否公开默认系统和 Node.js 指标。
N8N_METRICS_INCLUDE_CACHE_METRICS	布尔值	false	是否包含缓存命中和未命中的指标。
N8N_METRICS_INCLUDE_MESSAGE_EVENT_BUS_METRICS	布尔值	false	是否包含事件指标。
N8N_METRICS_INCLUDE_WORKFLOW_ID_LABEL	布尔值	false	是否在工作流指标中包含工作流 ID 标签。
N8N_METRICS_INCLUDE_NODE_TYPE_LABEL	布尔值	false	是否在节点指标中包含节点类型标签。
N8N_METRICS_INCLUDE_CREDENTIAL_TYPE_LABEL	布尔值	false	是否在凭据指标中包含凭据类型标签。
N8N_METRICS_INCLUDE_API_ENDPOINTS	布尔值	false	是否公开 API 端点指标。
N8N_METRICS_INCLUDE_API_PATH_LABEL	布尔值	false	是否包含 API 调用路径标签。
N8N_METRICS_INCLUDE_API_METHOD_LABEL	布尔值	false	是否包含 API 调用的 HTTP 方法（GET、POST 等）标签。
N8N_METRICS_INCLUDE_API_STATUS_CODE_LABEL	布尔值	false	是否包含 API 调用的 HTTP 状态码（200、404 等）标签。
N8N_METRICS_INCLUDE_QUEUE_METRICS	布尔值	false	是否包含扩展模式下作业的指标。
N8N_METRICS_QUEUE_METRICS_INTERVAL	整数	20	更新队列指标的频率（秒）。
N8N_METRICS_INCLUDE_SSRF_METRICS	布尔值	false	是否包含 SSRF 防护检查指标。
N8N_METRICS_INCLUDE_DNS_CACHE_METRICS	布尔值	false	是否包含 DNS 缓存指标（目前仅用于 SSRF 防护）。
N8N_ENDPOINT_REST	字符串	rest	REST 端点使用的路径。
N8N_ENDPOINT_WEBHOOK	字符串	webhook	webhook 端点使用的路径。
N8N_ENDPOINT_WEBHOOK_TEST	字符串	webhook-test	测试 webhook 端点使用的路径。
N8N_ENDPOINT_WEBHOOK_WAIT	字符串	webhook-waiting	等待 webhook 端点使用的路径。
N8N_ENDPOINT_HEALTH	字符串	healthz	健康检查端点使用的路径。
WEBHOOK_URL	字符串	-	在反向代理后运行 n8n 时，用于手动提供 Webhook URL。更多详细信息请参阅配置 Webhook URL。
N8N_DISABLE_PRODUCTION_MAIN_PROCESS	布尔值	false	禁用主进程中的生产 webhook。这有助于确保使用 webhook 专用进程时，主进程不会承载 HTTP 流量。