Nginx防止cookie丢失的配置＜nginx proxy_pass＞＜proxy_cookie_domain＞

浅浅的花香味﹌ 2022-11-13 00:48 818阅读 0赞

**网上发现这篇文章，这里转载给发家分享一下。**

原文:[https://www.cnblogs.com/kevingrace/p/5707750.html][https_www.cnblogs.com_kevingrace_p_5707750.html]

# **一、proxy\_cookie\_path**  #

参数的作用是用来改变cookie的路径  
语法： proxy\_cookie\_path path replacement;  
path就是你要替换的路径 replacement 就是要替换的值

**为什么cookie 会丢失？**  
比如说一个没有经过代理的地址 ： http://127.0.0.1/project       cookie\_path：/project  
如果按照第二种方式代理那么地址就是 ： http://127.0.0.1/proxy\_path       cookie\_path: /proxy\_path  
如果cookie\_path与地址栏上的path不相符游览器就不会接受这个cookie，自然session就失效了。

**解决nginx proxy\_pass反向代理cookie,session丢失的问题**

下面是可能的三种情况  
**1）host、端口转换，cookie不会丢失**

<table> 
 <tbody> 
  <tr> 
   <td> <p><code>location&nbsp;</code><code>/project</code>&nbsp;<code>{ </code></p> <p><code>&nbsp; &nbsp;&nbsp;</code><code>proxy_pass&nbsp;&nbsp; http:</code><code>//127</code><code>.0.0.1:8080</code><code>/project</code><code>;</code></p> <p><code>}</code></p> </td> 
  </tr> 
 </tbody> 
</table>

通过浏览器访问http://127.0.0.1/project时，浏览器的cookie内有jsessionid。再次访问时，浏览器会发送当前的cookie。

**2）如果路径也变化了，则需要设置cookie的路径转换，nginx.conf的配置如下**

<table> 
 <tbody> 
  <tr> 
   <td> <p><code>location&nbsp;</code><code>/proxy_path</code>&nbsp;<code>{ </code></p> <p><code>&nbsp;&nbsp;&nbsp;</code><code>proxy_pass&nbsp;&nbsp; http:</code><code>//127</code><code>.0.0.1:8080</code><code>/project</code><code>;</code></p> <p><code>}</code></p> </td> 
  </tr> 
 </tbody> 
</table>

通过浏览器访问http://127.0.0.1/proxy\_path时，浏览器的cookie内没有jsessionid。再次访问时，后台当然无法获取到cookie了。  
加上路径转换：proxy\_cookie\_path  /project /proxy\_path;则可以将project的cookie输出到proxy\_path上。  
保证cookie不丢失的正确配置是:

<table> 
 <tbody> 
  <tr> 
   <td> <p><code>location&nbsp;</code><code>/proxy_path</code>&nbsp;<code>{ </code></p> <p><code>&nbsp;&nbsp;</code><code>proxy_pass&nbsp;&nbsp; http:</code><code>//127</code><code>.0.0.1:8080</code><code>/project</code><code>;</code></p> <p><code>&nbsp;&nbsp;</code><code>proxy_cookie_path&nbsp;&nbsp;</code><code>/project</code>&nbsp;<code>/proxy_path</code><code>;</code></p> <p><code>}</code></p> </td> 
  </tr> 
 </tbody> 
</table>

**3）直接代理本地端口**

<table> 
 <tbody> 
  <tr> 
   <td> <p><code>location&nbsp;</code><code>/proxy_path</code>&nbsp;<code>{ </code></p> <p><code>&nbsp;&nbsp;</code><code>proxy_pass&nbsp;&nbsp; http:</code><code>//127</code><code>.0.0.1:8080/;</code></p> <p><code>&nbsp;&nbsp;</code><code>proxy_cookie_path&nbsp;&nbsp;</code><code>/project</code>&nbsp;<code>/proxy_path</code><code>;&nbsp;</code><code># project 为你的项目名 也可用变量代替</code></p> <p><code>}</code></p> </td> 
  </tr> 
 </tbody> 
</table>

# **二、proxy\_cookie\_domain ** #

参数的作用是转换response的set-cookie header中的domain选项，由后端设置的域名domain转换成你的域名replacement，来保证cookie的顺利传递并写入到当前页面中，注意**proxy\_cookie\_domain负责的只是处理response set-cookie头中的domain属性，仅此而已！**

在了解了这个参数后，发现不配置这个属性，依然运转正常！

response在写set-cookie的时候，domain是一个可选项，并不是必填项，所以经常能看到如下这种情况：

![5d10f854508d70b6778852866584d88a.png][]

这个时候由于set-cookie本身就没有domain内容，proxy\_cookie\_domain也就不没有必要了，这也是为什么在部分项目中不配置proxy\_cookie\_domain依然正常的原因。但是对于一些设置了domain的项目，比如：

![efe92d13d71781ebe5c7b533ae89756f.png][]

这种情况下当你用nginx做反向代理的时候，就必须要转换一下了。

# **三、Nginx反向代理理解误区之proxy\_cookie\_domain** #

**之前错误地理解**：**proxy\_cookie\_domain的作用是实现前后端cookie域名转换，保证顺利传递！**比如说Nginx做反向代理的时候，一般都习惯添加proxy\_cookie\_domain配置，来做cookie的域名转换。比如:

<table> 
 <tbody> 
  <tr> 
   <td> <p><code>...</code></p> <p><code>location&nbsp;</code><code>/api</code>&nbsp;<code>{ </code></p> <p><code>&nbsp;&nbsp;&nbsp;</code><code>proxy_pass https:</code><code>//b</code><code>.</code><code>test</code><code>.com;</code></p> <p><code>&nbsp;&nbsp;&nbsp;</code><code>proxy_cookie_domain b.</code><code>test</code><code>.com&nbsp; a.</code><code>test</code><code>.com;</code></p> <p><code>}&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code></p> <p><code>...</code></p> </td> 
  </tr> 
 </tbody> 
</table>

后面发现，不配置这个属性，依然运转正常！这就是对proxy\_cookie\_domain错误理解导致地！！乍一看好像也没错，但是现在想想，理解还是不够啊，因为proxy\_cookie\_domain的作用是单向的，并不是双向转换的。我们先看下cookie的传递过程：

![369307b0e5df6c2eb55799201100486e.png][]

浏览器在发送请求的时候，会在request header中带上cookie项(有内容的话)，此时的cookie是一个字符串，一个key=value并用分号分割的字符串，

![0c611e0394a0791b65f266ad47775280.png][]

其中**并不包含任何域名信息**。这是因为浏览器在设置cookie选项的时候，所选取的内容都是缓存中接口域名下的。然后request的只要请求发送出去之后，cookie中有关domain信息其实是不存在的，它只是一个普通的字符串，随便proxy\_pass到任何位置，都会正常携带下去。因此**在前端到后端的request的过程中，proxy\_cookie\_domain是没用的！！**

而server端在做响应的时候，通过set-cookie的domain属性，可以控制cookie的生效域名目标，做到诸如二级域名cookie分离等等，如果前端接收到的set-cookie的domain和当前域名不一致，或者一级域名不一致(二级域名可以共享一级域名下的cookie)，这个cookie在后续的通信中就是无效的，所以这里才需要去做domain的转换，也就是说**response中set-cookie的domain转换才是有意义的，这也正是proxy\_cookie\_domain的作用所在**。

当response的set-cookie中domain不去设置时，cookie顺利传入浏览器中，浏览器会自动设置这个cookie的生效域名为当前域名。

和这个类似的还有**proxy\_cookie\_path属性，同样的该属性仅作用在修改response set-cookie的path属性**，而一般情况下，用的也比较少。

下面是Nginx里关于proxy\_cookie\_domain的一个配置：

<table> 
 <tbody> 
  <tr> 
   <td> <p><code>页面地址是a.com，但是要用b.com的cookie需要</code></p> <p>&nbsp;</p> <p><code>proxy_set_header Cookie $http_cookie;</code></p> <p><code>location / { </code></p> <p><code>&nbsp; &nbsp;proxy_cookie_domain b.com a.com;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code><code>#注意别写错位置了 proxy_cookie_path / /;</code></p> <p><code>&nbsp; &nbsp;proxy_pass http:</code><code>//b</code><code>.com;</code></p> <p><code>}</code></p> </td> 
  </tr> 
 </tbody> 
</table>

\*\*\*\*\*\*\*\*\*\*\*\*\*\*\* 当你发现自己的才华撑不起野心时，就请安静下来学习吧！\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*

[https_www.cnblogs.com_kevingrace_p_5707750.html]: https://www.cnblogs.com/kevingrace/p/5707750.html
[5d10f854508d70b6778852866584d88a.png]: /images/20221022/81aad5460dd94114a6f731f31e4e413e.png
[efe92d13d71781ebe5c7b533ae89756f.png]: /images/20221022/06100f7b1e554be285c22b9706ddabc9.png
[369307b0e5df6c2eb55799201100486e.png]: /images/20221022/670803442a8c461c85d2bba9bf4cd84b.png
[0c611e0394a0791b65f266ad47775280.png]: /images/20221022/50dbb64f53bf4edab230a01ca4db7144.png