procube/nginx

procube/nginx镜像说明

镜像概述

本镜像基于Nginx构建，集成了多个实用模块，旨在提供更强大的反向代理、身份验证及动态服务发现能力，适用于企业级应用场景。

核心功能

• Lua支持：扩展Nginx的脚本能力，实现自定义逻辑；
• Sticky Session：通过补丁移除Cookie哈希中的端口号，支持多服务间共享会话；
• Shibboleth集成：通过补丁将SAML的uid复制到Nginx的remote_user变量，实现身份验证；
• Headers More：灵活修改HTTP请求/响应头；
• AJP上游支持：兼容AJP协议的后端服务；
• 动态域名解析（jdomain）：实时解析上游服务的域名；
• DNS SRV上游发现（resolveMK）：从DNS SRV记录自动发现上游服务。

使用场景

1. 企业内部多服务的反向代理与负载均衡；
2. 需要SAML身份验证的应用集成；
3. 动态变化的上游服务场景（如微服务架构）；
4. 需要自定义HTTP头或会话共享的业务场景。

配置说明

• Shibboleth配置：修改/etc/shibboleth/shibboleth2.xml完成SAML身份提供商配置；
• Sticky Session配置：在Nginx配置中添加sticky name=route cookie=route path=/;启用会话粘性；
• 动态上游配置：使用jdomain或resolveMK模块配置上游，例如：upstream backend { jdomain server.example.com; }。

部署示例

Docker Run命令

bash
docker run -d \
  -p 80:80 \
  -v ./nginx.conf:/etc/nginx/nginx.conf \
  -v ./shibboleth:/etc/shibboleth \
  procube/nginx

Docker Compose示例

yaml
version: '3'
services:
  nginx:
    image: procube/nginx
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf
      - ./shibboleth:/etc/shibboleth
    restart: always