underscores_in_headers

`underscores_in_headers` 指令允许在 HTTP 头部名称中使用下划线。 — NGINX HTTP Core

underscores_in_headers
httpserver
语法underscores_in_headers on | off;
默认值off
上下文http, server
模块NGINX HTTP Core
参数flag

说明

默认情况下,NGINX 出于安全原因不允许在 HTTP 头部名称中使用下划线,主要是为了避免与某些头部解析行为发生潜在冲突。 `underscores_in_headers` 指令可以修改该限制。它可以设置为 'on' 或 'off',其中 'on' 允许在头部名称中使用下划线。当与依赖包含下划线的头部名称的特定 API 或客户端一起使用时,这一点尤其有用。 该指令可在 `http` 或 `server` 上下文中使用,允许进行全局或针对特定服务器的配置。启用后,它将作用于 NGINX 处理的所有头部,影响传入的请求头和传出的响应头。

配置示例

http {
    underscores_in_headers on;

    server {
        location / {
            # server configuration
        }
    }
}

在请求头中启用下划线可能会使您的应用程序暴露于某些无法正确处理此类请求头的代理或客户端所带来的潜在问题。

确保依赖下划线的功能在配置更改后经过彻底测试。