Nginx 中怎么在 URL 中加入哈希指纹实现静态资源永久缓存-Nginx-PHP中文网

nginx实现静态资源永久缓存的关键是服务构建时已带内容哈希的文件，并配置immutable缓存头；需前端工具生成contenthash文件名，nginx按后缀匹配设置expires 1y和cache-control "public, immutable"，html禁用强缓存。

nginx 中怎么在 url 中加入哈希指纹实现静态资源永久缓存

在 Nginx 中实现静态资源“永久缓存”，关键不在 Nginx 本身生成哈希，而在于让 Nginx 正确服务那些**构建时已带内容哈希的文件**，并配合精准缓存头，使浏览器真正信任该 URL、长期不请求验证。URL 哈希必须由前端构建工具（如 Webpack、Vite、Rollup）注入，Nginx 只负责识别、响应和缓存策略落地。

构建阶段生成带哈希的文件名

这是整个机制的前提。不能靠 Nginx 动态加参数（如 ?v=123），也不能手动改名——必须基于文件内容生成唯一哈希，确保内容变则 URL 变。

Webpack：用 [contenthash] 替代 [hash]，例如 main.[contenthash:8].js
Vite：默认启用 build.rollupOptions.output.entryFileNames 和 assetFileNames 的哈希占位符，如 assets/index.[hash].js
输出示例：/static/js/app.e8f3a2d4.js、/static/css/base.b5c7d9e1.css
HTML 中的引用也需同步更新（由构建工具自动完成），例如：<script src="/static/js/app.e8f3a2d4.js"></script>

Nginx 按扩展名匹配并启用 immutable 长期缓存

Nginx 不需要识别具体哈希值，只需通过正则匹配常见静态资源后缀，并统一设置强缓存策略。重点是 immutable —— 它告诉浏览器：“这个 URL 对应的资源，在过期前绝不会变更”，从而跳过 If-None-Match 等协商请求，真正实现零验证加载。

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

配置示例：

location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff2|ttf|webp|eot)$ {
    expires 1y;
    add_header Cache-Control "public, immutable";
}

expires 1y 提供明确的过期时间（等效于 max-age=31536000）
immutable 是现代浏览器支持的关键指令，Chrome 49+、Firefox 49+、Safari 11.1+ 均支持
匹配的是文件后缀，不是路径是否含哈希——只要文件名带哈希且内容不变，该策略就安全有效

避免未哈希路径干扰缓存节奏

如果存在不带哈希的通用路径（如 /static/ 根目录或 /favicon.ico），它们无法享受长期缓存，反而可能因缓存过久导致 HTML 引用失效后降级失败。

对无指纹资源单独限制缓存时长：location /static/ { expires 1m; add_header Cache-Control "no-cache, must-revalidate"; }
入口 HTML 文件必须禁用强缓存：location ~* \.html$ { add_header Cache-Control "no-cache, must-revalidate"; }，确保用户每次访问都能拿到最新引用关系
Next.js 用户可直接匹配 /_next/static/ 路径，它天然带哈希，适合开 1 年 + immutable