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：
- 匹配常见静态后缀（推荐）：
location ~* \.(js|css|png|jpg|jpeg|gif|woff2|ttf|eot|svg)$ {
expires 1y;
add_header Cache-Control "public, immutable";
} - 匹配静态目录（更高效，适合 /static/ /assets/ 等）：
location ^~ /static/ {
expires 30d;
add_header Cache-Control "public, max-age=2592000";
} - 禁止缓存 HTML（必须区分）：
location ~* \.html$ {
expires epoch;
add_header Cache-Control "no-cache, must-revalidate, max-age=0";
}
关键注意事项
- 不能放在 http 或 server 顶层：expires 必须置于 location 块内，否则会报错或不生效
- 避免误缓存动态内容：切勿用 location / { expires 1d; } 这类宽泛规则，否则 HTML、API 接口可能被错误缓存
-
add_header 要合并写：同一 location 中多次 add_header 会覆盖前一条，Cache-Control 应写成完整值，如
"public, immutable"而非分两次加 - 哈希文件才敢用 expires max 或 1y：若 JS/CSS 文件名不变（如 app.js），内容更新后用户将无法获取新版本
验证是否生效
改完配置后执行三步：
-
nginx -t检查语法 -
nginx -s reload重载配置 - 用
curl -I https://yoursite/style.css查看响应头，确认同时存在：
Expires: Wed, 31 Dec 2037 23:55:55 GMT
Cache-Control: public, immutable, max-age=31536000
