svscorp/adop-nginx

adop-nginx镜像说明

镜像概述

adop-nginx是基于Nginx的高性能镜像，集成LDAP认证模块，支持LDAPS、SSL和反向代理功能。它提供安全的身份验证代理服务，适用于企业内部Web服务的访问控制场景。

核心功能

• 反向代理：高性能HTTP/HTTPS反向代理，支持多服务统一入口；
• LDAP认证：集成LDAP模块，支持LDAP/LDAPS协议的用户身份验证；
• SSL支持：可配置HTTPS服务，支持自定义SSL证书；
• 灵活配置：通过环境变量和外部卷实现配置持久化与自定义。

使用场景

1. 企业内部Web服务的LDAP身份验证代理；
2. 多微服务的安全反向代理入口；
3. HTTPS服务的快速部署与配置。

配置说明

环境变量

可通过环境变量调整运行参数：

• NGINX_PORT：监听端口，默认80（HTTP）或443（HTTPS）；
• NGINX_SSL：是否启用SSL，默认off；
• LDAP_PROTOCOL：LDAP协议类型，默认ldap，可选ldaps；
• LDAP_SERVER：LDAP服务器地址（如ldap-host:389）；
• LDAP_USERNAME：LDAP绑定用户名；
• LDAP_PASSWORD：LDAP绑定密码；
• LDAP_USER_BASE_DN：用户搜索基础DN；
• CUSTOM_CONF：是否允许自定义Nginx配置，默认false；
• CUSTOM_HTML：是否允许自定义HTML页面，默认false。

部署示例

Docker Run命令

bash
docker run --name my-adop-nginx -dt \
  -v /path/to/nginx/config:/etc/nginx/:ro \
  -v /path/to/html:/usr/share/nginx/html/:ro \
  -v /path/to/logs:/var/log \
  -p 80:80 \
  -p 443:443 \
  -e NGINX_SSL=on \
  -e LDAP_PROTOCOL=ldaps \
  -e LDAP_SERVER=ldap.example.com:636 \
  svscorp/adop-nginx:0.3.3

SSL配置步骤

1. 准备SSL证书文件（host.crt和host.key）；
2. 复制证书到Nginx配置卷的ssl目录：

   bash
   # 获取配置卷挂载路径
   docker volume inspect nginx_config | grep Mountpoint
   # 复制证书到ssl目录
   cp host.crt host.key /var/lib/docker/volumes/nginx_config/_data/ssl/
   # 重启容器生效
   docker restart my-adop-nginx
   

许可证

镜像包含的软件许可证信息请查看LICENCE.md。

支持的Docker版本

官方支持Docker 1.9.1版本，对1.6及以上版本提供尽力支持。

用户反馈

• 文档：参考http://nginx.org/en/docs/%EF%BC%9B
• 问题反馈：通过https://github.com/Accenture/adop-nginx/issues%E6%8F%90%E4%BA%A4%EF%BC%9B
• 贡献：欢迎通过Pull Request贡献代码，建议先通过Issues讨论计划。