Nginx 实现全站动静分离与代理缓存的关键是：静态资源由 location 直接文件服务（不走 proxy_pass 和 proxy_cache），动态接口通过 location + proxy_pass + proxy_cache 缓存响应；需前置定义 cache 区、合理配置匹配顺序、规避 Cookie/HTML 误缓存，并对静态资源启用 expires、sendfile 等原生优化。
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 交由浏览器缓存
静态资源仍需独立优化
既然不走 proxy_cache，就要靠 Nginx 原生能力提速：
- 用 expires 1y; 或 add_header Cache-Control "public, immutable"; 实现强缓存
- 开启 sendfile、tcp_nopush、gzip_static 提升传输效率
- 确保 root/alias 路径正确，避免 404 导致 fallback 到动态代理
