horalstvo/nginx-ldap

horalstvo/nginx-ldap 镜像说明

镜像概述

本镜像基于h3nrik/nginx-ldap构建，提供集成LDAP认证功能的Nginx服务，同时遵循标准nginx/nginx镜像的配置规范（支持HTTP2、IPv6、stream协议）。镜像源码及配置示例可通过https://github.com/horalstvo/nginx-ldap%E8%8E%B7%E5%8F%96%EF%BC%8C%E9%95%9C%E5%83%8F%E5%8C%85%E5%8F%AF%E4%BB%8Ehttps://registry.hub.docker.com/u/horalstvo/nginx-ldap/%E4%B8%8B%E8%BD%BD%E3%80%82

核心功能

1. 集成nginx-auth-ldap模块，实现LDAP用户身份认证
2. 兼容标准Nginx配置，支持HTTP2、IPv6和stream协议
3. 内置调试模式，便于排查认证相关问题
4. 可作为Docker私有仓库的代理服务器，提供LDAP访问控制

使用场景

• 静态网页服务（支持无认证或LDAP认证两种模式）
• Docker私有仓库的LDAP认证代理

配置与使用示例

无认证静态页面

运行容器提供默认静态页面：

bash
docker run --name nginx -d -p 80:80 horalstvo/nginx-ldap

挂载自定义静态内容：

bash
docker run --name nginx -v /本地静态内容路径:/usr/local/nginx/html:ro -d -p 80:80 horalstvo/nginx-ldap

搭建测试LDAP容器

如需测试LDAP认证，可使用osixia/openldap镜像搭建环境：

1. 启动LDAP容器：

bash
docker run -e LDAP_DOMAIN=example.com -e LDAP_ORGANISATION="Example Ltd." --name ldap -d -p 389:389 osixia/openldap:1.1.7

2. 添加测试用户和组（需本地安装ldap-utils工具）：

bash
ldapadd -v -h <你的IP>:389 -c -x -D cn=admin,dc=example,dc=com -W -f config/sample.ldif

3. 验证测试用户存在：

bash
ldapsearch -v -h <你的IP>:389 -b 'ou=users,dc=example,dc=com' -D 'cn=admin,dc=example,dc=com' -x -W '(&(objectClass=person)(uid=test))'

带LDAP认证的静态页面

使用包含LDAP认证配置的nginx.conf启动容器：

bash
docker run --name nginx --link ldap:ldap -d -v `pwd`/config/nginx.conf:/etc/nginx/nginx.conf:ro -p 80:80 horalstvo/nginx-ldap

访问时需输入测试用户（账号test，密码t3st）完成认证。

Docker Registry代理配置

1. 启动Docker Registry容器（本地存储模式）：

bash
docker run -d --name registry -v /本地存储路径:/registry -e SETTINGS_FLAVOR=local -e STORAGE_PATH=/registry registry

2. 准备可信SSL证书（文件名为docker-registry.crt和docker-registry.key），挂载并启动代理：

bash
docker run --name nginx --link ldap:ldap --link registry:docker-registry -v /SSL证书路径:/etc/ssl/docker:ro -v `pwd`/config/proxy:/etc/nginx:ro -p 80:80 -p 443:443 -p 5000:5000 -d horalstvo/nginx-ldap

调试方法

在Nginx配置文件中添加调试日志开关：

nginx
error_log /var/log/nginx/error.log debug;

查看调试日志：

bash
docker exec -i -t nginx less /var/log/nginx/error.log

许可证信息

镜像包含以下组件的编译二进制文件：

1. Nginx：许可证详见Nginx官网
2. nginx-auth-ldap模块：许可证详见https://github.com/kvspb/nginx-auth-ldap/blob/master/LICENSE