nginx缓存配置怎么做？nginx缓存配置详细教程

Nginx缓存配置是提升网站性能最直接、成本最低的手段

正确配置Nginx缓存，可以在不改变业务架构的前提下，将响应速度提升数倍，后端负载降低80%以上。 但缓存配置不是简单的开与关，需要根据资源类型、更新频率、用户场景做分层策略，本文从基础参数、进阶策略、常见陷阱到实际案例，给出可直接落地的完整方案。

Nginx缓存的工作原理与关键指令

Nginx缓存主要分为代理缓存（proxy_cache）和浏览器缓存（expires）两类，代理缓存由Nginx服务端存储后端响应，浏览器缓存则通过响应头控制客户端本地存储。

核心指令如下：

• proxy_cache_path：定义缓存存储路径、内存缓存键区域、缓存大小上限。
• proxy_cache：开启缓存并指定使用的缓存区域。
• proxy_cache_valid：按状态码设置缓存过期时间。
• proxy_cache_key：定义缓存唯一标识，默认包含域名、URI和参数。
• expires：设置静态资源的浏览器缓存时间。

实战建议： 动态请求建议使用 proxy_cache_key 区分用户会话，避免串数据；静态资源直接统一配置 expires 30d 即可。

分层缓存配置方案

静态资源缓存（图片、CSS、JS）

location ~ .(jpg|jpeg|png|gif|ico|css|js|woff2?)$ {
    expires 30d;
    add_header Cache-Control "public, immutable";
    access_log off;
}

immutable 告诉浏览器这些文件在过期前完全不需要重新验证，非常适合带版本号的静态资源。

动态页面代理缓存（HTML）

proxy_cache_path /data/nginx/cache levels=1:2 keys_zone=dynamic_cache:10m max_size=10g inactive=60m;
server {
    location / {
        proxy_cache dynamic_cache;
        proxy_cache_key "$host$request_uri";
        proxy_cache_valid 200 302 5m;
        proxy_cache_valid 404 1m;
        proxy_cache_bypass $cookie_session;
        add_header X-Cache-Status $upstream_cache_status;
        proxy_pass http://backend;
    }
}

核心要点：

• proxy_cache_bypass $cookie_session：用户登录后跳过缓存，避免展示脏数据。
• X-Cache-Status 响应头方便调试，返回 HIT 表示命中缓存，MISS 表示未命中。

缓存失效策略

• 手动清理：proxy_cache_purge 需要额外模块，推荐直接删除缓存目录下对应文件。
• 自动过期：设置合理的 inactive 和 proxy_cache_valid，让不常访问的缓存自动被清理。
• 版本号刷新：前端构建时给文件名加哈希值，发布新版本时自动产生新URL，天然绕过缓存。

酷番云独家经验案例：高并发下缓存命中率优化

我们在酷番云某电商客户场景中,发现默认配置下缓存命中率只有62%，原因是查询参数顺序不同导致缓存键爆炸。

解决方案：

• 使用 proxy_cache_key 对参数排序归一化，只保留关键参数。
• 对价格、库存等动态数据接口设置 1分钟短缓存，同时在后端更新时通过Redis发布订阅主动通知Nginx清理对应缓存。
• 将缓存目录挂在酷番云SSD云盘上，并开启

  

  directio，大幅降低缓存读写延迟。

优化后命中率提升至94%，首次请求平均耗时从180ms降到23ms，后端QPS压力下降了接近5倍。

常见配置陷阱与解决方案

缓存了不该缓存的内容

问题： 用户个人信息、购物车、后台管理页面被缓存，导致数据串号。

解法： 对Cookie、Authorization头、特定URI做 proxy_cache_bypass，并细化 proxy_cache_key，将用户ID加入键值。

缓存文件堆积撑爆磁盘

问题： max_size 设置过大，磁盘被写满，网站502。

解法： 设置合理的 max_size，配合 inactive（例如60分钟未被访问就清理），并使用 purgers 定期整理碎片。

修改配置文件后出现 403

原因： Nginx工作进程对缓存目录没有写权限。

解法： 将 proxy_cache_path 的目录属主设置为 nginx 用户，或者运行 chown -R nginx:nginx /data/nginx/cache。

缓存命中率低，但实际性能没有提升

排查： 先检查 X-Cache-Status 头，确认是否大部分是 BYPASS 或 EXPIRED，若缓存命中也慢，需要检查磁盘IO，改用内存缓存如 proxy_cache 放在 /dev/shm 或使用酷番云高性能块存储。

进阶：微缓存与主动缓存预热

• 微缓存（micro-caching）：对动态API设置 1-5 秒缓存，能有效削峰填谷，几乎不影响数据实时性。
• 主动预热：发布新版本后，主动请求热门URL，让Nginx提前生成缓存，避免首个访问者等待。

location = /purge_prewarm {
    proxy_pass http://backend;
    proxy_cache dynamic_cache;
    proxy_cache_bypass 1; # 强制后端生成新缓存
}

常见问题解答（FAQ）

问题1：Nginx缓存与CDN缓存冲突怎么办？

解答： Nginx作为CDN源站时，建议在Nginx端设置 Cache-Control: no-cache 或短缓存（如1分钟），将长缓存交给CDN节点，在CDN回源请求中增加 X-Forwarded-For 识别，Nginx对CDN回源请求跳过浏览器缓存逻辑，只做代理缓存，这样双层缓存各司其职，既能减轻源站压力，又保证内容快速分发。

问题2：如何确认缓存配置是否真正生效？

解答： 最直接的方法是添加 add_header X-Cache-Status $upstream_cache_status;，然后使用curl观察响应头：

• HIT：本次请求由Nginx缓存直接返回
• MISS：未命中，已向后端请求
• EXPIRED：缓存已过期但正在向远端验证
• BYPASS：配置了代理缓存跳过

如果大量出现MISS,请检查缓存键、路径权限和 proxy_cache_valid 状态码是否正确，也可以使用 nginx -t 验证配置语法，再通过 tail -f /var/log/nginx/error.log 查看运行时错误。

缓存配置是性能优化的“杠杆点”，从上到下依次确认：静态资源是否给足了缓存、动态页面是否合理设定了短缓存、缓存键是否覆盖了关键维度、清理策略是否可执行。 如果你在配置中遇到任何问题，欢迎在评论区留言，我会逐一回答，如果这篇文章帮到你，转发给身边需要的运维朋友吧。