在美国洛杉矶服务器上用Nginx提供静态资源,怎样设置浏览器缓存?

发布人:A5数据发布时间:2026-11-17 15:06阅读量:3

同一个 JavaScript 文件,第一次打开页面时可能需要经过 DNS、TCP、TLS 和 HTTP 请求才能从美国洛杉矶服务器返回;再次进入页面时,浏览器却可能完全不访问服务器。即使服务器位置、文件内容和访问地址都没有变化,浏览器是否发起请求,仍取决于响应中的缓存策略、资源 URL 是否变化,以及资源是否已经过期。

Nginx 能做的是通过 HTTP 响应头告诉浏览器“这个文件可以保存多久、何时需要重新确认、是否允许共享缓存”。因此,设置浏览器缓存不能只看 expires 或 max-age 一个参数,还要把资源更新方式、文件匹配规则、压缩、连接复用和上游响应一起考虑。

先区分浏览器缓存、Nginx缓存和文件传输

浏览器缓存是客户端行为。资源首次返回后,浏览器根据 Cache-Control、Expires、ETag、Last-Modified 等响应头保存资源。下次访问相同的 URL 时,浏览器会先判断本地副本是否仍然新鲜。

Nginx本地静态文件服务则负责读取磁盘上的文件并返回响应。它可以发送缓存头,也可以使用 sendfile 减少用户态与内核之间的数据复制,但 sendfile 不会让浏览器保存文件,keepalive_timeout 也不会改变缓存时长。

如果Nginx前面还有CDN或其他反向代理,还会多出一层共享缓存。此时需要区分以下三种情况:

先区分浏览器缓存、Nginx缓存和文件传输配图

  • 浏览器缓存命中:浏览器不向Nginx发请求。
  • 浏览器缓存过期后重新验证:浏览器向Nginx发请求,但可能只得到 304 Not Modified,不重新下载文件正文。
  • 浏览器缓存未命中:Nginx返回 200 和完整资源内容。
  • 代理缓存命中:请求已经到达CDN或Nginx,但上游应用可能没有被访问。

这几种结果在浏览器开发者工具中可能分别显示为“memory cache”“disk cache”“304”或“200”。它们并不等价。

浏览器状态是否访问Nginx是否传输资源正文典型结果
新鲜缓存命中否否浏览器直接使用本地文件
缓存过期并重新验证是通常否304 Not Modified
本地没有资源是是200 OK
设置了 no-store每次通常都需要请求通常是不保存响应内容

304 不是“没有使用缓存”,而是“使用了缓存,但先向服务器确认本地副本仍然有效”。它仍然需要一次请求和响应,在用户与洛杉矶服务器之间存在较大往返延迟时,页面仍会受到影响。

缓存策略应先服从资源更新方式

缓存时间不能脱离文件命名策略单独决定。对于内容带有版本指纹的静态资源,可以放心设置较长的缓存时间;对于始终使用相同文件名的资源,则需要缩短缓存时间或要求浏览器重新验证。

带内容指纹的资源使用长期缓存

构建工具通常会生成类似下面的文件:

/assets/app.8f3c1.js
/assets/style.41a7d.css
/assets/logo.2b61e.svg

当 JavaScript 或 CSS 内容发生变化时,文件名中的指纹也会变化。浏览器请求新 URL 时,不会把旧 URL 的缓存误认为新文件,因此适合使用:

Cache-Control: public, max-age=31536000, immutable

其中:

  • max-age=31536000 表示在约一年内视为新鲜;
  • public 表示该响应可以被共享缓存保存,适合不含用户私有数据的公共静态资源;
  • immutable 表示在新鲜期内资源内容不会改变,浏览器不必为了确认文件是否更新而重新验证。

这里真正重要的不是“一年”这个数字,而是 URL 是否具备内容版本标识。如果 /assets/app.js 的内容可能被直接覆盖,就不应简单套用一年缓存。

不带指纹的资源使用短缓存或重新验证

如果文件始终叫作:

/assets/app.js
/assets/style.css

可以使用较短的缓存时间:

Cache-Control: public, max-age=300, must-revalidate

这表示浏览器可以在五分钟内直接使用本地副本,超过时间后需要向服务器确认。也可以使用:

Cache-Control: no-cache

no-cache 的含义不是“完全不保存”,而是“可以保存,但再次使用前需要重新验证”。如果文件没有变化,服务器可能返回 304;如果文件发生变化,则返回新的 200 内容。

no-store 才是“不保存响应内容”。它适合包含敏感信息或不应落盘的数据,不应随意用于所有公共静态资源,否则会失去浏览器缓存带来的收益。

HTML入口文件通常不宜长期缓存

即使 JavaScript 和 CSS 使用一年缓存,引用这些资源的 index.html 仍需要较快更新。常见做法是让 HTML 重新验证:

缓存策略应先服从资源更新方式配图

Cache-Control: no-cache

这样发布新版本时,浏览器可以较快获取新的 HTML,并发现新的资源指纹。

如果把 HTML 也设置为一年缓存,而又没有文件名版本化,用户可能长时间拿到旧的资源引用。此时服务器即使已经发布新文件,浏览器也不会主动请求新的 HTML。

查询参数版本也能工作,但路径指纹更直观

下面的写法也可以形成不同的缓存 URL:

/assets/app.js?v=20250308

浏览器通常会把不同查询参数视为不同缓存条目。不过,路径指纹更容易与构建产物、发布记录和回滚流程对应,也更便于观察日志。无论采用哪一种方式,都要保证内容改变时 URL 确实改变。

用Nginx为静态资源设置缓存头

假设站点文件位于 /srv/www/site,带指纹的资源统一放在 /assets/ 目录。下面是一个适合本地静态文件服务的示例:

server {
    root /srv/www/site;

    # 带内容指纹的 CSS、JavaScript、图片和字体
    location ^~ /assets/ {
        try_files $uri =404;

        etag on;
        add_header Cache-Control "public, max-age=31536000, immutable" always;
    }

    # 入口 HTML 需要及时重新验证
    location = /index.html {
        try_files $uri =404;

        add_header Cache-Control "no-cache" always;
    }

    # 其他路径按站点实际路由处理
    location / {
        try_files $uri $uri/ /index.html;
    }
}

这段配置有几个关键点。

使用try_files防止错误内容被当成静态资源

try_files $uri =404;

它要求请求路径确实对应磁盘上的文件。文件不存在时直接返回 404,而不是把一个 HTML 页面作为 JavaScript 或 CSS 返回。

对于单页应用,常见的兜底规则是:

try_files $uri $uri/ /index.html;

但这个规则不应覆盖静态资源目录。否则当 /assets/app.8f3c1.js 拼写错误或文件未上传时,Nginx可能返回 index.html,浏览器收到的状态码仍可能是 200,最终表现为脚本解析错误或页面加载异常。使用 ^~ /assets/ 可以让资源目录优先使用明确的文件查找规则。

带^~ /assets/的静态资源请求先执行try files $uri =404,文件存在返回200静态文件、文件缺失返回404;普通页面请求执行try fi

###etag和Last-Modified用于条件请求

Nginx为本地静态文件提供 ETag 和 Last-Modified 后,浏览器缓存过期时可以发送:

If-None-Match: "..."

或:

If-Modified-Since: ...

服务器判断文件未变化后返回:

304 Not Modified

此时响应通常不包含完整文件正文,节省了带宽,但仍需处理一次 HTTP 请求。ETag 默认通常已经启用,示例中显式写出 etag on; 是为了让配置意图更清楚。

###always可以让响应头覆盖更多状态

add_header 后面的 always 可以让Nginx在错误响应等情况下也添加该响应头。不过,缓存策略最重要的仍然是正常的 200 响应。对于不存在的资源,通常不应让浏览器长时间缓存错误结果,因此还应结合 404 的缓存策略单独判断。

如果站点的 server 或 http 层已经存在其他 add_header,要注意Nginx的继承规则:子级 location 一旦声明了 add_header,可能不会继续继承父级的其他响应头。安全响应头、跨域响应头等需要在对应层级重新补齐,不能只添加缓存头后就认为其他头仍然自动存在。

###expires是另一种写法,不要与自定义缓存头重复使用

也可以这样设置一年缓存:

location ^~ /assets/ {
    try_files $uri =404;
    expires 365d;
}

expires 365d 会生成与过期时间相关的响应头。它适合简单场景,但不能直接表达 immutable。如果需要精确控制 public、max-age 和 immutable,通常使用 add_header Cache-Control 更直观。

不建议在同一个位置盲目同时使用:

expires 365d;
add_header Cache-Control "public, max-age=31536000, immutable" always;

这样可能产生重复或容易误读的缓存头。应当选择一种主要配置方式,并通过实际响应确认最终结果。

发布顺序决定长期缓存是否安全

使用一年缓存并不代表旧文件可以立即删除。一个较稳妥的静态资源发布顺序是:

  1. 先上传新的带指纹资源,例如 app.8f3c1.js。
  2. 确认文件权限和文件内容可被Nginx读取。
  3. 再发布引用新资源 URL 的 index.html。
  4. 保留旧版本资源一段时间,避免仍在使用旧 HTML 的客户端得到 404。
  5. 等旧版本不再需要后,再根据发布和回滚策略清理文件。

如果先更新 HTML,再上传新资源,用户可能在短时间内请求到 404。如果直接覆盖不带版本号的 app.js,已经处于长期缓存期的浏览器不会因为服务器文件发生变化而立即重新下载。

因此,长期缓存的前提是“旧 URL 永远代表旧内容”。如果同一个 URL 的内容会被覆盖,就应该使用短缓存、重新验证,或者在发布时改变 URL。

压缩会影响传输大小,但不改变缓存判定

静态缓存和内容压缩是两个不同层面:

  • 缓存决定浏览器是否需要请求资源;
  • 压缩决定请求资源时需要传输多少字节。

在洛杉矶服务器上,用户与服务器之间的距离不同,延迟、丢包和链路质量也不同。缓存命中可以直接跳过请求;缓存未命中时,压缩则可以减少传输量。

Nginx可以在 http 层配置常见文本资源的 gzip:

http {
    sendfile on;

    # 示例值,需结合连接数和访问模式调整
    keepalive_timeout 15s;
    keepalive_requests 1000;

    gzip on;
    gzip_vary on;
    gzip_min_length 1k;
    gzip_types
        text/plain
        text/css
        application/javascript
        text/javascript
        application/json
        image/svg+xml;
}

这里的 gzip_vary on; 很重要。服务器是否压缩,取决于客户端是否发送:

Accept-Encoding: gzip

因此响应应带有:

Vary: Accept-Encoding

它告诉缓存系统:支持 gzip 的客户端和不支持 gzip 的客户端,不应简单共用同一个表示形式。

PNG、JPEG、WebP、AVIF、MP4、ZIP 等内容本身通常已经压缩,再次 gzip 往往收益很小,反而增加CPU开销。字体格式是否压缩,也应根据实际文件类型和响应大小判断。gzip_min_length 1k 只是示例阈值,小文件的压缩头部和处理成本可能高于节省的传输量。

可以用一个估算理解缓存与压缩的差别。假设一组静态资源总量为十进制 1.8 MB,链路有效速率约为 100 Mbps,只计算正文传输时间:

  1. 1.8 MB × 8 = 14.4 Mb;
  2. 14.4 Mb ÷ 100 Mbps = 0.144 秒。

实际还要加上连接建立、TLS、请求响应、协议开销和网络波动。如果浏览器直接命中本地缓存,这部分传输时间和请求等待都可以省掉;如果只是收到 304,正文传输可以省掉,但请求往返仍然存在。这个计算是帮助理解机制的估算,不代表洛杉矶服务器的固定实测结果。

静态资源面向不同地区访问时,浏览器缓存之外还可结合 CDN 分发,减少请求直接回到源站的次数。A5数据提供 CDN 业务及美国服务器资源,可用于网站或应用的静态内容分发与源站承载;域名和 SSL 证书也可配合站点入口及 HTTPS 连接使用。

连接复用与浏览器缓存不是同一个开关

keepalive_timeout 控制的是HTTP连接空闲后保留多久,主要影响后续请求能否复用已有连接。它不会把资源保存到浏览器,也不会改变 Cache-Control: max-age=... 的时间。

在HTTP/1.1下,连接复用可以减少重复的TCP和TLS建立;在HTTP/2下,同一连接可以并发传输多个资源。因此,在静态资源很多但缓存尚未命中的页面中,合理的连接复用有助于降低请求开销。

不过,连接保持过久会占用文件描述符和连接资源;设置过短则可能让频繁访问的客户端反复建立连接。15s、1000 等配置只能作为示例,实际应结合并发连接数、HTTP版本、负载和监控结果调整。不能因为页面资源较多,就盲目把连接超时时间改成很大的数值。

sendfile on; 可以让Nginx更高效地把本地文件发送到网络套接字,适合本地静态资源。它改善的是服务器发送过程,不会替代浏览器缓存,也不会让已经过期的缓存自动变成新鲜。

本地静态资源和上游响应需要分开判断

如果静态文件由Nginx直接从磁盘读取,缓存结果主要由Nginx配置和文件响应头决定。此时不需要为静态资源配置 proxy_read_timeout。

如果资源实际由应用服务器或其他上游返回,就要同时检查上游响应。例如下面是一个概念性的接口代理配置:

location /api/ {
    proxy_pass http://app_backend;

    proxy_connect_timeout 5s;
    proxy_send_timeout 30s;
    proxy_read_timeout 60s;
}

这些参数的含义不同:

  • proxy_connect_timeout:Nginx连接上游服务器的等待时间;
  • proxy_send_timeout:向上游发送请求时,两次写操作之间允许的间隔;
  • proxy_read_timeout:等待上游返回数据时,两次读操作之间允许的间隔。

proxy_read_timeout 60s 不表示整个请求最多执行六十秒,而是两次读取之间不能长时间没有数据。它也不等于浏览器缓存时长,不会让浏览器保存接口响应。

同样,下面的配置属于Nginx自身的共享缓存,而不是浏览器缓存:

proxy_cache_valid 200 10m;

它控制Nginx代理缓存中的响应保存多久。客户端是否缓存,还要看最终返回给浏览器的 Cache-Control 等响应头。如果上游已经返回:

Cache-Control: no-store

而Nginx又额外添加长期缓存头,就可能出现重复或相互矛盾的策略。应用层和Nginx层应明确由哪一层负责设置缓存头,并通过实际响应确认结果。

对于包含登录状态、用户信息、权限结果或个性化内容的响应,不应套用公共静态资源的长期缓存策略。静态文件路径和接口路径也最好分开配置,避免把动态响应误判成可公开缓存的文件。

用命令确认Nginx实际返回了什么

修改配置前,应保留当前配置并先进行语法检查:

sudo nginx -t

如果检查通过,再平滑加载配置:

sudo systemctl reload nginx

不同发行版的服务管理方式可能不同,若服务名不是 nginx,应先通过系统服务列表确认。reload 通常不会主动断开现有连接,但配置文件路径、权限和站点结构仍应以当前服务器实际环境为准。

查看完整生效配置可以使用:

sudo nginx -T

这个命令适合确认实际加载了哪个 server、哪个 location,也能发现配置文件没有被主配置包含的情况。输出中可能包含站点内部信息,不要直接发布到公开渠道。

检查缓存头

使用一个带版本指纹的资源进行检查:

curl -sD - -o /dev/null \
  https://example.com/assets/app.8f3c1.js

理想情况下可以看到类似结果:

HTTP/2 200
cache-control: public, max-age=31536000, immutable
etag: "64f2-..."
last-modified: Tue, 12 Mar 2024 08:30:00 GMT

具体是否出现 HTTP/2、ETag 格式和时间内容,取决于协议、Nginx版本和文件状态。重点是确认:

  • 响应状态是否为预期的 200;
  • Cache-Control 是否符合资源更新方式;
  • 是否意外返回了 no-store;
  • 文件不存在时是否确实返回 404;
  • 是否有重复的 Cache-Control;
  • 是否有上游添加的冲突响应头。

curl本身不会像浏览器一样自动保存并使用缓存,所以连续执行两次这条命令,不代表浏览器会连续下载两次。它主要用于查看服务器返回的头部。

检查条件请求

从上一次响应中取出真实的 ETag 值,再发送条件请求:

curl -sD - -o /dev/null \
  -H 'If-None-Match: "替换为实际ETag"' \
  https://example.com/assets/app.8f3c1.js

文件未变化时,预期结果通常是:

HTTP/2 304

如果仍然返回 200,需要检查:

  • ETag 是否复制正确;
  • 请求是否到达了同一个站点;
  • 是否经过了会修改响应的CDN或代理;
  • 文件的修改时间或内容是否确实发生变化;
  • Nginx是否实际使用了预期的 location。

也可以用 Last-Modified 做验证:

curl -sD - -o /dev/null \
  -H 'If-Modified-Since: 替换为实际Last-Modified值' \
  https://example.com/assets/app.8f3c1.js

检查压缩和Vary

用带有 gzip 声明的请求检查压缩响应:

curl -sD - -o /dev/null \
  -H 'Accept-Encoding: gzip' \
  https://example.com/assets/app.8f3c1.js

如果资源大小达到压缩阈值,且类型在 gzip_types 中,可能看到:

content-encoding: gzip
vary: Accept-Encoding

如果没有 Content-Encoding,不一定表示配置错误,也可能是文件太小、响应类型不匹配,或请求没有携带可接受的编码。

在浏览器中观察真实缓存行为

浏览器开发者工具的 Network 面板比单纯的 curl 更适合观察浏览器缓存。可以重点查看:

用命令确认Nginx实际返回了什么 / 在浏览器中观察真实缓存行为配图

  • 请求是否实际出现在网络列表中;
  • Size 是否显示来自内存缓存或磁盘缓存;
  • Status 是否为 200 或 304;
  • Response Headers 中的 Cache-Control、ETag、Last-Modified;
  • 是否发生了 Content-Encoding: gzip;
  • 页面刷新方式是否触发了强制重新验证。

开发者工具中的“Disable cache”通常只在工具打开期间生效,适合测试未命中和首次加载,不适合判断普通用户的缓存命中效果。硬刷新、按住刷新按钮执行的特殊刷新操作,也可能让浏览器主动发送重新验证请求,因此不能把硬刷新结果直接当作普通访问结果。

常见配置误区与判断边界

给所有扩展名都设置一年缓存

仅凭文件扩展名判断“这是静态文件”并不总是安全。某些 .json 文件可能由接口动态生成,某些 .js 文件也可能是手工覆盖的未版本化文件。缓存时间应与内容是否稳定、URL是否版本化共同决定。

把no-cache理解成完全禁用缓存

no-cache允许浏览器保存文件,但要求再次使用前重新确认。它与no-store不同。需要减少重复下载但又希望及时感知更新时,no-cache往往比no-store更合适。

只看到304就认为缓存效果已经足够

304减少了正文传输量,却没有消除请求往返。对于体积较大的资源,304通常有明显带宽收益;对于体积很小、请求数量很多或网络延迟较高的资源,直接命中浏览器新鲜缓存的效果更好。

只调大连接超时时间

连接复用和缓存命中分别解决不同问题。缓存命中减少请求数量,连接复用减少每次请求的连接成本,压缩减少传输字节数。应先通过浏览器网络面板、Nginx访问日志和资源响应头判断瓶颈,再决定是否调整连接参数。

修改了配置却没有命中预期的location

Nginx的location匹配规则可能使请求进入另一个位置。例如站点使用了统一的反向代理规则,静态目录没有被单独排除,资源请求就可能先到应用服务器。检查 nginx -T 的实际配置,并用 curl查看响应头、状态码和服务标识,比只检查配置文件中的某一段更可靠。

判断浏览器缓存是否设置正确,至少要同时满足三个条件:版本化资源在正常访问时返回长期缓存头,未版本化或入口 HTML 能及时重新验证,资源不存在时不会被错误的路由兜底成 200 页面。对洛杉矶服务器而言,服务器地理位置会影响首次请求和重新验证的网络成本,但不会改变缓存协议本身;最终效果仍应以实际响应头、浏览器缓存状态和访问日志中的请求变化为准。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/10003.html

相关推荐