badouralix/nginx-basic-auth

nginx-basic-auth镜像说明

镜像概述

这是一个轻量级Docker镜像，基于Nginx实现基本HTTP身份认证功能，可作为反向代理层为后端服务添加简单的用户名密码验证，无需复杂配置即可快速部署。

核心功能

• 支持单用户或多用户的基本身份认证
• 可自定义认证领域（Realm）提示信息
• 灵活配置后端服务的转发端口
• 无需挂载卷即可运行，配置通过环境变量传递

使用场景

• 保护内部测试环境的服务访问
• 为私人小应用或工具添加基础安全验证
• 临时限制未授权用户访问公开的后端服务

配置说明

部署示例

快速启动

bash
# 启动后端服务容器
docker run -d --name web docker.xuanyuan.run/dockercloud/hello-world
# 启动认证容器并链接后端服务
docker run -d -p 80:80 --link web:web --name auth docker.xuanyuan.run/badouralix/nginx-basic-auth

访问http://localhost，使用默认用户名foo和密码bar登录。

高级配置（自定义认证信息和转发端口）

bash
docker run -d \
           -e HTPASSWD='user1:$apr1$xyz$abcdefghijklmnopqrstu.' \
           -e FORWARD_PORT=1337 \
           -e REALM="Private Service" \
           --link web:web -p 8080:80 \
           --name auth \
           docker.xuanyuan.run/badouralix/nginx-basic-auth

多用户配置

bash
docker run -d --link web:web --name auth \
           -e HTPASSWD=```user1:$apr1$odHl5EJN$KbxMfo86Qdve2FH4owePn.\nuser2:$apr1$LKkW8P4Y$P1X/r2YyaexhVL1LzZAQm.' \
           docker.xuanyuan.run/badouralix/nginx-basic-auth

此配置包含两个用户：user1:bar和user2:test。

常见问题

若出现nginx: [emerg] host not found in upstream "web"错误，需确保后端容器已通过--link 后端容器名:web的方式链接到认证容器。 目前暂不支持SSL，建议结合其他反向代理（如jwilder/nginx-proxy）实现HTTPS访问。