Nginx配置客户端保存Cookie指南

在Nginx中配置客户端保存Cookie主要涉及以下几个方面：

1. 基本Cookie设置

在Nginx配置中，可以通过proxy_cookie_path和proxy_cookie_domain指令来管理Cookie：

location / {
    proxy_pass http://backend;

    # 设置Cookie路径
    proxy_cookie_path / /;

    # 设置Cookie域
    proxy_cookie_domain backend.example.com $host;
}

2. 确保Cookie持久化

要让客户端浏览器保存Cookie，需要确保：

1. Cookie有合理的过期时间
2. 设置了正确的Domain和Path
3. 没有设置HttpOnly或Secure标志（除非必要）

3. 通过Nginx添加Cookie

可以使用add_header指令添加Set-Cookie头：

location / {
    add_header Set-Cookie "sessionid=12345; Path=/; Max-Age=3600";
    proxy_pass http://backend;
}

4. 修改后端返回的Cookie

如果需要修改后端返回的Cookie属性：

location / {
    proxy_pass http://backend;

    # 修改Cookie的Secure和HttpOnly标志
    proxy_cookie_flags ~ secure samesite=strict;

    # 修改Cookie过期时间
    proxy_cookie_path ~ "^(.*)(; Max-Age=)[0-9]+(.*)$" "$1; Max-Age=86400$3";
}

5. 处理跨域Cookie

对于跨域请求，需要额外配置：

location / {
    add_header 'Access-Control-Allow-Origin' 'http://client.example.com';
    add_header 'Access-Control-Allow-Credentials' 'true';
    add_header 'Access-Control-Allow-Headers' 'Content-Type';
    add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS';

    proxy_pass http://backend;
    proxy_cookie_domain ~^(.*)$ $1; # 保留原始domain
}

6. 常见问题解决

问题1：Cookie不保存 - 检查Domain和Path设置是否正确 - 确保没有设置HttpOnly或Secure标志（除非必要） - 检查浏览器是否禁用了Cookie

问题2：跨域Cookie失效 - 确保Access-Control-Allow-Credentials设置为true - 确保Access-Control-Allow-Origin不是通配符(*)，而是具体域名 - 前端请求需要设置withCredentials=true

7. 完整示例配置

server {
    listen 80;
    server_name example.com;

    location / {
        proxy_pass http://backend;

        # Cookie相关配置
        proxy_cookie_path / /;
        proxy_cookie_domain ~^(.+)$ $1;
        proxy_cookie_flags ~ secure samesite=lax;

        # 跨域支持
        add_header 'Access-Control-Allow-Origin' 'http://client.example.com';
        add_header 'Access-Control-Allow-Credentials' 'true';

        # 其他代理设置
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

通过以上配置，可以确保客户端浏览器正确保存和使用Cookie。