端点环境变量

基于文件的配置

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

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

变量	类型	默认值	描述
N8N_PAYLOAD_SIZE_MAX	Number	16	最大负载大小（以 MiB 为单位）。
N8N_FORMDATA_FILE_SIZE_MAX	Number	200	表单数据 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	是否包含扩展模式下作业的指标。在多主设置中不支持。
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 流量负载到主进程。