Nginx 实现动态裁剪与缩略图需模块协同与精准缓存策略：启用 image_filter、proxy、proxy_cache 模块，配置两级缓存路径与 key 区，通过正则提取尺寸参数，结合 proxy_cache_lock 和 cache_valid 实现单次处理、多次复用。
用 Nginx 实现动态裁剪 + 缩略图生成 + 上游缓存联动，关键不在堆功能，而在模块协同与缓存策略的精准控制。核心是让每次尺寸请求只触发一次后端处理（如从 S3 或本地读原图、缩放），结果被可靠缓存，后续同尺寸请求直接返回，不重复计算也不回源。
必备模块与编译确认
确保你的 Nginx 已启用三个基础模块：
- ngx_http_image_filter_module：负责实时 resize、crop、rotate 等图像操作；
- ngx_http_proxy_module：用于反向代理到源站（如对象存储、图片目录或上游服务）；
- ngx_http_proxy_cache_module：提供本地磁盘缓存能力，支持 key 定制与过期管理。
运行 nginx -V 2>&1 | grep -o "image_filter\|proxy_cache\|proxy" 检查是否已编译进内。若缺失，需重新编译或使用含模块的发行版（如 Ubuntu 的 nginx-full）。
缓存路径与区域定义
在 http 块中声明缓存区，注意层级与内存配比：
proxy_cache_path /var/cache/nginx/thumbs levels=1:2 keys_zone=thumb_cache:64m max_size=5g inactive=30d use_temp_path=off;
说明：
-
levels=1:2：生成两级子目录（如
/a/3f/），避免单目录文件过多影响性能； - keys_zone=thumb_cache:64m：64MB 内存存 key+元数据，约可容纳 50 万条缓存记录；
-
inactive=30d：30 天未被访问的缩略图自动清理，不依赖响应头中的
Expires或Cache-Control； - use_temp_path=off：跳过临时写入再 move 的步骤，提升写入效率。
图片请求路由与尺寸解析
用正则匹配 URL 中的尺寸标识（如 /photo.jpg!300x200 或 /avatar.png?w=120&h=120&fit=cover），提取参数并设为变量：
location ~* ^/(.+)\.(jpe?g|png|webp)!(\d+)x(\d+)$ {
set $src_path /raw/$1.$2;
set $width $3;
set $height $4;
set $filter "resize $width $height";
}
或更灵活地支持 query 参数：
location ~* \.(jpe?g|png|webp)$ {
if ($args ~* "w=(\d+)&h=(\d+)") {
set $width $1;
set $height $2;
}
# fallback 尺寸逻辑可在此补充
}
注意：image_filter 不支持百分比或自适应高度，必须明确宽高值；若只需等比缩放，用 resize $width - 即可（- 表示按比例推算）。
代理链与缓存联动配置
典型双层结构：前端 server 接收请求 → 应用 image_filter → 缓存响应 → 后端 server 提供原始图片。配置示意：
# 缩略图服务（带缓存）
server {
listen 80;
server_name img.example.com;
<p>location ~* ^/(.+).(jpe?g|png|webp)!(\d+)x(\d+)$ {
proxy_cache thumb_cache;
proxy_cache_valid 200 302 7d; # 成功响应缓存 7 天
proxy_cache_valid 404 1m; # 图片不存在也缓存 1 分钟，防刷
proxy_cache_lock on; # 防止缓存失效时多个请求同时回源
proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504;</p><pre class="brush:php;toolbar:false;">proxy_pass https://origin-server$uri;
proxy_set_header Host origin.example.com;
proxy_set_header X-Real-IP $remote_addr;
# 触发缩放
image_filter resize $3 $4;
image_filter_jpeg_quality 85;
image_filter_webp_quality 80;} }
其中 origin-server 可是 upstream 组，也可直写 S3 endpoint 或本地路径。重点是：
- proxy_cache_lock on：首次未命中时，只放行一个请求去生成缩略图，其余等待该结果并复用；
- proxy_cache_use_stale：网络抖动或上游短暂不可用时，仍可返回旧缓存，保障可用性；
- image_filter_*_quality：显式控制输出质量，避免默认压缩率过高导致模糊。
不复杂但容易忽略
