BLB七层监听的定制配置
更新时间：2026-05-12
定制配置概述
BLB支持您为七层监听设置定制配置参数，如 client_header_timeout、client_body_timeout、proxy_buffer_size、proxy_buffers、proxy_set_header等，满足您更多样的七层业务需求。
定制配置字段说明
| 配置字段 | 描述 | 取值说明 | 默认值 | 配置示例 |
|---|---|---|---|---|
| client_header_timeout | 读取客户端请求头的超时时间，如果客户端在这个时间内未发送完整的请求头，BLB会中断请求。 | 30 ~ 120，单位：秒（s） | 60 | client_header_timeout:60 |
| client_header_buffer_size | 存放客户端请求头的缓冲区大小。 | 1 ~ 16，单位：KB | 1 | client_header_buffer_size:1 |
| large_client_header_buffers | 存放较大客户端请求头的缓冲区数量和大小。 请求行和一个请求头均不能超过一个缓冲区的大小，整个请求头不能超过所有缓冲区之和的大小。 |
缓冲区数量：1~16； 缓冲区大小：1~1024 KB |
4 8 | large_client_header_buffers:4 8 |
| client_body_timeout | BLB读取客户端POST请求体的超时时间。该时间为连续两次成功读到请求体的时间间隔，而非整体传输时长。如果此期间内客户端无任何数据发送，则中断连接。 | 30~120，单位：秒（s） | 60 | client_body_timeout:60 |
| proxy_buffering | BLB是否缓存来自后端服务器的响应。 on：表示缓存来自后端服务器的响应，全部接收完成后再返回给后端服务器。 off：表示不缓存来自后端服务器的响应，此时会导致后端服务器有一定性能压力。 说明：您也可以通过在响应头里添加X-Accel-Buffering控制是否缓存。X-Accel-Buffering: yes表示缓存，X-Accel-Buffering: no表示不缓存。 |
on / off | on | proxy_buffering:on |
| proxy_buffers | BLB读取后端服务器响应体的缓冲区数量及单个缓冲区大小。 | 缓冲区个数：3~8个； 缓冲区大小：4~8 KB |
8 4 | proxy_buffers:8 4 |
| proxy_buffer_size | BLB读取来自后端服务器响应头的缓冲区大小 ，如果后端服务器响应头超过这个大小，BLB会返回502。 使用 proxy_buffer_size 时，必须同时设置 proxy_buffers。 说明：proxy_buffer_size 和 proxy_buffers 配置的值需要满足约束条件： 2 max（proxy_buffer_size, proxy_buffers.size) ≤（proxy_buffers.num - 1） proxy_buffers.size。 例如，配置 proxy_buffer_size 为 24k，proxy_buffers 为 8 8k，则2 24k = 48k，（8 - 1） 8k = 56k，此时 48k ≤ 56k，因此配置不会报错，否则报错。 |
1~64，单位：KB | 4 | proxy_buffer_size:4 |
| proxy_set_header | BLB通过附加头字段向后端传递信息。 X-BLB-Cport $cport：向后端转发的请求中新增包含客户端端口信息的header 头。 X-BLB-Vip $vip：向后端转发的请求中新增包含BLB的Vip信息的header头。 X-BLB-Vport $vport：向后端转发的请求中新增包含BLB 的Vport信息的 header 头。 X-BLB-Request-Id $bce_blb_request_id：向后端转发的请求中新增包含唯一请求ID信息的 header头。 X-BLB-Client-Cert $ssl_client_cert：向后端转发的HTTPS请求中新增包含客户端证书信息的 header 头。 X-BLB-Client-Serial $ssl_client_serial：向后端转发的 HTTPS 请求中新增包含客户端证书序列号信息的 header 头。 X-Real-IP $cip：向后端转发的请求中新增包含客户端 IP信息的 header 头。 |
无 | 不涉及 | proxy_set_header:X-BLB-Cport $cport |
| gzip_json | 是否对application/json格式报文进行gzip压缩。 on：表示支持对application/json格式的gzip压缩，后端server返回的响应，BLB会将响应body压缩后，返回给客户端。 off：表示不支持对application/json格式的gzip压缩，后端server返回的响应，BLB将不进行压缩直接返回给客户端。 |
on / off | off | gzip_json:off |
设置定制配置
- 登录百度智能云控制台 BLB实例列表页。
- 在实例列表中找到目标BLB实例。
- 单击实例名称进入实例详情页，在左侧导航栏选择"监听设置"。
- 在监听设置列表页，找到目标监听，单击操作列的“编辑”。
- 在“编辑监听设置”页面的高级选项中，开启定制配置并输入定制字段。
- 单击"确定"。
配置代码示例：
Plain Text
1client_header_timeout:60
2client_body_timeout:60
3proxy_buffer_size:4
4proxy_buffers:8 4
5proxy_set_header:X-BLB-Cport $cport评价此篇文章