nginx-basic-auth

为单个其他容器提供基本认证的简单Docker镜像。

快速开始

bash
docker run -d --name web dockercloud/hello-world
docker run -d -p 80:80 --link web:web --name auth beevelop/nginx-basic-auth

尝试访问并使用用户名foo和密码bar登录。

高级用法

bash
docker run -d \
           -e HTPASSWD='foo:$apr1$odHl5EJN$KbxMfo86Qdve2FH4owePn.' \
           -e FORWARD_PORT=1337 \
           --link web:web -p 8080:80 \
           --name auth \
           beevelop/nginx-basic-auth

使用单引号以防止$符号被意外解析！

配置

• HTPASSWD（默认值：foo:$apr1$odHl5EJN$KbxMfo86Qdve2FH4owePn.）：启动时会写入.htpasswd文件（非持久化）
• FORWARD_PORT（默认值：80）：需要转发的源容器端口
• FORWARD_HOST（默认值：web）：需要转发的源容器主机名

该容器不需要挂载任何卷！不过，您可以在/etc/nginx/*路径下找到所有相关配置文件。

多用户配置

通过换行符分隔用户可以实现多用户配置。为正确传递换行符，需使用Shell引用（如$'foo\nbar'）：

bash
docker run -d --link web:web --name auth \
           -e HTPASSWD=$'foo:$apr1$odHl5EJN$KbxMfo86Qdve2FH4owePn.\ntest:$apr1$LKkW8P4Y$P1X/r2YyaexhVL1LzZAQm.' \
           beevelop/nginx-basic-auth

上述配置将创建2个用户（foo:bar和test:test）。

故障排除

nginx: [emerg] host not found in upstream "web" in /etc/nginx/conf.d/auth.conf:80

• 您需要将容器链接为web（--link foobar:web）

• 目前不支持SSL，但可能在近期提供。目前，使用另一个反向代理（如jwilder/nginx-proxy）作为中央网关可能是合适的解决方案。只需配置VIRTUAL_HOST环境变量并禁用端口转发。