client_header_buffer_size

说明

`client_header_buffer_size` 指令在 NGINX 中允许您指定用于读取传入客户端请求头的缓冲区大小。这对于管理在开始将额外头数据存入其他缓冲区之前 NGINX 一次能够处理多少头数据至关重要。当客户端发送 HTTP 头时，NGINX 会对其进行处理；如果组合后的头大小超过指定的缓冲区大小，NGINX 将使用更大的缓冲区来容纳这些数据。这有助于防止与较大头相关的问题，例如在某些身份验证和 cookie 配置中遇到的问题。 在由于 cookie 大小增加或其他自定义头而可能出现较大头的场景中，该指令尤其重要。如果缓冲区设置得太小，可能会导致诸如 `413 Request Entity Too Large` 的错误或处理大头请求时延迟增加。管理员在设置该值时应保持谨慎，因为将其设置得过大可能导致不必要的内存消耗，尤其是在高负载或处理大量并发连接时。该指令定义在 `http` 和 `server` 上下文中，可灵活用于全局或特定服务器的配置。

配置示例

server {
    listen 80;
    server_name example.com;

    client_header_buffer_size 2k;
}