如何配置 Nginx 针对不同终端操作系统（iOS/Android）下发差异化的 Vary 头部-Nginx-PHP中文网

应在Nginx中用map归一化User-Agent为$os_type，再通过proxy_cache_key包含该变量并添加Vary "X-OS-Type"响应头，确保CDN按操作系统类型正确分离缓存。

如何配置 nginx 针对不同终端操作系统（ios/android）下发差异化的 vary 头部

直接在 add_header Vary 里写 User-Agent 是错的——它会让 CDN 缓存爆炸式碎片化，且多数 CDN 对长 UA 的 Vary 支持不可靠。

用 `map` 把 UA 归类为稳定枚举值

原始 $http_user_agent 太杂、太长、太易变，不能直接进缓存键或响应头。必须先做归一化处理，在 http 块中定义：

map $http_user_agent $os_type {
    default       other;
    ~*[Ii]phone    ios;
    ~*iPad.*OS    ios;
    ~*iOS         ios;
    ~*[Aa]ndroid   android;
}

注意点：

正则必须加 ~* 表示忽略大小写匹配
default other 不可省略，否则未匹配 UA 会导致变量为空，后续缓存键出错
顺序重要：更具体的规则（如 iPhone）放前面，避免被宽泛规则（如 Android）误覆盖
不推荐用 iPhone.*OS 这类跨词匹配，部分 UA 中间有空格或版本号，容易漏判

只在内容真有差异时才加 `Vary: X-OS-Type`

Vary 不是“设备识别开关”，而是“缓存隔离契约”：你承诺了不同 X-OS-Type 值返回的内容确实不同，否则就是误导缓存系统。

Nginx Reverse Proxy

配置 Nginx 反向代理，实现域名绑定。用户说“绑定域名”“配置 Nginx”“反向代理”时触发，将域名绑定到指定 IP:端口。

下载

HTML 模板渲染了 WebKit-only 样式或 iOS 17 特性字段 → 必须加 add_header Vary "X-OS-Type"
API 接口对 Android 返回额外的 android_intent 字段 → 同样要加
静态 JS/CSS/图片未做任何 OS 分支逻辑 → 绝对不要加，否则缓存命中率断崖下跌
响应头名用 X-OS-Type 而非 User-Agent：语义清晰，且绕过某些 CDN 对原始 UA 的解析 bug

同步更新 `proxy_cache_key` 和响应头

只加 Vary 头但不改缓存键，等于白干——Nginx 仍会把 iOS 和 Android 请求塞进同一个缓存条目。

在对应 location 块中显式配置：proxy_cache_key "$scheme$request_method$host$request_uri$os_type"
同时输出标识头：add_header X-OS-Type $os_type（便于调试和 CDN 透传）
若还区分设备类型（mobile/tablet），可组合：proxy_cache_key "$scheme$request_method$host$request_uri$os_type$device_type"，并设 Vary "X-OS-Type, X-Device-Type"
确认 CDN 控制台已开启 Vary 解析（Cloudflare 默认开；腾讯云需单独勾选“支持 Vary 头”）