image_filter_jpeg_quality可在nginx层实时压缩jpeg图片，需配合resize/rotate等指令生效，quality值推荐75–85，支持按设备或网络条件动态设置，并须手动扩展缓存key以保证一致性。

使用 image_filter_jpeg_quality 可以在 Nginx 层实时压缩 JPEG 图片，无需修改源文件，是兼顾带宽节省与视觉体验的轻量级方案。

基础配置：让 quality 参数真正生效

该指令仅对 image_filter resize 或 image_filter rotate 等触发图片处理的场景起作用。单纯代理图片不会启用压缩。

• 必须启用 image_filter 模块（编译时需含 --with-http_image_filter_module）
• quality 值范围为 1–100，推荐设为 75–85：低于 70 易出现明显色块，高于 90 带宽收益急剧下降
• 示例配置：

  location ~* \.(jpg|jpeg)$ {
      image_filter resize 800 -;
      image_filter_jpeg_quality 82;
      image_filter_webp on;
  }

按设备或网络条件动态设值

结合 $http_user_agent、$http_save_data（Chrome 的 Save-Data 头）或自定义请求头，实现差异化质量策略。

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

• 识别低带宽用户：if ($http_save_data = "on") { set $q 65; }
• 适配移动设备：if ($http_user_agent ~* "(iPhone|Android)") { set $q 78; }
• 最终在 image_filter_jpeg_quality 中引用：image_filter_jpeg_quality $q;

注意缓存一致性与格式边界

质量参数变化会导致输出内容不同，但默认情况下 Nginx 不会自动将 quality 纳入缓存 key —— 容易出现高质图被低质缓存覆盖的问题。

• 手动扩展缓存 key：proxy_cache_key "$scheme$request_method$host$request_uri$q";
• 仅影响 JPEG：PNG 和 GIF 不受 image_filter_jpeg_quality 控制；如需 WebP 自适应，需开启 image_filter_webp on 并配合 Accept 头判断
• 原图尺寸过小（如小于目标缩放尺寸）时，resize 不触发，quality 设置无效 —— 建议搭配 image_filter_interlace on 提升渐进加载观感

不复杂但容易忽略：它不是全局压缩开关，而是图像处理流水线中的一环。用对时机，才能把每 KB 带宽都用在刀刃上。