如何利用 Nginx 缓存校验(ETag)机制减少后端带宽占用

冬杰小哥_9402

冬杰小哥_9402

2026-06-12

385人浏览

原创

nginx 不生成、不校验、不决定 etag,仅透传条件请求头并复用后端返回的 304 响应;关键在于后端稳定输出语义准确的 etag、客户端携带 if-none-match、nginx 正确缓存并转发,三者协同实现协商缓存以节省带宽。

如何利用 nginx 缓存校验(etag)机制减少后端带宽占用

Nginx 本身不主动“校验 ETag”,也不会在缓存过期后自动发起 If-None-Match 请求——它只在收到客户端带条件头(如 If-None-Match 或 If-Modified-Since)的请求时,才转发这些头给后端,并根据后端返回的 304 Not Modified 复用本地缓存体。所谓“利用 ETag 减少后端带宽”,本质是让整个链路支持协商缓存:客户端→Nginx→后端,三者协同,使多数请求最终以 304 响应结束,仅传输响应头(200–500 字节),而非完整响应体。

关键不在 Nginx 配什么指令,而在整条链路是否闭环

Nginx 不生成、不校验、不决定 ETag 的值,它只是透传和响应。真正起作用的是:

  • 后端是否稳定输出语义准确的 ETag(如基于内容哈希)
  • 客户端是否在后续请求中携带 If-None-Match
  • Nginx 是否正确缓存了含 ETag 的原始响应,并在收到条件请求时原样转发

只要这三点成立,Nginx 就能复用缓存体,节省响应体带宽。

确保后端输出可验证的 ETag

静态资源(.js/.css/.png)由 Nginx 自身托管时,默认启用 etag on,且基于文件大小+修改时间生成 ETag,基本可用。
动态接口(如 /api/user)则需后端主动实现:

  • 首次响应必须包含 ETag: "abc123"(建议用内容 MD5 或 SHA256,避免时间戳或随机数)
  • 收到 If-None-Match: "abc123" 时,严格比对:完全一致 → 返回 304 Not Modified
  • 304 响应体必须为空,禁止设置 Content-Length: 0 或分块编码(Transfer-Encoding: chunked),否则 Nginx 可能解析失败而降级为 200

Nginx 端需启用基础缓存并保留 ETag 头

无需额外“开启 ETag 校验”,但必须保证缓存流程不破坏协商机制:

Nginx Hosting
Nginx Hosting

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

下载
  • 启用缓存区域(http 块):
    proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m inactive=1h max_size=1g;
  • 在 location 中启用缓存,并允许缓存含 ETag 的响应:
    proxy_cache my_cache;
    proxy_cache_valid 200 302 10m;
    # 默认会缓存 ETag、Last-Modified 等头,无需显式配置
  • 不要忽略 Vary 或 Set-Cookie:若后端返回 Set-Cookie,Nginx 默认跳过缓存;如接口无用户态,加:
    proxy_ignore_headers Set-Cookie Vary;

让客户端真正发起条件请求

浏览器是否发 If-None-Match,取决于它本地是否有该资源的 ETag 缓存,以及是否过了 Cache-Control 或 Expires 的强缓存期。

  • 推荐组合策略:
    • 强缓存:Cache-Control: public, max-age=300(5 分钟内直接读本地)
    • 协商缓存:5 分钟后,浏览器自动带 If-None-Match 发起验证
  • 若想更早触发验证(比如 HTML 页面),可设短强缓存 + 永久可协商:
    add_header Cache-Control "public, no-cache, must-revalidate";
    # 浏览器每次都会发条件请求,但 Nginx 只在缓存有效期内直接返回 HIT

避免并发击穿,防止条件请求被放大

多个请求同时命中过期缓存,若都转发 If-None-Match,会造成回源压力倍增:

  • 开启缓存锁,确保只有一个请求去验证:
    proxy_cache_lock on;
    proxy_cache_lock_timeout 5s;
  • 允许前台返回旧缓存,后台异步刷新(提升用户体验):
    proxy_cache_use_stale updating;
    proxy_cache_background_update on;

不复杂但容易忽略

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

nginx nginx缓存配置

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2483

5

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

6390

13

后端的主要工作内容介绍
后端的主要工作内容介绍

后端是应用程序的服务端部分,负责核心任务,如数据库交互、业务逻辑处理和响应客户端请求。想了解更多后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

5786

10

nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.27

403

5

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3547

6

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

2023.08.04

6265

6

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

581

5

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.07.09

1496

5

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

2024.08.07

3958

3

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

nginx手册
nginx手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习