Linux怎么配置Nginx针对特定文件开启缓存-LINUX-PHP中文网

nginx对.js/.css/.png等静态文件启用浏览器缓存应使用expires和add_header cache-control，而非proxy_cache；前者通过响应头控制客户端缓存，后者为服务端磁盘缓存，二者职责不同、不可混用。

linux怎么配置nginx针对特定文件开启缓存

这不是 proxy_cache 的事，而是用 expires 和 add_header Cache-Control 控制浏览器行为。Nginx 不会把这些文件存到磁盘，只是告诉浏览器“你本地留着用就行”。

在 location 块里用正则匹配后缀：location ~* \.(js|css|png|jpg|gif|ico|woff2|svg)$
加 expires 1y;：生成 Cache-Control: max-age=31536000 和 Expires 头
强烈建议加 add_header Cache-Control "public, immutable";：避免带查询参数（如 app.js?v=2）被当成新资源重新请求
别在 location / 或 location ~ \.php$ 里套这个——HTML 和动态接口不该缓存那么久
注意优先级：如果后端 PHP/Node 返回了 Cache-Control: no-cache，Nginx 的 expires 会被覆盖，此时需加 proxy_ignore_headers Cache-Control;（仅限反向代理场景）

用路径前缀比后缀更可靠，尤其当文件没扩展名或 CDN 重写 URL 时。

location ^~ /static/ { expires 30d; add_header Cache-Control "public, immutable"; }
^~ 表示前缀匹配且优先级高于正则，避免被其他 location ~ \.php 规则劫持
确保 /static/ 路径真实存在且由 Nginx 直接提供（非 proxy_pass），否则 expires 不生效
如果 /static/ 实际指向后端服务（比如 Python static view），那得改用 proxy_cache，而不是 expires

这是服务端缓存，把响应体写进磁盘，和浏览器无关。想让它生效，必须同时满足路径匹配 + 状态码允许 + 缓存键唯一。

在无 root/sudo 权限的环境（云容器、VPS、隔离主机）中安装并配置 OpenClaw 浏览器工具的 headless Chrome。适用场景：...

下载

先定义缓存区：proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=assets_cache:10m max_size=500m inactive=1h;
在对应 location 里启用：location /api/v1/assets { proxy_pass http://backend; proxy_cache assets_cache; }
显式指定状态码缓存规则：proxy_cache_valid 200 206 301 302 1h;（漏掉 206 会导致视频分片缓存失败）
务必包含查询参数：proxy_cache_key "$scheme$request_method$host$request_uri$is_args$args";，否则 /api/v1/assets?id=123 和 ?id=456 会共用一个缓存项
检查权限：/var/cache/nginx 目录属主必须是 Nginx worker 用户（通常是 www-data 或 nginx），否则 X-Cache-Status 永远是 MISS

90% 的“配置写了但没用”问题都卡在这几个点上，别急着改配置，先看日志和响应头。

用 curl -I http://yoursite/static/logo.png 看有没有 Cache-Control 或 Expires ——没有就是 location 没匹配上
用 curl -I http://yoursite/api/v1/assets 看 X-Cache-Status 值：是 MISS 就说明没进缓存区，重点查 proxy_cache_path 权限和 proxy_cache_valid 是否覆盖了实际返回的状态码
查 Nginx error log：tail -f /var/log/nginx/error.log，常见报错如 open() "/var/cache/nginx/..." failed (13: Permission denied)
确认后端是否返回了 Set-Cookie 或 Authorization 头——默认情况下 Nginx 会跳过缓存，需加 proxy_ignore_headers Set-Cookie; 才行