proxy_cookie_path用于修改后端set-cookie头中path值，解决反向代理下因路径不匹配导致的cookie失效问题；支持直接替换、正则重写、清除或添加前缀，并常与proxy_cookie_domain配合使用。

proxy_cookie_path 用于修改后端应用返回的 Set-Cookie 响应头中 path 属性的值，常用于反向代理场景下解决 Cookie 路径不匹配导致的登录态失效问题。

为什么需要 proxy_cookie_path

当 Nginx 作为反向代理，将请求转发给后端服务（如 /app/ → http://backend:8080/）时，后端可能设置 Cookie 的 path 为 / 或 /app/。如果客户端实际访问的是根路径（如 https://example.com/），而 Cookie 的 path 是 /app/，浏览器就不会在后续请求中携带该 Cookie，导致登录态丢失或权限校验失败。

基本语法与常见写法

语法格式为：
proxy_cookie_path path_in_cookie replacement;

它会查找 Set-Cookie 头中 path= 后面的路径，并按规则替换。支持正则和变量，常用形式包括：

aperture: the L402 aware reverse proxy

安装并运行 Aperture（Lightning Labs 的 L402 闪电反向代理），用于创建 L402 付费墙、配置付费 API 端点、为其他代理托管付费内容或测试 L402 认证流程。

下载

• 直接替换：proxy_cookie_path /app/ /;
• 匹配并重写：proxy_cookie_path ~^/app(/.*)?$ $1;
• 清除 path（设为根路径）：proxy_cookie_path / /;
• 添加前缀：proxy_cookie_path / /myapp/;

配合 proxy_cookie_domain 使用更稳妥

仅改 path 可能不够。如果后端设置了 domain（如 domain=backend.local），而客户端访问的是 example.com，Cookie 也会被拒绝发送。此时需同步处理：

• proxy_cookie_domain backend.local example.com;
• proxy_cookie_domain ~\.local$ .example.com;
• 也可用正则清除 domain：proxy_cookie_domain ~.* "";

注意：proxy_cookie_domain 和 proxy_cookie_path 都作用于响应头，需放在 location 块内，且只影响从后端返回的 Set-Cookie。

调试与验证方法

配置生效后，可通过浏览器开发者工具 → Application → Cookies 查看实际存储的 Cookie 路径是否符合预期；或使用 curl 检查响应头：

• curl -I https://example.com/login
• 观察 Set-Cookie 中的 Path= 是否已更新
• 若未生效，确认 location 是否匹配、指令是否拼写正确（如 proxy_cookie_path 不是 proxy_cookie_path）