image_filter_buffer
`image_filter_buffer` 指令设置用于在 NGINX 中进行图像处理的缓冲区大小。 — NGINX HTTP Core
image_filter_buffer
httpserverlocation
语法image_filter_buffer size;
默认值4k
上下文http, server, location
模块NGINX HTTP Core
参数1
说明
`image_filter_buffer` 指令配置在使用 NGINX 图像过滤模块处理图像时分配的内存量。该指令在处理大图像时至关重要,因为它能够实现高效的处理并避免可能导致性能下降的过度内存分配。缓冲区大小允许 NGINX Web 服务器在发送给客户端之前将图像数据临时保存在内存中,以便执行诸如缩放、裁剪或修改图像的操作。 此指令可以在 `http`、`server` 或 `location` 上下文中设置。指定时,它接受一个单一参数,表示缓冲区的大小(以字节为单位)。如果指定的大小不足以处理某个图像,NGINX 可能会返回错误或无法按预期处理图像。因此,必须根据所提供或处理图像的大小和类型适当设置缓冲区。 在实践中,该指令有助于在确保图像操作能够无缝执行的同时保持服务器资源的高效利用。在设置此值时,应考虑服务器的可用内存和预期流量,以在性能和内存使用之间取得平衡。
配置示例
location /images/ {
image_filter buffer 16k;
image_filter resize 200x200;
}⚠
使用过小的缓冲区在处理大型图像时可能导致错误。
⚠
缓冲区大小必须为二的幂,并且应与服务器的内存限制相对应。