打开浏览器的开发者工具看一眼网络面板,你会发现一个典型的页面:1 个 HTML 文档请求,后面跟着 3-5 个 CSS、8-15 个 JavaScript、30-60 张图片和字体。也就是说,用户访问一次页面产生的请求里,95% 以上都是静态资源。如果这些请求和动态请求共用同一个域名、同一台服务器、同一套 PHP 或 Java 进程,会发生什么?大量短小的静态请求会占满连接槽位、消耗 worker 时间、传输重复的 Cookie 头,把真正需要计算的动态请求挤到后面排队。动静分离就是把这 95% 的请求从主站搬走,让动态服务专心处理那 5%。这是所有性能优化里投入产出比最高的一步,而且它几乎不需要改业务代码。
一、为什么要分离:四个具体的收益
第一,连接与进程资源被释放。动态请求通常要占用后端进程几百毫秒(查库、渲染),而静态请求只需要几毫秒读文件。混在一起时,一个 100 并发的页面访问会产生 5000 个请求,其中 4800 个是静态的,它们会把 Nginx 的 worker_connections 和后端连接池迅速占满,导致动态请求 502。
第二,Cookie 不再被无谓传输。浏览器对同域名下的所有请求都会带上 Cookie。一个登录用户的 Cookie 可能有 1-2KB,60 个静态请求就是 60-120KB 的无谓上行流量。用独立域名(如 static.example.com)承载静态资源后,该域名下不会写入业务 Cookie,请求头大幅减小。
第三,缓存策略可以差异化。HTML 必须频繁更新,缓存时间要短甚至不缓存;而带版本号的文件名(如 app.a3f9c2.js)内容永不改变,可以缓存一年。共用域名和路径时,这种差异化很难做干净。
第四,可以独立扩展和加速。静态资源可以单独放到 CDN 上,源站带宽压力下降 80% 以上,同时用户从就近节点下载,首屏时间明显缩短。
二、目录与域名规划
动静分离的第一步是规划。常见的两种组织方式:
| 方案 | 做法 | 优点 | 缺点 | 适用 |
|---|---|---|---|---|
| 同域名子路径 | www.example.com/static/ | 改动最小,无需处理跨域 | Cookie 仍会带上,缓存策略受限 | 小型站点、过渡阶段 |
| 独立域名 | static.example.com | 无 Cookie、可独立 CDN 与独立部署 | 需处理 CORS 与字体跨域 | 推荐,绝大多数场景 |
| 独立域名 + 多分片 | s1/s2/s3.example.com | 突破浏览器单域名并发限制 | 增加 DNS 与证书成本 | HTTP/1.1 时代的旧方案,HTTP/2 下已无必要 |
关于分片:在 HTTP/1.1 时代,浏览器对同一域名通常限制 6 个并发连接,所以会把静态资源分到多个子域名来提高并发。但 HTTP/2 通过多路复用在单连接上并发传输,分片反而有害(多个域名意味着多个 TCP 连接、多次 TLS 握手、无法复用)。如果站点已经启用 HTTP/2,用单一独立域名即可,不要分片。
推荐的目录结构:
/data/static/
├── css/
│ └── app.a3f9c2d1.css
├── js/
│ └── app.7b21e4f0.js
├── img/
│ ├── banner/
│ └── product/
├── fonts/
│ └── iconfont.woff2
└── upload/ # 用户上传,单独挂载大容量盘或对象存储
└── 2025/10/
注意 upload/ 与其他目录分开:用户上传内容增长不可控、访问模式不同、且可能需要缩放处理,最好独立挂载甚至直接放到对象存储上。
三、Nginx 静态资源配置:expires、Cache-Control 与 ETag
静态资源部署的核心配置是一组缓存响应头。先看一份完整的 server 配置:
server {
listen 80;
server_name static.example.com;
root /data/static;
# 关闭日志中的静态请求,或用单独日志文件避免撑爆主日志
access_log /var/log/nginx/static.access.log main buffer=64k flush=5s;
# 1. 带版本号/哈希的文件名:内容不变,可长期缓存
location ~* ^/(css|js)/.+\.[0-9a-f]{8}\.(css|js)$ {
expires 1y;
add_header Cache-Control "public, max-age=31536000, immutable";
add_header X-Content-Type-Options "nosniff";
try_files $uri =404;
}
# 2. 图片、字体:内容更新频率低,中等时长缓存
location ~* \.(jpg|jpeg|png|gif|webp|avif|ico|svg|woff2?|ttf)$ {
expires 30d;
add_header Cache-Control "public, max-age=2592000";
add_header Access-Control-Allow-Origin "https://www.example.com";
try_files $uri =404;
}
# 3. 用户上传:允许覆盖,缓存时间保守
location /upload/ {
expires 7d;
add_header Cache-Control "public, max-age=604800";
}
# 4. HTML 与无版本号资源:不该被长期缓存
location ~* \.(html|htm)$ {
expires -1;
add_header Cache-Control "no-cache";
}
# 5. 压缩与高效传输
gzip on;
gzip_types text/css application/javascript image/svg+xml application/json;
gzip_min_length 1024;
gzip_comp_level 5;
sendfile on;
tcp_nopush on;
tcp_nodelay on;
open_file_cache max=10000 inactive=60s;
open_file_cache_valid 60s;
open_file_cache_min_uses 2;
}
几个关键点解释:
3.1 expires 与 Cache-Control 的关系
expires 1y; 会生成 Expires 和 Cache-Control: max-age=31536000 两个头。当两者同时存在时,HTTP/1.1 规范规定 Cache-Control 的 max-age 优先于 Expires。所以上面配置里我又显式加了一次 Cache-Control,是为了附加 public 和 immutable 指令——注意 Nginx 的 add_header 不会覆盖 expires 生成的同名头,而是会同时存在两个 Cache-Control 头,这在部分 CDN 上会造成歧义。更干净的做法是只用 add_header,不写 expires:
location ~* ^/(css|js)/.+\.[0-9a-f]{8}\.(css|js)$ {
add_header Cache-Control "public, max-age=31536000, immutable";
add_header X-Content-Type-Options "nosniff";
try_files $uri =404;
}
immutable 是一个很有用的指令:它告诉浏览器"这个资源在 max-age 期间绝不会变,即使用户按 F5 刷新也不要发条件请求验证"。对带哈希文件名的资源,这能消除大量 304 请求。
3.2 ETag 与 Last-Modified
Nginx 对静态文件默认自动生成 ETag 和 Last-Modified 响应头,无需额外配置。当浏览器本地缓存过期后,它会发起条件请求:If-None-Match: "xxx"(对应 ETag)或 If-Modified-Since(对应 Last-Modified)。如果文件未变,Nginx 返回 304 Not Modified,响应体为空,只有几十字节的头部。
ETag 的默认生成规则是 文件的 mtime + 文件大小(十六进制表示)。这里有个集群部署的经典坑:多台机器上的同一个文件如果 mtime 不同,ETag 就不同,用户从 A 机器拿到 ETag 后请求落到 B 机器,会判定为已修改而重新下载整个文件,缓存完全失效。解决办法有三:
- 部署时用
rsync -a或touch -r保证各机器 mtime 一致; - 在多台机器前使用单一入口(负载均衡 + 一致性哈希),让同一资源固定落到同一台;
- 对带哈希文件名的资源直接关闭 ETag,因为文件名已经承担了版本判断职责:
etag off;
第三种最常用。带版本号的静态资源根本不需要协商缓存,直接强缓存一年即可。
四、版本化文件名:解决"改了不生效"
如果给 CSS 设置了 30 天强缓存,然后你改了样式发布,用户浏览器在 30 天内都不会去请求新文件——这就是"改了不生效"的根源。解决方案是让文件名随内容变化:内容一变,文件名就变,用户自然会下载新文件。
| 方案 | 示例 | 优点 | 缺点 |
|---|---|---|---|
| 内容哈希文件名 | app.a3f9c2d1.css | 精确,未变更文件可长期缓存 | 需构建工具生成并替换引用 |
| 版本号目录 | /v1.2.3/css/app.css | 实现简单,可整体回滚 | 小改动也要下载全部资源 |
| 查询串 | app.css?v=1.2.3 | 改动最小 | 部分 CDN 与代理不缓存带查询串的 URL |
内容哈希是首选方案,它由 webpack、Vite、Rollup 等构建工具自动生成(配置 [contenthash] 或 [hash]),配合 HTML 里自动替换引用即可。查询串方案虽然最简单,但有明显缺陷:一部分 CDN 和老旧的中间代理默认不缓存带 ? 的 URL,会导致缓存命中率为零,不建议使用。
发布流程应该是:先上传新的静态资源,再发布引用新资源名的 HTML。反过来会导致短暂的 404(HTML 引用了还没上传的资源)。滚动发布多台机器时,要保证新旧版本的静态资源在一段时间内共存,而不是直接覆盖。
# 用内容哈希重命名并生成清单(以手工方式示意,实际由构建工具完成)
cd /data/static/css
for f in *.css; do
hash=$(md5sum "$f" | cut -c1-8)
cp "$f" "${f%.css}.${hash}.css"
done
# 保证多台机器文件 mtime 一致(若仍依赖 ETag)
rsync -a --delete /data/static/ user@10.0.0.12:/data/static/
rsync -a --delete /data/static/ user@10.0.0.13:/data/static/
# 校验两台机器上同一文件的 ETag 是否一致
curl -sI http://10.0.0.12/css/app.a3f9c2d1.css | grep -i etag
curl -sI http://10.0.0.13/css/app.a3f9c2d1.css | grep -i etag
五、接入 CDN:回源与缓存键
静态资源独立部署之后,下一步通常是在前面套一层 CDN。理解 CDN 有两个核心概念:回源和缓存键。
5.1 回源(Origin Pull)
CDN 节点上没有资源时,会向源站发起请求拉取,这叫回源。回源率是衡量 CDN 效果的关键指标:理想状态下回源率应低于 5%,即 95% 以上的请求由 CDN 边缘节点直接返回。回源率高的常见原因有三个——缓存时间设得太短、缓存键设计不当导致同一文件被缓存成多份、URL 带随机参数导致每次都是新 key。
源站侧必须做的几件事:
- 在 Nginx 上配置正确的
Cache-Control,CDN 通常以此为准; - 源站要能承受"缓存失效瞬间的全量回源",必要时配置回源限流或使用 CDN 的分层回源(边缘节点 → 中间源 → 源站);
- 通过
real_ip模块还原真实客户端 IP,否则日志里全是 CDN 节点 IP:
# 在源站 Nginx 的 http 段配置,让日志与限流拿到真实客户端 IP # 具体 CDN 节点 IP 段请向服务商索取官方列表 set_real_ip_from 0.0.0.0/0; real_ip_header X-Forwarded-For; real_ip_recursive on; # 若 CDN 使用自有头(如 Ali-Cdn-Real-Ip / CF-Connecting-IP),改用对应头 # real_ip_header CF-Connecting-IP;
5.2 缓存键(Cache Key)
缓存键决定了 CDN 把什么视为"同一个文件"。默认缓存键通常是 域名 + URI 路径(不含查询串)或 域名 + 完整 URL(含查询串),不同厂商默认值不同,必须按业务调整:
- 静态资源(带哈希文件名):缓存键用「路径」,忽略查询串。否则
?from=xx、?t=123这类无关参数会让同一个文件缓存成几十份,回源率飙升。 - 需要按参数区分的接口:缓存键必须包含关键查询参数,且要显式指定保留哪些参数(而不是全保留),避免参数顺序不同或无关参数带来的缓存分裂。
- 需要按设备区分:若 PC 与移动端返回不同内容,缓存键应包含
User-Agent或自定义的Vary头(如 CDN 的"按 UA 缓存"选项)。更好的做法是分域名或分路径(/m/),避免在同一 URL 上返回不同内容。 - 需要按登录态区分:登录用户的页面不应被 CDN 缓存,应走
private或直接绕过 CDN。
判断 CDN 是否生效的标准动作:
# 1. 查看响应头中的缓存状态(不同厂商头名不同,常见如下)
curl -sI https://static.example.com/css/app.a3f9c2d1.css | grep -iE 'cache-control|x-cache|cf-cache-status|age|via|server'
# 2. 连续两次请求,观察 Age 是否增长(Age 增长说明命中了 CDN 缓存)
curl -sI https://static.example.com/css/app.a3f9c2d1.css | grep -i '^age'
sleep 3
curl -sI https://static.example.com/css/app.a3f9c2d1.css | grep -i '^age'
# 3. 验证协商缓存:带上 ETag 发起条件请求,期望返回 304
ETAG=$(curl -sI https://static.example.com/img/logo.png | grep -i etag | awk '{print $2}' | tr -d '\r')
curl -sI -H "If-None-Match: $ETAG" https://static.example.com/img/logo.png | head -1
# 4. 对比首字节时间,判断就近节点是否生效
curl -s -o /dev/null -w 'dns=%{time_namelookup} connect=%{time_connect} ttfb=%{time_starttransfer} total=%{time_total}\n' \
https://static.example.com/css/app.a3f9c2d1.css
指标判读:time_starttransfer(TTFB)对静态资源来说应低于 100ms(同地域 CDN 节点通常在 20-50ms);如果 TTFB 高达几百毫秒且 Age 一直是 0,说明每次都在回源,缓存没有生效。
六、实施步骤清单
- 梳理清单:用浏览器网络面板或日志统计,列出所有静态资源的路径前缀与请求占比,确认分离范围。
- 准备独立目录:
/data/static,按 css/js/img/fonts/upload 分类,本地资源迁入,用户上传单独处理。 - 申请独立域名与证书:
static.example.com,配置 DNS 解析;若接入 CDN 需要把域名 CNAME 到 CDN 提供的地址。 - 部署 Nginx 静态站点:配置 root、缓存头、gzip、
open_file_cache,用try_files兜底 404。 - 改造模板引用:把页面里的相对路径改成静态域名的绝对 URL,最好抽成配置项,方便环境与 CDN 切换。
- 引入内容哈希文件名:在构建流程中启用,并确认 HTML 引用同步更新。
- 处理跨域:字体文件(woff2)、Canvas 读取图片、模块化 JS 需要 CORS 头,配置
Access-Control-Allow-Origin指向主站域名(不要用通配符*配合带凭证的请求)。 - 接入 CDN:配置源站地址、缓存键规则、忽略查询串、缓存刷新接口,并把真实 IP 还原配置到源站。
- 验证:检查响应头、Age 增长、304 生效、TTFB 下降,并确认源站带宽下降。
- 建立刷新流程:发布时按 URL 或目录刷新 CDN 缓存,并保留"版本号 + 长期缓存"作为主策略,把刷新作为兜底而非常规手段。
小结
静态资源独立部署的本质,是把占请求数 95% 但计算量极小的部分,从主站链路中剥离出去,交给专门的静态服务或 CDN 处理。技术上它由四块拼成:独立域名与目录(消除 Cookie、隔离资源)、缓存响应头(Cache-Control: public, max-age, immutable)、版本化文件名(内容哈希,让长期缓存和更新发布不冲突)、CDN 回源与缓存键配置(决定 CDN 是否真的生效)。
避坑清单:
- 只对 HTML 设了长缓存,导致改版后用户长时间看到旧页面——HTML 用
no-cache,静态资源用长缓存。 - 用查询串
?v=1.0做版本号,但 CDN 默认不缓存带查询串的 URL,缓存命中率为零——改用内容哈希文件名。 - 多台机器 ETag 不一致导致协商缓存失效——要么统一 mtime,要么对版本化资源关闭 ETag。
- 接入 CDN 后没配置真实 IP 还原,导致限流和 ip_hash 全部失效(所有请求都来自 CDN 节点)。
- 缓存键包含全部查询参数,导致同一文件被缓存成几十份,回源率居高不下。
- 字体文件跨域未配置 CORS,导致图标全部不显示,且这个问题只在独立域名后才出现,容易在上线时被忽略。
- 发布顺序颠倒:先发 HTML 再传静态资源,造成短暂 404。务必先资源后页面,并保留新旧版本共存一段时间。
本文 Nginx 指令基于 1.18+ 开源版;CDN 相关配置项名称各厂商不同(缓存键、回源、刷新接口),请以所用服务商的官方文档为准。
企业QQ咨询




