proxy_cache_bypass和proxy_no_cache可结合header动态控制缓存：前者使请求绕过缓存直连后端，后者禁止缓存响应；二者常配合使用，如proxy_cache_bypass $http_x_refresh; proxy_no_cache $http_x_refresh;。

可以通过 Nginx 的 proxy_cache_bypass 和 proxy_no_cache 指令，结合请求头（Header）的值动态控制缓存行为，实现“根据 Header 变化更新或跳过缓存”的效果。核心不是“更新已有缓存”，而是让带特定 Header 的请求绕过缓存，直接回源；同时可配合缓存键（proxy_cache_key）把 Header 值纳入缓存标识，使不同 Header 值对应不同缓存副本。

用 Header 控制是否跳过缓存

当客户端携带特定 Header（如 X-Refresh: 1 或 Cache-Control: no-cache）时，让请求不读缓存、直接转发给后端：

• 使用 proxy_cache_bypass：满足条件时，Nginx 不查找缓存，直接代理请求（但仍可能缓存响应）
• 使用 proxy_no_cache：满足条件时，不仅不读缓存，还禁止将响应写入缓存

示例配置：

proxy_cache_bypass $http_x_refresh;  # X-Refresh 非空即绕过缓存<br>proxy_no_cache $http_x_refresh;      # 同时禁止缓存该响应

把 Header 值加入缓存键，实现“多版本缓存”

若希望 User-Agent、Accept-Language 或自定义 Header（如 X-Region: cn）影响缓存内容，需将其纳入 proxy_cache_key：

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

• 默认缓存键通常只含 scheme + host + uri，相同 URL 总是命中同一缓存
• 添加 Header 后，X-Region: cn 和 X-Region: us 就会分别缓存不同响应

示例：

proxy_cache_key "$scheme$request_method$host$request_uri$http_x_region";

⚠️ 注意：增加维度会降低缓存命中率，需权衡业务需求与缓存效率。

配合后端响应头实现智能缓存策略

Nginx 支持根据后端返回的响应 Header（如 Cache-Control、Vary）自动调整缓存行为：

• proxy_ignore_headers Cache-Control; 可忽略后端指令，强制按 Nginx 规则缓存
• proxy_cache_valid 200 302 10m; 设置状态码对应的默认缓存时间
• 若后端返回 Vary: X-Region，Nginx 会自动将该 Header 值纳入缓存键（需开启 proxy_cache_vary on;）

验证与调试技巧

快速确认 Header 是否生效、缓存是否命中：

• 在响应头中添加 X-Cache-Status：用 add_header X-Cache-Status $upstream_cache_status;
• 查看日志：在 log_format 中加入 $upstream_cache_status 和 $http_x_region 等变量
• 用 curl 测试：curl -H "X-Region: cn" http://example.com/api 对比不同值的响应头和缓存状态