Nginx模块之SessionSticky

深碍√TFBOYSˉ_ 2023-10-18 00:45 11阅读 0赞

**0** **工作原理**

![SouthEast][]

Session Sticky 模块在upstream 返回响应后，向客户的浏览器写入 Cookie ，默认名为route ，保存的内容是一个 md5 码。

之后，模块接收到客户浏览器的请求时，就根据 route 来决定将请求转发到 upstream中哪台服务器上。

这是源码包中附带的流程图，将模块的处理流程描述的非常清晰：

![SouthEast 1][]

--------------------

**1** **下载** **Session Sticky**

wget https://nginx-sticky-module.googlecode.com/files/nginx-sticky-module-1.1.tar.gz

--------------------

**2** **安装模块**

如果 Nginx 之前已经安装了，可以通过 nginx -V 命令查看当时编译的参数。在参数后面追加安装 Session Sticky 模块的参数，

避免影响之前 Nginx 已有模块。

进入 nginx 源码目录，执行命令：

./configure … --add-module=/usr/local/src/nginx-sticky-module-1.1

make

make install

--------------------

**3** **激活模块**

在 upstream块中添加 sticky; 即可激活Session Sticky模块。

upstream \{

sticky;

server 127.0.0.1:9000;

server 127.0.0.1:9001;

server 127.0.0.1:9002;

--------------------

**4** **可用选项**

The "sticky" command can take several arguments to control its behaviour:

sticky \[name=route\] \[domain=.foo.bar\] \[path=/\] \[expires=1h\] \[hash=index|md5|sha1\] \[no\_fallback\];

<table> 
 <tbody> 
 <tr> 
 <td style="vertical-align:middle;"> Configuration </td> 
 <td style="vertical-align:middle;"> Description </td> 
 <td style="vertical-align:middle;"> Parameters </td> 
 <td style="vertical-align:middle;"> Default Value </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:middle;"> name </td> 
 <td style="vertical-align:middle;"> the name of the cookie used to track the persistant upstream srv </td> 
 <td style="vertical-align:middle;"> can be any string </td> 
 <td style="vertical-align:middle;"> "route" </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:middle;"> domain </td> 
 <td style="vertical-align:middle;"> the domain in which the cookie will be valid </td> 
 <td style="vertical-align:middle;"> can be any string </td> 
 <td style="vertical-align:middle;"> nothing. Let the browser handle this. </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:middle;"> path </td> 
 <td style="vertical-align:middle;"> the path in which the cookie will&nbsp; &nbsp;&nbsp; &nbsp;be valid </td> 
 <td style="vertical-align:middle;"> can be any path </td> 
 <td style="vertical-align:middle;"> nothing. Let the browser handle this. </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:middle;"> expires </td> 
 <td style="vertical-align:middle;"> the validity duration of the cookie </td> 
 <td style="vertical-align:middle;"> must be a duration greater than one second </td> 
 <td style="vertical-align:middle;"> nothing. It's a session cookie </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:middle;"> hash </td> 
 <td style="vertical-align:middle;"> the hash mechanism to encode upstream server. It cant' be used&nbsp; &nbsp;&nbsp; &nbsp;with hmac </td> 
 <td style="vertical-align:middle;"> md5|sha1 </td> 
 <td style="vertical-align:middle;"> md5 </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:middle;"> hmac </td> 
 <td style="vertical-align:middle;"> The HMAC hash mechanism to encode upstream server. It's like&nbsp; &nbsp;&nbsp; &nbsp;the hash mechanism but it uses hmac_key to secure the hashing.&nbsp; &nbsp;&nbsp; &nbsp;It can't be used with hash. </td> 
 <td style="vertical-align:middle;"> md5|sha1 </td> 
 <td style="vertical-align:middle;"> none </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:middle;"> hmac_key </td> 
 <td style="vertical-align:middle;"> The key to use with hmac. It's mandatory when hmac is set. </td> 
 <td style="vertical-align:middle;"> can be any string </td> 
 <td style="vertical-align:middle;"> none </td> 
 </tr> 
 <tr> 
 <td style="vertical-align:middle;"> no_fallback </td> 
 <td style="vertical-align:middle;"> When this flag is set, nginx will return a 502 (Bad Gateway orProxy Error) if a request comes&nbsp; &nbsp;&nbsp; &nbsp;with a cookie and the corresponding backend is unavailable. </td> 
 <td style="vertical-align:middle;"> no arguments </td> 
 <td style="vertical-align:middle;"> none </td> 
 </tr> 
 </tbody> 
</table>

来源:[https://blog.csdn.net/dc\_726/article/details/12348907][https_blog.csdn.net_dc_726_article_details_12348907]

[SouthEast]: https://img-blog.csdn.net/20131006155350171?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvZGNfNzI2/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast
[SouthEast 1]: https://img-blog.csdn.net/20131006160117093?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvZGNfNzI2/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast
[https_blog.csdn.net_dc_726_article_details_12348907]: https://blog.csdn.net/dc_726/article/details/12348907