Nginx 源码安装如何配置 expires 模块实现静态文件缓存

Nginx 的 expires 指令是核心功能，无需安装模块，源自默认启用的 http_headers 模块；必须在 location 块中配置，推荐按静态资源后缀或目录匹配并设置合理缓存时间，同时正确设置 Cache-Control 头。

不需要单独配置或安装“expires 模块”——expires 指令是 Nginx 核心功能，源码安装后默认就可用，无需额外编译选项或第三方模块。

为什么不用装 expires 模块

expires 属于 Nginx 的 http_headers 模块（ngx_http_headers_module），该模块在源码编译时默认启用。只要你在 configure 阶段没显式用 --without-http_headers_module 禁用它，就一定支持 expires 指令。

验证方式：安装完成后运行 nginx -V 2>&1 | grep -o with-http_headers_module，若输出该字符串，说明已内置。

源码安装后直接配 location + expires

在你的站点 server 块中，用精准 location 匹配静态资源，然后写 expires：

1. 匹配常见静态后缀（推荐）：

   location ~* .(js|css|png|jpg|jpeg|gif|woff2|ttf|eot|svg)$ {

   expires 1y;

   add_header Cache-Control "public, immutable";

   }

2. 匹配静态目录（更高效，适合 /static/ /assets/ 等）：

   location ^~ /static/ {

   expires 30d;

   add_header Cache-Control "public, max-age=2592000";

   }

3. 禁止缓存 HTML（必须区分）：

   location ~* .html$ {

   expires epoch;

   add_header Cache-Control "no-cache, must-revalidate, max-age=0";

   }

关键注意事项

1. 不能放在 http 或 server 顶层：expires 必须置于 location 块内，否则会报错或不生效
2. 避免误缓存动态内容：切勿用 location / { expires 1d; } 这类宽泛规则，否则 HTML、API 接口可能被错误缓存
3. add_header 要合并写：同一 location 中多次 add_header 会覆盖前一条，Cache-Control 应写成完整值，如 "public, immutable" 而非分两次加
4. 哈希文件才敢用 expires max 或 1y：若 JS/CSS 文件名不变（如 app.js），内容更新后用户将无法获取新版本

验证是否生效

改完配置后执行三步：

1. nginx -t 检查语法
2. nginx -s reload 重载配置
3. 用 curl -I https://yoursite/style.css 查看响应头，确认同时存在：

   Expires: Wed, 31 Dec 2037 23:55:55 GMT

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