image_filter_webp_quality
设置 NGINX 在过滤过程中 WebP 图像的质量。 — NGINX HTTP Core
image_filter_webp_quality
httpserverlocation
语法image_filter_webp_quality quality;
默认值75
上下文http, server, location
模块NGINX HTTP Core
参数1
说明
`image_filter_webp_quality` 指令用于定义在 NGINX 中使用 image_filter 模块时生成的 WebP 图像的质量级别。该指令接受一个参数,该参数为整数,用来指定输出 WebP 图像的质量(0 到 100),其中 100 表示最高质量和最低压缩,0 则表示最低质量和最大压缩。该指令必须在配置文件的 `http`、`server` 或 `location` 上下文中包含,因为它用于控制图像的处理和提供方式。 配置后,`image_filter_webp_quality` 通过将传入图像转换为 WebP 格式来增强 NGINX 的图像提供能力,WebP 通常相比 JPEG 或 PNG 等其他格式体积更小,而不会显著降低视觉质量。如果客户端支持 WebP(通过检查 HTTP 请求中的 `Accept` 头确定),此转换会在运行时进行。适当设置质量参数可让开发者根据应用的具体需求在图像清晰度和文件大小之间进行权衡,从而改善以图像为主的网页的加载时间和性能。
配置示例
location /images {
image_filter png;
image_filter_webp on;
image_filter_webp_quality 85;
}⚠
确保 image_filter 模块已启用并正确配置,因为此指令仅在该上下文中生效。
⚠
在图像处理时使用超出 0-100 范围的值可能导致错误或意外行为。
⚠
请记住,将质量设置为较高值(接近 100)会生成更大的文件大小,可能影响加载速度。