srcache_header_buffer_size

指令 `srcache_header_buffer_size` 指定用于在子请求中缓存 HTTP 头的缓冲区大小。

语法srcache_header_buffer_size size;
默认值none
上下文http, server, location, if in location
参数1

说明

指令 srcache_header_buffer_size 是 NGINX 的基于透明子请求的缓存模块的一部分,该模块允许对任意位置的响应进行缓存。该指令直接影响在发起子请求时为存储 HTTP 头分配的缓冲区大小。在头较大时,设置合适的缓冲区大小可以防止截断或内存问题。该参数接受单个参数,用以定义以字节为单位的大小,也可以用千字节 (K) 或兆字节 (M) 表示。

该指令可在多个上下文中使用,例如 httpserverlocation,以及 location 内的 if 块中。这种灵活性允许对 NGINX 配置中不同部分的缓存行为进行细粒度控制。需要注意的是,如果定义的大小对于正在处理的头而言过小,可能导致意外结果,例如缓存中的头不完整或损坏。因此,用户应谨慎并根据其应用的具体需求测试不同的大小。

配置示例

server {
    location /api {
        srcache_header_buffer_size 16k;
    }
}

将缓冲区大小设置得过小可能导致头部截断错误。

对该指令的更改可能不会立即可见,除非清除缓存或重新验证。

← 返回所有指令