在 nginx 中配置 proxy_cache 与 gzip 配合,核心在于确保缓存的是压缩后的响应体,并正确传递 content-encoding 头。具体做法是开启 gzip_static 或后端直接返回 gzip 数据,同时在 proxy_cache 配置中设置 proxy_cache_valid 和 proxy_cache_key,并确保 proxy_set_header accept-encoding 允许压缩。这样 nginx 会将压缩后的内容存入缓存,后续请求直接返回压缩文件,减少带宽和 cpu 开销。

如何配置 Nginx 以缓存压缩后的静态资源
要缓存压缩后的静态资源,需启用 gzip_static 模块并配置 location 块。Nginx 会先检查是否存在 .gz 文件,若存在则直接返回,否则尝试动态压缩。此过程不涉及反向代理,但为理解缓存机制奠定基础。

server {
listen 80;
server_name example.com;
location /static/ {
root /var/www/html;
gzip_static on;
expires 30d;
add_header Cache-Control "public, immutable";
}
}
预期结果:当访问 /static/style.css 时,若存在 /var/www/html/static/style.css.gz,Nginx 将返回该文件并设置 Content-Encoding: gzip。否则,若客户端支持 gzip,Nginx 动态压缩后返回,但不缓存动态生成的压缩内容,除非额外配置。
如何在反向代理中缓存后端返回的 gzip 响应
在反向代理场景中,需确保 Nginx 向后端发送 Accept-Encoding: gzip,并缓存包含 Content-Encoding: gzip 头的响应。关键配置包括 proxy_cache、proxy_cache_key 和 proxy_cache_valid。

http {
proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m use_temp_path=off;
server {
listen 80;
server_name api.example.com;
location /api/ {
proxy_pass http://backend;
proxy_cache my_cache;
proxy_cache_key $scheme$proxy_host$request_uri;
proxy_cache_valid 200 302 10m;
proxy_cache_valid 404 1m;
proxy_set_header Accept-Encoding gzip;
add_header X-Cache-Status $upstream_cache_status;
}
}
}
预期结果:首次请求 /api/data 时,Nginx 向后端发送 Accept-Encoding: gzip,后端返回 gzip 压缩数据,Nginx 缓存该压缩响应。后续相同请求直接从缓存读取并返回,X-Cache-Status 显示 HIT。若后端未返回 gzip 数据,Nginx 可能缓存未压缩版本,导致重复解压开销。
当后端返回非 gzip 响应时,Nginx 缓存行为如何变化
若后端未返回 gzip 压缩数据(如缺少 Content-Encoding: gzip),Nginx 仍会缓存响应,但内容为原始未压缩格式。此时,若客户端请求带 Accept-Encoding: gzip,Nginx 不会动态压缩缓存内容,而是直接返回未压缩数据,可能导致带宽浪费。
server {
listen 80;
server_name api.example.com;
location /api/ {
proxy_pass http://backend;
proxy_cache my_cache;
proxy_cache_key $scheme$proxy_host$request_uri;
proxy_cache_valid 200 302 10m;
proxy_set_header Accept-Encoding gzip;
add_header X-Cache-Status $upstream_cache_status;
# 注意:此处未启用 dynamic gzip,仅依赖后端压缩
}
}
预期结果:当后端返回未压缩 JSON 时,Nginx 缓存该未压缩内容。客户端请求时,即使发送 Accept-Encoding: gzip,Nginx 也不会压缩缓存内容,直接返回未压缩数据。若要强制压缩,需启用 gzip on; 并在 proxy_cache 外处理,但这会绕过缓存优化。











