Nginx 中 proxy_cookie_path 的用法
原文地址: Nginx 中 proxy_cookie_path 的用法
欢迎访问我的博客: http://blog.duhbb.com/
昨天调试 nginx 的时候, 转发都配置好了, 结果登录之后又跳到了登录页面, 顿时一脸懵逼;然后在别的地方看了下配置, 拷贝过来之后就可以正常登录的. 而拷贝过来的配置的一个关键的指令就是 proxy_cookie_path
, 这不禁引起了我的好奇, 遂撰此文记录, 避免下次踩坑.
下面的这个介绍部分参考了这个博客: https://cloud.tencent.com/developer/article/1858199
proxy_cookie_path 语法
proxy_cookie_path source target;
- source 源路径
- target 目标路径
使用原因
cookie 的 path 与地址栏上的 path 不一致, 浏览器就不会接受这个 cookie, 无法传入 JSESSIONID 的 cookie, 导致登录验证失败.
使用场景
当 nginx 配置的反向代理的路径和源地址路径不一致时使用.
# elastic-job 代理配置
location /etc-job/api/ {
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_pass http://10.55.3.139:8088/api/;
proxy_cookie_path / /etc-job/api/;
proxy_set_header Cookie $http_cookie;
}
感觉说的不是很清楚, 笔者还是看下 nginx 的官方文档吧!
nginx 官方文档
官方介绍的地址如下: http://nginx.org/en/docs/http/ngx_http_proxy_module.html#proxy_cookie_path
语法:
proxy_cookie_path off;
proxy_cookie_path path replacement;
# 二者选其一或者同时存在, 同时存在就是 off 了
默认:
proxy_cookie_path off;
上下文:
http, server, location
这个指令是从 1.1.15
版本开始引入的.
可以设置被代理服务器响应中的 Set-Cookie
这个路径属性. 假被设代理服务器返回的 Set-Cookie
头的 path
字段的属性是 path=/two/some/uri/
.
那么这个指令 proxy_cookie_path /two/ /;
会将这个属性重写为 path=/some/uri/
.
我感觉这个就是一种替换, 将
/two/
替换为/
了
path 和 replacement 可以包含变量: proxy_cookie_path $uri /some$uri;
The directive can also be specified using regular expressions. In this case, path
should either start from the ~
symbol for a case-sensitive matching, or from the ~*
symbols for case-insensitive matching. The regular expression can contain named and positional captures, and replacement can reference them:
proxy_cookie_path ~*^/user/([^/]+) /u/$1;
同一级可以指定多个 proxy_cookie_path
指令:
proxy_cookie_path /one/ /;
proxy_cookie_path / /two/;
如果有多个指令都可以匹配上 cookie 的路径,nginx 会选择第一个匹配的指令.
off
参数会将所有继承的 proxy_cookie_path
都取消掉.
如何查看 Set-Cookie
其实很简单, chrome F12 打开调试, 然后登录之后, 就可以看到接口 set-cookie 的响应了, 如下图
如果这个 path 和浏览器地址栏的不一致, 浏览器会拒绝写入这个 cookie, 相当于登陆了个寂寞.
原文地址: Nginx 中 proxy_cookie_path 的用法
欢迎访问我的博客: http://blog.duhbb.com/