runnable/sticky-nginx

sticky-nginx镜像说明

镜像概述

本镜像基于Nginx构建，集成了sticky模块，提供反向代理时的粘性会话功能，可在多后端服务集群中保持用户会话的一致性，避免因负载均衡导致的会话丢失问题。

核心功能

1. 具备标准Nginx的反向代理与负载均衡能力
2. 集成sticky模块，支持基于Cookie的会话粘性绑定
3. 兼容常见的多后端服务架构（如Web应用集群、API服务集群）

使用场景

1. 需要会话保持的多节点Web应用部署
2. 分布式系统中要求用户请求持续指向同一后端实例的场景
3. 负载均衡环境下确保会话状态一致性的业务需求

配置说明

在Nginx配置文件中，需在upstream块内添加sticky指令启用会话粘性，示例配置片段：

nginx
upstream backend {
    sticky cookie srv_id expires=1h path=/; # 基于Cookie的会话绑定，有效期1小时
    server backend1:8080;
    server backend2:8080;
}

server {
    listen 80;
    location / {
        proxy_pass http://backend;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

部署示例

Docker Run方式

bash
docker run -d \
  -p 80:80 \
  -v /path/to/your/nginx.conf:/etc/nginx/nginx.conf \
  runnable/sticky-nginx

Docker Compose方式

yaml
version: '3'
services:
  nginx:
    image: runnable/sticky-nginx
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf
    depends_on:
      - backend1
      - backend2
  backend1:
    image: your-backend-image
  backend2:
    image: your-backend-image