a00s/docker-nginx-basic-auth-with-env

!GitHub Workflow Status !Docker Pulls !Docker Stars !Docker Image Size (tag) !License !GitHub Release Date !CalVer ![Beevelop]([***]

nginx-basic-auth

镜像概述

用于为单个其他容器提供基础认证的简单Docker镜像，通过环境变量配置认证信息和流量转发规则，无需挂载卷即可运行。

核心功能和特性

• 支持通过环境变量配置基础认证用户信息（.htpasswd）
• 可配置转发目标容器的主机名和端口
• 支持自定义NGINX服务监听的主机和端口
• 无需挂载卷，配置通过环境变量动态生成
• 支持多用户认证配置

使用场景

• 为内部服务添加简单的访问控制
• 保护未自带认证机制的容器化应用
• 开发环境中临时限制服务访问权限

使用方法

快速开始

bash
# 启动一个示例web容器
docker run -d --name web dockercloud/hello-world
# 启动基础认证容器并链接web容器
docker run -d -p 80:80 --link web:web --name auth beevelop/nginx-basic-auth

尝试访问 http://localhost，使用默认凭据登录：

• 用户名：foo
• 密码：bar

高级用法

bash
docker run -d \
           -e HTPASSWD='foo:$apr1$odHl5EJN$KbxMfo86Qdve2FH4owePn.' \  # 自定义认证信息
           -e FORWARD_PORT=1337 \  # 转发目标容器端口
           -e NGINX_PORT=8080 \  # NGINX监听端口
           -e NGINX_HOST=0.0.0.0 \  # NGINX绑定主机
           --link web:web \  # 链接目标容器
           -p 8080:8080 \  # 端口映射
           --name auth \
           beevelop/nginx-basic-auth

注意：使用单引号包裹HTPASSWD值，避免`!GitHub Workflow Status !Docker Pulls !Docker Stars !Docker Image Size (tag) !License !GitHub Release Date !CalVer ![Beevelop]([***]

nginx-basic-auth

镜像概述

用于为单个其他容器提供基础认证的简单Docker镜像，通过环境变量配置认证信息和流量转发规则，无需挂载卷即可运行。

核心功能和特性

• 支持通过环境变量配置基础认证用户信息（.htpasswd）
• 可配置转发目标容器的主机名和端口
• 支持自定义NGINX服务监听的主机和端口
• 无需挂载卷，配置通过环境变量动态生成
• 支持多用户认证配置

使用场景

• 为内部服务添加简单的访问控制
• 保护未自带认证机制的容器化应用
• 开发环境中临时限制服务访问权限

使用方法

快速开始

bash
# 启动一个示例web容器
docker run -d --name web dockercloud/hello-world
# 启动基础认证容器并链接web容器
docker run -d -p 80:80 --link web:web --name auth beevelop/nginx-basic-auth

尝试访问 http://localhost，使用默认凭据登录：

• 用户名：foo
• 密码：bar

高级用法

bash
docker run -d \
           -e HTPASSWD='foo:$apr1$odHl5EJN$KbxMfo86Qdve2FH4owePn.' \  # 自定义认证信息
           -e FORWARD_PORT=1337 \  # 转发目标容器端口
           -e NGINX_PORT=8080 \  # NGINX监听端口
           -e NGINX_HOST=0.0.0.0 \  # NGINX绑定主机
           --link web:web \  # 链接目标容器
           -p 8080:8080 \  # 端口映射
           --name auth \
           beevelop/nginx-basic-auth

注意：使用单引号包裹HTPASSWD值，避免符号被Shell解释。

完整示例

shell
docker run --rm \  
  -p 7070:7070 \
  -e NGINX_PORT=7070 \  # NGINX服务监听端口
  -e NGINX_HOST=localhost \  # NGINX绑定主机名
  -e FORWARD_PORT=8888 \  # 转发到目标容器的8888端口
  -e FORWARD_HOST=nginx \  # 转发目标容器主机名
  -e HTPASSWD='username:$apr1$0SUNY6DM$/DAoI2uFeZlbwwr9IVC0t0' \  # 自定义用户认证
  a00s/docker-nginx-basic-auth-with-env:1.21.1-alpine-1

验证健康状态：

shell
curl localhost:7070/health  # 应返回 OK

配置参数

多用户配置

通过换行分隔多个用户信息，使用Shell引用（如`）传递换行符：

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

上述配置创建两个用户：
- `foo:bar`
- `test:test`

## 故障排除

### 错误：`nginx: [emerg] host not found in upstream "web" in /etc/nginx/conf.d/auth.conf:80`

**解决方法**：确保目标容器通过`--link`参数链接为`web`，例如`--link 目标容器名:web`

### SSL支持

目前不支持SSL，建议通过其他反向代理（如`jwilder/nginx-proxy`）作为中央网关，配置`VIRTUAL_HOST`环境变量并禁用端口转发。foo:$apr1$odHl5EJN$KbxMfo86Qdve2FH4owePn.\ntest:$apr1$LKkW8P4Y$P1X/r2YyaexhVL1LzZAQm.' \
           beevelop/nginx-basic-auth

上述配置创建两个用户：

• CODE_TOKEN_22
• CODE_TOKEN_23

故障排除

错误：CODE_TOKEN_24

解决方法：确保目标容器通过__CODE_TOKEN_25__参数链接为__CODE_TOKEN_26__，例如__CODE_TOKEN_27__

SSL支持

目前不支持SSL，建议通过其他反向代理（如__CODE_TOKEN_28__）作为中央网关，配置__CODE_TOKEN_29__环境变量并禁用端口转发。user1\nuser2'`）传递换行符：

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

上述配置创建两个用户：
- __CODE_TOKEN_22__
- __CODE_TOKEN_23__

## 故障排除

### 错误：__CODE_TOKEN_24__

**解决方法**：确保目标容器通过__CODE_TOKEN_25__参数链接为__CODE_TOKEN_26__，例如__CODE_TOKEN_27__

### SSL支持

目前不支持SSL，建议通过其他反向代理（如__CODE_TOKEN_28__）作为中央网关，配置__CODE_TOKEN_29__环境变量并禁用端口转发。foo:$apr1$odHl5EJN$KbxMfo86Qdve2FH4owePn.\ntest:$apr1$LKkW8P4Y$P1X/r2YyaexhVL1LzZAQm.' \
           beevelop/nginx-basic-auth

上述配置创建两个用户：

• CODE_TOKEN_22
• CODE_TOKEN_23

故障排除

错误：CODE_TOKEN_24

解决方法：确保目标容器通过__CODE_TOKEN_25__参数链接为__CODE_TOKEN_26__，例如__CODE_TOKEN_27__

SSL支持

目前不支持SSL，建议通过其他反向代理（如__CODE_TOKEN_28__）作为中央网关，配置__CODE_TOKEN_29__环境变量并禁用端口转发。