端点环境变量

¥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	测试 Webhook 端点的路径。
N8N_ENDPOINT_WEBHOOK_WAIT	字符串	webhook-waiting	等待 Webhook 端点的路径。
WEBHOOK_URL	字符串	*	用于在反向代理后运行 n8n 时手动提供 Webhook URL。详细信息请参见 此处。
N8N_DISABLE_PRODUCTION_MAIN_PROCESS	布尔值	false	禁用主进程的生产 Webhook。这有助于确保在使用 webhook 特定进程时不会给主进程带来 HTTP 流量负载。