端点环境变量#

基于文件的配置

您可以在个别变量后添加 _FILE 后缀，通过独立文件提供配置。更多细节请参阅将敏感数据保存在独立文件中。

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

变量	类型	默认值	描述
N8N_PAYLOAD_SIZE_MAX	数值	16	最大载荷大小（单位：MiB）
N8N_FORMDATA_FILE_SIZE_MAX	数值	200	form-data 类型 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	是否包含缓存命中/未命中指标
N8N_METRICS_INCLUDE_MESSAGE_EVENT_BUS_METRICS	布尔值	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方法标签
N8N_METRICS_INCLUDE_API_STATUS_CODE_LABEL	布尔值	false	是否在API调用指标中包含HTTP状态码标签
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流量