jpeg_filter_progressive

`jpeg_filter_progressive` 指令在 NGINX JPEG 过滤模块中启用渐进式 JPEG 编码。

语法jpeg_filter_progressive on | off;
默认值off
上下文http, server, location
参数flag

说明

jpeg_filter_progressive 指令控制由 NGINX JPEG 过滤模块处理的图像是否应编码为渐进式 JPEG,这种格式旨在快速显示图像的低质量版本,并随着更多数据的下载逐步提高图像质量。当该指令设置为 on 时,会指示底层库 libmodjpeg 以渐进式方式编码 JPEG 图像,从而在图像加载期间改善用户体验,允许更具吸引力的初始渲染。

该指令通常与 jpeg_filter 指令配合使用,后者必须启用才能进行任何过滤操作。激活 jpeg_filter_progressive 后,生成的 JPEG 将包含多个扫描,使客户端在完整质量可用之前能够显示较低分辨率的图像。这对大型图像尤其有用,用户通常更愿意立即看到部分内容,而不是等待整个文件下载完成。该参数接受简单的布尔标志:onoff。如果未显式指定,默认行为为 off,即 JPEG 将以标准顺序格式存储,除非启用此指令。

配置示例

location /images {
    jpeg_filter on;
    jpeg_filter_progressive on;
}

确保启用 jpeg_filter 指令;否则,jpeg_filter_progressive 将无效。

并非所有图像查看器都完全支持渐进式 JPEG,这在某些情况下可能导致显示问题。

← 返回所有指令