部署托管/Configuration/Environment_variables
端点环境变量#
基于文件的配置
你可以为单个变量添加 _FILE 后缀，以在单独的文件中提供其配置。更多详情请参阅将敏感数据保存在独立文件中。
本页面列出了用于自定义 n8n 中端点的环境变量。
| 变量 | 类型 | 默认值 | 说明 |
|---|---|---|---|
N8N_PAYLOAD_SIZE_MAX | 数字（Number） | 16 | 最大负载大小（单位：MiB）。 |
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 | 是否包含扩展模式下任务队列的指标。在多主进程（multi-main）设置中不支持。 |
N8N_METRICS_QUEUE_METRICS_INTERVAL | 整数（Integer） | 20 | 队列指标更新频率（单位：秒）。 |
N8N_ENDPOINT_REST | 字符串（String） | rest | REST 端点使用的路径。 |
N8N_ENDPOINT_WEBHOOK | 字符串（String） | webhook | Webhook 端点使用的路径。 |
N8N_ENDPOINT_WEBHOOK_TEST | 字符串（String） | webhook-test | 测试 Webhook 端点使用的路径。 |
N8N_ENDPOINT_WEBHOOK_WAIT | 字符串（String） | webhook-waiting | 等待 Webhook 端点使用的路径。 |
WEBHOOK_URL | 字符串（String） | - | 当 n8n 运行在反向代理后方时，用于手动指定 Webhook URL。详见此处。 |
N8N_DISABLE_PRODUCTION_MAIN_PROCESS | 布尔值（Boolean） | false | 禁用主进程处理生产环境 Webhook。这有助于确保在使用专用 Webhook 进程时，主进程不会承受 HTTP 流量压力。 |