Nginx proxy_cache 正确工作的关键是精准控制 proxy_cache_key：需按域名（$host）、终端类型（$mobile_flag）、关键业务参数（$cache_lang、$cache_theme）、请求方法及认证信息（$request_method、$http_authorization、$cookie_session_id）等维度构造唯一缓存键，避免混用。
要让 Nginx 的 proxy_cache 真正按业务意图工作，关键不是“加缓存”，而是“控住缓存键”——proxy_cache_key 决定了什么请求算“同一个内容”。默认的 $scheme$proxy_host$request_uri 太粗放，容易把本该隔离的请求混在一起，比如 PC 和手机看到同一份 HTML、A 用户登录态被缓存后返回给 B 用户、带 utm 的营销页污染了主站缓存。
按域名隔离：避免多站点缓存互相污染
多个域名共用一个缓存区时，/about 在 example.com 和 test.com 下本应是两份内容。只靠 proxy_cache_path 分开还不够，必须在 key 里显式带上 $host：
- 在
http块中定义独立缓存区：proxy_cache_path /var/cache/nginx/site_a ... keys_zone=site_a:10m;proxy_cache_path /var/cache/nginx/site_b ... keys_zone=site_b:10m; - 在对应
server块中绑定并构造 key：proxy_cache site_a;proxy_cache_key "$host$request_uri$is_args$args";
这样 example.com/about 和 test.com/about 的哈希值完全不同，物理上也写入不同目录，彻底断开干扰。
按终端类型区分：PC 与移动端不共用缓存
Next.js 或 SSR 应用常根据 User-Agent 返回不同 HTML。若缓存 key 不含终端标识，手机用户可能拿到 PC 版页面。
- 用
map提前提取设备类型（避免 key 中写复杂正则）：map $http_user_agent $mobile_flag {<br> ~*"(iPhone|Android|Mobile)" "mobile";<br> default "desktop";<br>} - 将
$mobile_flag加入 key：proxy_cache_key "$host$request_uri|$mobile_flag";
注意控制变量长度，$mobile_flag 比完整 $http_user_agent 更安全，也利于命中率。
安装并运行 Aperture（Lightning Labs 的 L402 闪电反向代理），用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。
按关键业务参数过滤：保留有用、剔除干扰
Next.js 的 ?lang=zh 或 ?region=jp 影响服务端渲染结果，必须进 key；而 utm_source=weibo 或 _ga=GA1.2.xxxx 纯属分析用途，必须排除。
- 用
map提取有效参数：map $args $cache_lang {<br> ~(lang=)([^&]+) $2;<br> default "";<br>} - 同样处理 cookie 中的关键字段（如主题、登录态）：
map $http_cookie $cache_theme {<br> ~theme=(dark|light) $1;<br> default "";<br>} - 组合最终 key：
proxy_cache_key "$host$request_uri|$cache_lang|$cache_theme";
不拼全 $args，也不无差别包含所有 cookie，既保精准，又防 key 膨胀导致缓存失效。
按请求方法或认证上下文隔离：防止越权与误覆盖
GET 和 HEAD 请求语义不同；带 Authorization 的接口属于私有资源，绝不能和匿名请求共享缓存。
- 基础增强写法：
proxy_cache_key "$request_method|$host$request_uri"; - 涉及登录态的 API 缓存：
proxy_cache_key "$request_method|$host$request_uri|$http_authorization|$cookie_session_id";
这里 $http_authorization 是 Header 值，$cookie_session_id 是 Cookie 字段，两者任一变化都会生成新 key，保障权限边界清晰。
