端点环境变量(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 流量负载。 |