【项目实战】NGINX 实现会话保持
在 NGINX 中实现会话保持（Session Persistence），可以通过多种方法完成。先说总结吧。
IP Hash：适合简单场景，但对网络变化敏感。
Cookie：最常用、灵活，适合大部分会话保持需求。
URL 参数：适合特定业务场景，例如 URL 中带有用户标识符。
第三方模块：适用于需要更多控制或特殊功能的场景。
使用 IP 哈希（IP Hash）
IP 哈希是一种简单的负载均衡策略，它基于客户端的 IP 地址将请求分配到同一个后端服务器。该方法适合基本的会话保持场景。
配置示例：
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
|
这种方式比较简单，但如果客户端的 IP 发生变化，会话保持就会失效（例如，移动客户端切换网络）。
基于 Cookie 的会话保持
NGINX 可以通过设置一个特定的 Cookie 来实现会话保持，客户端的请求将基于 Cookie 被路由到同一台后端服务器。
配置示例：
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
|
在这个示例中，`sticky cookie srv_id expires=1h;` 会为客户端设置一个名为 `srv_id` 的 Cookie，并且该 Cookie 的有效期为 1 小时。当客户端发起请求时，它会带上这个 Cookie，NGINX 将根据 Cookie 将请求路由到正确的服务器。
基于 URL 参数的会话保持
如果应用程序能够在 URL 中传递某种标识符，NGINX 也可以基于 URL 参数实现会话保持。配置示例：
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
|
在这个示例中，NGINX 使用 `$arg_session_id` 来决定请求应该路由到哪一台后端服务器。需要确保应用程序在 URL 中正确地传递 `session_id` 参数。
基于 Session Sticky 模块
如果需要更加灵活的会话保持配置，你可以使用第三方的 `nginx-sticky-module` 模块（需要手动编译 NGINX 支持此模块）。
配置示例：
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
|
这需要额外安装模块，可以提供更丰富的会话保持功能，如基于 Cookie 或其他自定义规则。
具体实现
基于 `nginx-sticky-module` 模块实现会话保持需要先编译并安装该模块，然后配置 NGINX 使用它。以下是详细的实现步骤，包括模块的安装和配置过程。
1. 安装 NGINX Sticky 模块
Step 1: 下载并编译 NGINX 源码和 Sticky 模块
要安装 `nginx-sticky-module`，需要重新编译 NGINX 并加入该模块。以下是基于 Linux 的示例：
- 首先，安装必要的依赖：
| 1 2 |
|
- 下载 NGINX 源码（可根据需要下载你所用的版本）：
| 1 2 3 4 |
|
- 下载 `nginx-sticky-module` 模块：
| 1 |
|
Step 2: 编译并安装 NGINX
在编译 NGINX 时，指定模块路径，将 `sticky-module` 添加到 NGINX 中：
- 检查当前 NGINX 的编译参数（如果 NGINX 已经安装）：
| 1 |
|
- 进入 NGINX 源码目录，编译并安装 NGINX：
| 1 2 3 |
|
- 验证 NGINX 是否正确编译和安装：
| 1 |
|
2. 配置 NGINX 使用 Sticky 模块
`nginx-sticky-module` 安装好后，你就可以使用它来实现会话保持。
配置示例：
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
|
- `sticky`：此指令开启会话保持，模块会自动为每个客户端生成一个基于 Cookie 的哈希值，并将请求路由到同一台服务器。
该配置基于 `nginx-sticky-module`，它会为客户端设置一个名为 `route` 的 Cookie，后续请求将通过该 Cookie 进行会话保持。
3. Sticky 指令的更多配置选项
`nginx-sticky-module` 支持多种配置参数，可以根据需求进行调整。常用选项如下：
- `sticky name=cookiename expires=1h domain=.example.com path=/`:
- `name`: 指定 Cookie 名字，默认为 `route`。
- `expires`: Cookie 的过期时间，例如 `1h` 表示 1 小时。
- `domain`: 指定 Cookie 作用的域名。
- `path`: 指定 Cookie 的路径。 配置示例：
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
|
此配置将创建一个名为 `sessionid` 的 Cookie，Cookie 的有效期为 2 小时，且适用于 `.example.com` 域名下的所有路径。
4. 验证 Sticky 会话保持
- 启动 NGINX 服务：
| 1 |
|
- 测试配置是否生效：可以通过浏览器或 curl 工具测试，观察是否客户端的后续请求会被路由到同一台服务器。
| 1 |
|
5. 常见问题排查
- 模块安装失败：确保 NGINX 是通过源码编译的，并且在编译时指定了 `--add-module` 参数。如果 NGINX 是通过包管理器安装的，可能需要先卸载再重新编译。
- NGINX 无法启动：确保所有 NGINX 配置文件语法正确，可以使用以下命令检查配置：
| 1 |
|