网站静态资源如何独立部署?图片、CSS与JavaScript分离方案

打开浏览器的开发者工具看一眼网络面板,你会发现一个典型的页面: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。

源站侧必须做的几件事:

  1. 在 Nginx 上配置正确的 Cache-Control,CDN 通常以此为准;
  2. 源站要能承受"缓存失效瞬间的全量回源",必要时配置回源限流或使用 CDN 的分层回源(边缘节点 → 中间源 → 源站);
  3. 通过 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,说明每次都在回源,缓存没有生效。

六、实施步骤清单

  1. 梳理清单:用浏览器网络面板或日志统计,列出所有静态资源的路径前缀与请求占比,确认分离范围。
  2. 准备独立目录:/data/static,按 css/js/img/fonts/upload 分类,本地资源迁入,用户上传单独处理。
  3. 申请独立域名与证书:static.example.com,配置 DNS 解析;若接入 CDN 需要把域名 CNAME 到 CDN 提供的地址。
  4. 部署 Nginx 静态站点:配置 root、缓存头、gzip、open_file_cache,用 try_files 兜底 404。
  5. 改造模板引用:把页面里的相对路径改成静态域名的绝对 URL,最好抽成配置项,方便环境与 CDN 切换。
  6. 引入内容哈希文件名:在构建流程中启用,并确认 HTML 引用同步更新。
  7. 处理跨域:字体文件(woff2)、Canvas 读取图片、模块化 JS 需要 CORS 头,配置 Access-Control-Allow-Origin 指向主站域名(不要用通配符 * 配合带凭证的请求)。
  8. 接入 CDN:配置源站地址、缓存键规则、忽略查询串、缓存刷新接口,并把真实 IP 还原配置到源站。
  9. 验证:检查响应头、Age 增长、304 生效、TTFB 下降,并确认源站带宽下降。
  10. 建立刷新流程:发布时按 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 相关配置项名称各厂商不同(缓存键、回源、刷新接口),请以所用服务商的官方文档为准。