Nginx 不支持 proxy_cache_cookie 指令，因其缓存键默认不包含 Cookie 以避免用户数据泄露；可通过 map 提取 Cookie 值并配合 proxy_cache_key 自定义缓存键实现按 Cookie 区分缓存，或直接透传 Cookie 给上游。
macOS 下 Nginx 本身不支持直接缓存或透传 Cookie 的代理行为，因为官方 Nginx（包括开源版和 macOS 上通过 Homebrew 安装的版本）没有 proxy_cache_cookie 这个指令 —— 它并不存在于标准 Nginx 配置语法中。
为什么没有 proxy_cache_cookie？
Nginx 的缓存机制（proxy_cache）默认基于请求的 URI、HTTP 方法、以及部分请求头（如 Host、Accept-Encoding 等）生成缓存键（cache key），但不会自动包含 Cookie 内容。这是出于设计考虑：Cookie 通常携带用户身份信息，缓存带 Cookie 的响应极易导致用户数据泄露或内容错乱（比如把用户 A 的页面缓存后返回给用户 B）。
所以 Nginx 故意不提供“缓存 Cookie”或“按 Cookie 分缓存”的开箱即用指令，避免误用。
想实现“按 Cookie 区分缓存”，该怎么做？
虽然没有 proxy_cache_cookie，但你可以通过组合已有指令，实现类似效果：让缓存键包含特定 Cookie 值（例如 session_id 或 user_type），从而为不同用户/状态生成独立缓存。
-
使用
proxy_cache_key自定义缓存键：在location块中显式构造包含 Cookie 的 key -
用
map提取并标准化 Cookie 值：避免空值、非法字符影响缓存逻辑 -
注意缓存粒度与安全性：仅对无敏感信息、可安全共享的 Cookie（如语言偏好
lang=zh）启用；禁止对auth_token、sid等做缓存
示例配置片段：
# 在 http 块顶部定义 map（提取 Cookie 中的 lang 值）
map $http_cookie $cookie_lang {
~*lang=([^;]+) $1;
default "en";
}
<h1>定义缓存区</h1><p>proxy_cache_path /usr/local/var/nginx/cache levels=1:2 keys_zone=my_cache:10m max_size=1g;</p><p>server {
location /api/ {
proxy_pass <a href="https://www.php.cn/link/0e2f55a256a7218367349b9e87657252">https://www.php.cn/link/0e2f55a256a7218367349b9e87657252</a>;
proxy_cache my_cache;</p><h1>关键：将 cookie_lang 加入缓存键</h1><pre class='brush:php;toolbar:false;'> proxy_cache_key "$scheme$request_method$host$request_uri$cookie_lang";
proxy_cache_valid 200 5m;
}}
代理时如何透传 Cookie（不缓存，只转发）？
如果你只是希望上游服务能收到客户端 Cookie（常见于反向代理登录态系统），无需缓存干预，只需确保：
-
proxy_pass正常工作（默认会透传Cookie请求头） - 不要意外清除它，比如没配
proxy_set_header Cookie $http_cookie;却又用了proxy_set_header覆盖了所有头 - 如需修改或添加 Cookie，用
proxy_cookie_path或proxy_cookie_domain，或搭配add_header Set-Cookie ...（注意：Nginx 不能修改上游 Set-Cookie 值，只能追加或覆盖）
替代方案建议
若业务强依赖“按用户态缓存”，标准 Nginx 可能不是最优选：
- 前端控制：由 JS 判断用户状态，决定是否走 CDN 或本地缓存，绕过服务端缓存
- 应用层缓存：在 Node.js / Python 后端中根据 Cookie 计算缓存 key，用 Redis 管理，更灵活也更安全
-
商业版 Nginx Plus：支持
keyval模块和高级缓存策略，但 macOS 通常不用于生产部署这类服务
