omercnet/nginx-basic-auth

nginx-basic-auth

一个轻量Docker镜像，通过nginx实现基本认证，为目标容器提供简单访问控制。

概述

此镜像无需修改目标容器即可添加基础认证层，适用于需要临时或简单防护的场景，支持自定义用户凭证和端口转发设置。

核心功能

• 自定义认证凭证（HTPASSWD环境变量）
• 灵活配置目标容器转发端口
• 支持多用户认证
• 零卷挂载运行

使用场景

• 保护内部测试应用的访问
• 限制私有后台系统的未授权访问
• 临时为公开服务添加基础安全防护

配置说明

• HTPASSWD（默认：foo:$apr1$odHl5EJN$KbxMfo86Qdve2FH4owePn.）：用户凭证，格式为用户名:加密密码，多用户用换行分隔。
• FORWARD_PORT（默认：80）：目标容器需转发的端口。

快速启动示例

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

访问时使用默认账号foo/bar登录。

高级配置示例

bash
docker run -d \
           -e HTPASSWD='user:$apr1$xyz$abc123...' \
           -e FORWARD_PORT=1337 \
           --link app:web -p 8080:80 \
           --name auth \
           omercnet/nginx-basic-auth

注意：使用单引号避免`# nginx-basic-auth

一个轻量Docker镜像，通过nginx实现基本认证，为目标容器提供简单访问控制。

概述

此镜像无需修改目标容器即可添加基础认证层，适用于需要临时或简单防护的场景，支持自定义用户凭证和端口转发设置。

核心功能

• 自定义认证凭证（HTPASSWD环境变量）
• 灵活配置目标容器转发端口
• 支持多用户认证
• 零卷挂载运行

使用场景

• 保护内部测试应用的访问
• 限制私有后台系统的未授权访问
• 临时为公开服务添加基础安全防护

配置说明

• HTPASSWD（默认：foo:$apr1$odHl5EJN$KbxMfo86Qdve2FH4owePn.）：用户凭证，格式为用户名:加密密码，多用户用换行分隔。
• FORWARD_PORT（默认：80）：目标容器需转发的端口。

快速启动示例

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

访问时使用默认账号foo/bar登录。

高级配置示例

bash
docker run -d \
           -e HTPASSWD='user:$apr1$xyz$abc123...' \
           -e FORWARD_PORT=1337 \
           --link app:web -p 8080:80 \
           --name auth \
           omercnet/nginx-basic-auth

注意：使用单引号避免符号被Shell解释。

多用户配置

通过换行分隔多个用户，需用Shell引号传递换行：

bash
docker run -d --link web:web --name auth \
           -e HTPASSWD=

## 故障排除
若出现`host not found in upstream "web"`错误，需确保目标容器以`web`为别名链接（如`--link myapp:web`）。

---
当前版本暂不支持SSL，可结合`jwilder/nginx-proxy`实现HTTPS，需配置`VIRTUAL_HOST`并关闭端口转发。user1:$apr1$...\nuser2:$apr1$...' \
           omercnet/nginx-basic-auth

故障排除

若出现__CODE_TOKEN_9__错误，需确保目标容器以__CODE_TOKEN_10__为别名链接（如__CODE_TOKEN_11__）。

当前版本暂不支持SSL，可结合__CODE_TOKEN_12__实现HTTPS，需配置__CODE_TOKEN_13__并关闭端口转发。