Linux如何配置Nginx缓存策略_Linux Nginx缓存策略配置实战-LINUX-PHP中文网

nginx缓存分浏览器端（expires/cache-control）和服务端（proxy_cache）两类，不可混用；浏览器缓存需慎配immutable与过期策略，proxy_cache须正确配置路径权限、key、valid规则及差异化映射，清理依赖purge模块或手动删文件。

linux如何配置nginx缓存策略_linux nginx缓存策略配置实战

直接说结论：Nginx缓存分两类，浏览器端用 expires 和 Cache-Control，服务端反向代理缓存必须用 proxy_cache 配合 proxy_cache_path，两者不能混用，也不存在“一个配置通吃”的写法。

这是最常被误用的场景：把 proxy_cache 当成浏览器缓存来用，结果发现 F5 刷新没变化、改了文件用户还是旧版。

expires 只控制浏览器是否发请求，不涉及 Nginx 本地磁盘存储；它生成的是 Expires 和 Cache-Control: max-age=... 响应头
静态资源（.js、.css、.png）建议加 immutable：add_header Cache-Control "public, immutable";，避免浏览器在带查询参数时误判为新资源
别对 .html 或 API 接口路径硬套 expires 1y——这类内容变频繁，缓存后用户看不到更新，且无法通过 URL 版本号自动失效
如果后端已返回 Cache-Control: no-cache，Nginx 的 expires 指令会被覆盖（HTTP 协议规定后端响应头优先级更高）

配置写了、nginx -t 通过、reload 也执行了，但 X-Cache-Status 始终是 MISS，说明根本没进缓存区。

Obsidian (Linux)

操作 Obsidian 库（纯 Markdown 笔记），并通过 notesmd-cli 实现自动化。

下载

proxy_cache_path 路径的父目录（如 /var/cache/nginx）必须由 Nginx worker 进程有读写权限，常见错误是目录属主为 root，而 Nginx 运行用户是 www-data 或 nginx
proxy_cache_valid 只对指定 HTTP 状态码生效，比如写了 proxy_cache_valid 200 10m;，但后端返回了 200 OK 以外的响应（如 304 Not Modified），就不会缓存
默认情况下，Nginx 不缓存带 Set-Cookie 头的响应，也不缓存 Authorization 请求——这是安全机制，如需缓存需显式加 proxy_ignore_headers Set-Cookie; 和 proxy_cache_use_stale error timeout updating http_500;
proxy_cache_key 若没包含 $args，带查询参数的 URL（如 /api/user?id=123）会被当成同一缓存项，导致数据错乱

想让 /static/ 下的图片缓 30 天、/api/v1/ 下的 JSON 缓 5 分钟、/healthz 完全不缓存？单靠 location 匹配做不到精细控制。

先在 http 块定义映射：map $request_uri $cache_ttl { ~^/static/ "30d"; ~^/api/v1/ "5m"; ~^/healthz "0s"; default "1m"; }
再在对应 location 中引用：proxy_cache_valid 200 $cache_ttl;（注意：proxy_cache_valid 支持变量，但仅限于时间值，不能用于开关缓存）
不要试图用 if ($request_uri ~ /healthz) { proxy_cache_bypass true; }——if 在 location 内不可靠，且 proxy_cache_bypass 是布尔判断，不是开关指令
若需彻底禁用某路径缓存，用 proxy_cache off;，而不是删掉 proxy_cache 指令——后者只是不启用，但其他继承配置可能仍生效