Nginx 中 proxy_cookie_domain 指令实战：解决跨子域反向代理时 Cookie 被丢弃-Nginx-PHP中文网

必须用proxy_cookie_domain当后端Cookie Domain与前端域名不匹配且属同一主域子域关系时；其作用是将后端Set-Cookie中的Domain属性重写为合法值（如.proxy_cookie_domain 192.168.1.20 .example.com），确保浏览器正确存储和发送Cookie。

nginx 中 proxy_cookie_domain 指令实战：解决跨子域反向代理时 cookie 被丢弃

当用 Nginx 做反向代理，把 https://admin.example.com 的请求转发到后端 http://192.168.1.20:3000，而该后端返回的 Set-Cookie 中带了 Domain=192.168.1.20，浏览器会直接忽略这个 Cookie——因为它和当前页面域名完全不匹配。真正起作用的不是“有没有设置 Cookie”，而是“浏览器愿不愿意存、敢不敢发”。proxy_cookie_domain 就是专门用来修正这个关键属性的指令。

什么时候必须用 proxy_cookie_domain

核心判断标准：前后端域名不同，但属于同一主域下的子域关系（比如 a.example.com 和 api.example.com），且后端写入的 Cookie Domain 不符合前端访问域名规则。

后端响应头中出现 Set-Cookie: session=abc; Domain=api.example.com;，而用户访问的是 www.example.com → 浏览器拒绝存储
后端没设 Domain，只写了 Set-Cookie: session=abc; → 默认 Domain 是响应头 Host 值（如 api.example.com），仍无法被 www.example.com 共享
后端设了 Domain=.example.com（带前导点），这是正确做法；但如果后端受限无法修改，就得靠 Nginx 补救

基础写法：静态替换最常用

假设用户访问 https://shop.example.com，Nginx 把请求代理到 http://10.0.1.5:8000，而后端返回的 Cookie 带 Domain=10.0.1.5 或 Domain=backend.local，你需要把它统一改成可被 shop.example.com 及其同主域站点识别的值：

location /api/ {
    proxy_pass http://10.0.1.5:8000;
    proxy_set_header Host $host;
    proxy_cookie_domain 10.0.1.5 .example.com;
    proxy_cookie_domain backend.local .example.com;
}

注意：.example.com 开头的点号不能省略，它表示“允许所有子域”；若写成 example.com（无点），浏览器只认精确匹配，shop.example.com 就无法读取该 Cookie。

进阶写法：正则匹配应对动态或模糊域名

有些后端服务自动写入类似 Domain=.backend.example.com 或 Domain=backend.example.com，而你希望统一收口到 .example.com。这时静态替换会失效，因为 proxy_cookie_domain .backend.example.com .example.com 无法匹配 backend.example.com（少一个点）。

解决方案是启用正则语法：

WebChat Voice Proxy

⚠️ 已弃用 — 该技能已拆分为两个独立技能，以提升模块化程度：**webchat-https-proxy**（HTTPS/WSS 反向代理）和 **webchat-voi...**

下载

location /api/ {
    proxy_pass http://10.0.1.5:8000;
    proxy_set_header Host $host;
    proxy_cookie_domain ~\.?backend\.example\.com .example.com;
}

其中 ~\.?backend\.example\.com 表示：匹配 backend.example.com 或 .backend.example.com，\.? 中的问号代表“前面的点可有可无”。这是处理老旧系统或容器化部署中域名不规范时的实用技巧。

配合 proxy_cookie_path 防止路径错位

Cookie 的 Path 属性同样影响可用性。例如后端返回 Path=/v1/，但前端请求路径是 /api/v1/users，而 Nginx location 是 /api/，那么浏览器可能因路径不匹配而不发送 Cookie。

此时要同步调整路径：

location /api/ {
    proxy_pass http://10.0.1.5:8000/v1/;
    proxy_set_header Host $host;
    proxy_cookie_domain ~\.?backend\.example\.com .example.com;
    proxy_cookie_path /v1/ /api/;
}

proxy_cookie_path /v1/ /api/ 的意思是：把后端 Set-Cookie 中的 Path=/v1/ 替换为 Path=/api/，确保浏览器在访问 /api/xxx 时能命中并携带该 Cookie。