端点环境变量
提示
File-based configuration 基于文件的配置
您可以将 _FILE 添加到各个变量,以在单独的文件中提供其配置。有关更多详细信息,请参阅将敏感数据保存在单独的文件中。
本页列出了在 n8n 中自定义端点的环境变量。
| 变量 | 类型 | 默认值 | 描述 |
|---|---|---|---|
N8N_PAYLOAD_SIZE_MAX |
Number | 16 |
最大负载大小(以 MiB 为单位)。默认值为 16 MiB,可将此变量设为更高的值来增大限制。新设置需要重启 n8n 实例才能生效。请注意,增大负载大小需要更多内存和 CPU 资源,并可能影响性能。请确保基础设施能够处理更大的负载。 |
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 |
是否包含扩展模式下的作业指标。 |
N8N_METRICS_QUEUE_METRICS_INTERVAL |
Integer | 20 |
更新队列指标的频率(秒)。 |
N8N_METRICS_INCLUDE_SCHEDULER_METRICS |
Boolean | false |
是否包含持久调度器指标,例如队列深度、调度延迟、分派吞吐量、重试和死信。仅适用于主实例。有关各指标的含义,请参阅持久调度器可观测性。 |
N8N_METRICS_SCHEDULER_INTERVAL |
Integer | 20 |
刷新持久调度器队列健康状况仪表的频率(秒)。请参阅持久调度器可观测性。 |
N8N_METRICS_INCLUDE_POLL_TRIGGER_METRICS |
Boolean | false |
是否包含轮询触发器节点的指标,例如轮询持续时间、轮询错误、重叠轮询和游标提交。仅适用于主实例。有关各指标的含义,请参阅轮询触发器指标。 |
N8N_METRICS_INCLUDE_SYSTEM_TASK_METRICS |
Boolean | false |
是否包含 n8n 内部维护任务的指标,例如运行持续时间、最后成功时间、跳过的发生次数和计时器延迟。仅适用于主实例。有关各指标的含义,请参阅系统任务可观测性。 |
N8N_METRICS_INCLUDE_SSRF_METRICS |
Boolean | false |
是否包含 SSRF 保护检查指标。 |
N8N_METRICS_INCLUDE_DNS_CACHE_METRICS |
Boolean | false |
是否包含 DNS 缓存指标(目前仅由 SSRF 保护使用)。 |
N8N_ENDPOINT_REST |
String | rest |
REST 端点使用的路径。 |
N8N_ENDPOINT_WEBHOOK |
String | webhook |
Webhook 端点使用的路径。 |
N8N_ENDPOINT_WEBHOOK_TEST |
String | webhook-test |
test-webhook 端点使用的路径。 |
N8N_ENDPOINT_WEBHOOK_WAIT |
String | webhook-waiting |
waiting-webhook 端点使用的路径。 |
N8N_ENDPOINT_FORM |
String | form |
表单端点使用的路径。 |
N8N_ENDPOINT_FORM_TEST |
String | form-test |
test-form 端点使用的路径。 |
N8N_ENDPOINT_FORM_WAIT |
String | form-waiting |
waiting-form 端点使用的路径。 |
N8N_ENDPOINT_HEALTH |
String | healthz |
健康检查端点使用的路径。 |
N8N_WEBHOOK_URL |
String | - | 在反向代理后运行 n8n 时,为测试和生产 Webhook 设置 base URL。请使用此变量,而不是上方仅设置端点_路径_(而非 URL)的 N8N_ENDPOINT_* 变量。请参阅使用反向代理配置 Webhook URL。 |
WEBHOOK_URL |
String | - | 自 n8n 2.35.0 起弃用;它是 N8N_WEBHOOK_URL 的别名,仍然有效,但 n8n 会在启动时记录弃用警告。 |
N8N_DISABLE_PRODUCTION_MAIN_PROCESS |
Boolean | false |
禁止主进程处理生产 Webhook。使用 Webhook 专用进程时,这有助于确保主进程不承担 HTTP 流量负载。 |
相关资源
不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。