emmekappa/docker-nginx-basic-auth

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值，避免`# 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值，避免符号被Shell解析。

核心配置项

• HTPASSWD（默认值：foo:$apr1$odHl5EJN$KbxMfo86Qdve2FH4owePn.）：启动时写入.htpasswd文件的认证信息（非持久化）
• FORWARD_PORT（默认值：80）：需转发的源容器端口

容器无需挂载卷，关键配置文件位于/etc/nginx/*路径。

多用户设置

通过换行分隔多用户信息，需使用Shell的换行转义（如`）：

docker run -d --link web:web --name auth \
           -e HTPASSWD=
上述命令将创建`foo:bar`和`test:test`两个用户。

## 常见问题
- 错误：`nginx: [emerg] host not found in upstream "web"`  
  解决：需将目标容器链接为`web`（如`--link your-container:web`）
  
---
- 当前版本暂不支持SSL，可搭配`jwilder/nginx-proxy`等反向代理实现HTTPS，只需配置`VIRTUAL_HOST`环境变量并关闭端口转发即可。foo:$apr1$odHl5EJN$KbxMfo86Qdve2FH4owePn.\ntest:$apr1$LKkW8P4Y$P1X/r2YyaexhVL1LzZAQm.' \
           beevelop/nginx-basic-auth

上述命令将创建__CODE_TOKEN_12__和__CODE_TOKEN_13__两个用户。

常见问题

• 错误：CODE_TOKEN_14
  解决：需将目标容器链接为__CODE_TOKEN_15__（如__CODE_TOKEN_16__）

• 当前版本暂不支持SSL，可搭配__CODE_TOKEN_17__等反向代理实现HTTPS，只需配置__CODE_TOKEN_18__环境变量并关闭端口转发即可。user1\nuser2'`）：

docker run -d --link web:web --name auth \
           -e HTPASSWD=
上述命令将创建__CODE_TOKEN_12__和__CODE_TOKEN_13__两个用户。

## 常见问题
- 错误：__CODE_TOKEN_14__  
  解决：需将目标容器链接为__CODE_TOKEN_15__（如__CODE_TOKEN_16__）
  
---
- 当前版本暂不支持SSL，可搭配__CODE_TOKEN_17__等反向代理实现HTTPS，只需配置__CODE_TOKEN_18__环境变量并关闭端口转发即可。foo:$apr1$odHl5EJN$KbxMfo86Qdve2FH4owePn.\ntest:$apr1$LKkW8P4Y$P1X/r2YyaexhVL1LzZAQm.' \
           beevelop/nginx-basic-auth

上述命令将创建__CODE_TOKEN_12__和__CODE_TOKEN_13__两个用户。

常见问题

• 错误：CODE_TOKEN_14
  解决：需将目标容器链接为__CODE_TOKEN_15__（如__CODE_TOKEN_16__）

• 当前版本暂不支持SSL，可搭配__CODE_TOKEN_17__等反向代理实现HTTPS，只需配置__CODE_TOKEN_18__环境变量并关闭端口转发即可。