weseek/nginx-auth-ldap

镜像概述

本仓库是官方Nginx镜像（https://registry.hub.docker.com/_/nginx/%EF%BC%89%E6%8D%86%E7%BB%91nginx-auth-ldap%E6%A8%A1%E5%9D%97%EF%BC%88https://github.com/kvspb/nginx-auth-ldap%EF%BC%89%E7%9A%84Docker%E9%95%9C%E5%83%8F%E4%BB%93%E5%BA%93%E3%80%82**%E7%9B%AE%E5%89%8D%E4%BB%85%E7%BB%B4%E6%8A%A4mainline-alpine%E7%89%88%E6%9C%AC**%E3%80%82

核心功能

• 基于官方Nginx镜像构建，保证基础功能兼容性
• 集成nginx-auth-ldap模块，支持通过LDAP服务器进行身份认证
• 支持通过环境变量配置LDAP连接参数

使用场景

适用于需要对Web服务访问进行LDAP身份验证的场景，例如企业内部系统、私有服务的访问控制等。

配置说明

需通过环境变量设置LDAP相关参数：

• NGINX_AUTH_LDAP_URL：LDAP服务器地址及搜索路径（如ldap://example.com/ou=people,dc=example,dc=com）
• NGINX_AUTH_LDAP_BINDDN：绑定DN（如cn=auth,dc=example,dc=com）
• NGINX_AUTH_LDAP_BINDPW：绑定DN的密码

部署示例

Docker Run方式

执行以下命令，访问http://localhost:8080时需输入LDAP凭据：

bash
$ git clone https://github.com/weseek/nginx-auth-ldap
$ cd nginx-auth-ldap
$ docker run -d -p 127.0.0.1:8080:80 \
    -v $(pwd)/mainline/alpine/conf.d.example:/etc/nginx/conf.d \
    -e NGINX_AUTH_LDAP_URL=<LDAP URL（例如 ldap://example.com/ou=people,dc=example,dc=com）> \
    -e NGINX_AUTH_LDAP_BINDDN=<BIND DN（例如 cn=auth,dc=example,dc=com）> \
    -e NGINX_AUTH_LDAP_BINDPW=<BIND DN的密码> \
    weseek/nginx-auth-ldap:1.13.9-1-alpine

Docker Compose方式

bash
$ git clone https://github.com/weseek/nginx-auth-ldap
$ cd nginx-auth-ldap
$ cat <<EOF > docker-compose.yml
version: '2'
services:
  nginx:
    image: weseek/nginx-auth-ldap:1.13.9-1-alpine
    ports:
      - 127.0.0.1:8080:80
    environment:
      NGINX_AUTH_LDAP_URL: <LDAP URL（例如 ldap://example.com/ou=people,dc=example,dc=com）>
      NGINX_AUTH_LDAP_BINDDN: <BIND DN（例如 cn=auth,dc=example,dc=com）>
      NGINX_AUTH_LDAP_BINDPW: <BIND DN的密码>
    volumes:
      - ./mainline/alpine/conf.d.example:/etc/nginx/conf.d
EOF
$ docker-compose up

同步官方仓库更新

bash
$ git remote add nginx https://github.com/nginxinc/docker-nginx
$ git fetch nginx master
$ git merge nginx/master