nosinovacao/nginx

nosinovacao/nginx 镜像文档

镜像概述和主要用途

本镜像为官方https://registry.hub.docker.com/_/nginx/的分支版本。基于Alpine稳定版和主线版镜像进行修改，添加了多个扩展模块，旨在提供增强的认证、监控和扩展能力。未对alpine-perl或stretch版本镜像进行修改。

核心功能和特性

在Alpine版本（stable & mainline）中添加了以下额外模块：

• VST：Nginx虚拟主机流量状态模块，用于监控虚拟主机的流量数据
• LDAP Auth：基于LDAP的认证模块，支持通过LDAP服务器进行用户认证
• NJS：Nginx JavaScript模块，允许使用JavaScript扩展Nginx功能
• LUA nginx module：LUA扩展模块，提供强大的脚本能力以扩展Nginx功能

使用场景和适用范围

适用于需要以下功能的Nginx部署场景：

• 需要LDAP认证保护的静态资源服务
• 需监控虚拟主机流量的Web服务
• 需要通过LUA或JavaScript扩展Nginx功能的场景
• 作为Docker Registry的认证代理服务器

使用方法和配置说明

无认证的静态页面

运行默认静态页面容器：

bash
docker run --name nginx -d -p 80:80 docker.xuanyuan.run/nosinovacao/nginx

运行自定义静态页面（挂载本地内容目录）：

bash
docker run --name nginx -v /some/content:/usr/local/nginx/html:ro -d -p 80:80 docker.xuanyuan.run/nosinovacao/nginx

设置LDAP容器

如需使用LDAP认证功能，可按以下步骤设置测试用LDAP容器（实际环境中建议连接现有LDAP服务器如OpenLDAP或Active Directory）：

1. 启动LDAP容器（使用nickstenning/slapd镜像）：

   bash
   docker run -e LDAP_DOMAIN=example.com -e LDAP_ORGANIZATION="Example Ltd." -e LDAP_ROOTPASS=toor --name ldap -d -p 389:389 docker.xuanyuan.run/nickstenning/slapd
   

2. 添加示例用户和组（使用https://github.com/nosinovacao/docker-nginx/blob/master/examples/sample.ldif）：

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

3. 验证测试用户是否存在：

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

带LDAP认证的静态页面

1. 创建包含LDAP认证配置的nginx.conf文件（可参考https://github.com/nosinovacao/docker-nginx/blob/master/examples/basic/nginx.conf）

2. 启动Nginx容器并链接LDAP容器：

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

3. 访问时将出现认证对话框，测试用户名为test，密码为t3st

更多LDAP认证配置细节可参考https://github.com/kvspb/nginx-auth-ldap

设置Docker Registry容器

为演示Nginx作为Docker Registry认证代理的用法，先部署一个Docker Registry容器：

bash
docker run -d --name docker.xuanyuan.run/registry -v /your/local/registry/path:/registry -e SETTINGS_FLAVOR=local -e STORAGE_PATH=/registry registry

此Registry实例默认不对外暴露，需通过Nginx代理访问

Docker Registry代理配置

1. 准备SSL证书（推荐使用可信CA签发的证书）：

   • 证书文件命名为docker-registry.crt
   • 私钥文件命名为docker-registry.key
   • 放置在本地目录（如/ssl/cert/path）

2. 启动Nginx代理容器（使用https://github.com/nosinovacao/docker-nginx/tree/master/config/proxy）：

   bash
   docker run --name nginx --link ldap:ldap --link registry:docker-registry -v /ssl/cert/path:/etc/ssl/docker:ro -v `pwd`/config/proxy:/etc/nginx:ro -p 80:80 -p 443:443 -p 5000:5000 -d docker.xuanyuan.run/nosinovacao/nginx
   

注意：不推荐使用自签名证书，如必须使用，需在Docker daemon启动参数中添加--insecure-registry

更多Docker Registry代理配置细节可参考https://github.com/docker/docker-registry/blob/master/ADVANCED.md

调试

本镜像的Nginx已编译调试支持，可通过以下步骤启用调试日志：

1. 在Nginx配置中添加：

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

2. 查看调试日志：

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

调试日志将包含LDAP认证过程等详细信息，例如：

2015/02/14 17:57:10 [debug] 5#0: *2 http_auth_ldap: Username is "test"
2015/02/14 17:57:10 [debug] 5#0: *2 http_auth_ldap: Authentication loop (phase=0, iteration=0)
2015/02/14 17:57:10 [debug] 5#0: *2 http_auth_ldap: Search filter is "(&(objectClass=person)(uid=test))"
...