Nginx proxy_cache怎么实现全站静动态分离的代理缓存-Nginx-PHP中文网

nginx 实现全站动静分离与代理缓存的关键是：静态资源由 location 直接文件服务（不走 proxy_pass 和 proxy_cache），动态接口通过 location + proxy_pass + proxy_cache 缓存响应；需前置定义 cache 区、合理配置匹配顺序、规避 cookie/html 误缓存，并对静态资源启用 expires、sendfile 等原生优化。

nginx proxy_cache怎么实现全站静动态分离的代理缓存

proxy_cache 本身不负责“静动态分离”，它只做缓存；真正的动静分离靠 location 规则实现，proxy_cache 是在此基础上对动态请求结果做缓存。要实现“全站级”的动静分离 + 代理缓存，关键在于：静态资源走本地文件服务（不进 proxy_cache），动态接口走 proxy_pass + proxy_cache 缓存响应体。

动静分离是前提，cache 是增强

必须先用 location 明确区分两类请求：

静态资源（如 .js、.css、.png、/static/、/assets/）直接由 Nginx 读取磁盘返回，不经过 proxy_pass，自然也不走 proxy_cache
动态路径（如 /api/、/user/、/v1/ 或兜底的 location /）才配置 proxy_pass，并在其内部启用 proxy_cache

为动态请求配置 proxy_cache

需在 http 块中定义缓存区，再在对应 location 中引用：

FastAPI Flask Proxy

FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。

下载

定义缓存存储路径与参数：proxy_cache_path /data/nginx/cache levels=1:2 keys_zone=api_cache:20m max_size=2g inactive=1h use_temp_path=off;
在动态 location 中启用：location ^~ /api/ { proxy_cache api_cache; proxy_cache_valid 200 302 10m; proxy_cache_valid 404 1m; proxy_pass http://backend; ... }
注意：proxy_cache 只缓存后端返回的响应体，不缓存 Nginx 自己生成的 404、50x 等错误页（除非显式配置 proxy_cache_use_stale）

避免动静混淆导致 cache 失效或误缓存

常见陷阱要避开：

不要把静态规则写在动态规则之后——Nginx 按顺序匹配，若 location / 写在最前，所有请求都会被 proxy_pass，静态文件也进了 cache，反而降低性能
不要对带 Cookie 或认证头的请求无差别缓存——加 proxy_cache_bypass $http_cookie $arg_nocache; 和 proxy_no_cache $http_cookie $arg_nocache; 控制绕过缓存
HTML 页面若为 SSR 或含用户态，慎用 proxy_cache；更适合用 expires 或 Cache-Control 交由浏览器缓存