neighborhoods/nginx-auth-ldap

nginx-auth-ldap镜像文档

镜像概述

本镜像是一个集成了nginx-auth-ldap模块的Nginx镜像，设计目标是与官方Alpine主线Nginx Docker镜像保持兼容性。它在标准Nginx功能基础上，增加了通过LDAP协议进行用户身份验证的能力，适用于需要集中身份管理的Web服务场景。

核心功能与特性

• LDAP身份验证：集成nginx-auth-ldap模块，支持通过LDAP服务器验证用户身份
• 兼容性：与官方Alpine主线Nginx Docker镜像兼容，可无缝替换标准Nginx镜像
• 轻量级：基于Alpine Linux构建，保持较小的镜像体积
• 标准Nginx功能：保留Nginx官方镜像的全部核心功能，包括HTTP/HTTPS服务、反向代理、负载均衡等

使用场景与适用范围

• 企业内部Web应用，需要通过公司LDAP服务器进行用户身份验证
• 需集中管理用户访问权限的Web服务
• 替换标准Nginx镜像，为现有服务添加LDAP认证能力
• 构建需要身份验证的内部API或管理后台

使用方法与配置说明

基本使用

可直接使用docker run命令启动容器，与官方Nginx镜像使用方式类似：

bash
docker run -d -p 80:80 --name nginx-ldap [镜像名称]

配置LDAP认证

需通过挂载自定义Nginx配置文件来启用LDAP认证功能。典型的配置示例如下（保存为nginx.conf）：

nginx
http {
    ldap_server myldap {
        url ldap://ldap.example.com:389/dc=example,dc=com?uid?sub?(objectClass=posixAccount);
        binddn "cn=admin,dc=example,dc=com";
        binddn_passwd "adminpassword";
        group_attribute member;
        group_attribute_is_dn on;
        require group "cn=webusers,ou=groups,dc=example,dc=com";
    }

    server {
        listen 80;
        server_name example.com;

        location / {
            auth_ldap "LDAP Authentication Required";
            auth_ldap_servers myldap;
            # 其他Nginx配置...
        }
    }
}

启动容器时挂载配置文件：

bash
docker run -d -p 80:80 -v /path/to/your/nginx.conf:/etc/nginx/nginx.conf --name nginx-ldap [镜像名称]

docker-compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  nginx-ldap:
    image: [镜像名称]
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf
    restart: always

通过docker-compose up -d启动服务。

注意事项

• 确保LDAP服务器地址、端口及认证信息配置正确
• 自定义配置时需保留Nginx基础配置结构，避免服务启动失败
• 基于Alpine镜像，如需额外依赖可通过Dockerfile扩展构建