端点环境变量(Endpoints environment variables)#

File-based configuration

You can add _FILE to individual variables to provide their configuration in a separate file. Refer to Keeping sensitive data in separate files for more details.

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

🌐 This page lists environment variables for customizing endpoints in n8n.

变量	类型	默认值	描述
`N8N_PAYLOAD_SIZE_MAX`	数字	`16`	最大有效负载大小（MiB）。
`N8N_FORMDATA_FILE_SIZE_MAX`	数字	`200`	在表单数据 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	是否包含缓存命中和未命中的指标（true 表示包含，false 表示不包含）。
`N8N_METRICS_INCLUDE_MESSAGE_EVENT_BUS_METRICS`	布尔值	`false`	是否为事件包含指标（true），或不包含指标（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_ENDPOINT_REST`	字符串	`rest`	用于 REST 端点的路径。
`N8N_ENDPOINT_WEBHOOK`	字符串	`webhook`	用于 Webhook 端点的路径。
`N8N_ENDPOINT_WEBHOOK_TEST`	字符串	`webhook-test`	用于 test-webhook 端点的路径。
`N8N_ENDPOINT_WEBHOOK_WAIT`	字符串	`webhook-waiting`	用于等待 webhook 端点的路径。
`N8N_ENDPOINT_HEALTH`	字符串	`healthz`	用于健康检查端点的路径。
`WEBHOOK_URL`	字符串	-	在 n8n 运行在反向代理后时用于手动提供 Webhook URL。更多详情见这里。
`N8N_DISABLE_PRODUCTION_MAIN_PROCESS`	布尔值	`false`	禁用主进程的生产 Webhook。这有助于在使用特定 Webhook 的进程时，确保主进程没有 HTTP 流量负载。