picoded/nginx-remote-auth-proxy

picoded/nginx-remote-auth-proxy

镜像概述

picoded/nginx-remote-auth-proxy是一个预配置的Nginx服务器镜像，核心功能是提供HTTP基础认证并代理转发到指定的后端服务，适用于需要轻量级访问控制的场景。镜像支持通过环境变量自定义认证规则、转发目标等参数，配置灵活且易于部署。

核心功能

1. HTTP基础认证：基于htpasswd实现用户身份验证，支持加密密码配置；
2. 代理转发：将认证通过的请求转发到指定的后端主机和端口；
3. 参数自定义：可配置认证域、代理超时时间、转发协议等参数；
4. 轻量级部署：镜像体积小，配置简单，适合快速搭建受保护的代理服务。

使用场景

1. 内部服务的访问控制：对企业内部API或后台系统添加简易认证保护；
2. 个人项目的安全防护：为个人开发的Web服务提供基础的身份验证；
3. 反向代理加认证：作为反向代理层，在转发请求前进行身份校验。

配置说明

镜像通过以下环境变量进行配置：

• HTPASSWD：认证用户信息（格式为用户名:密码，支持多用户用换行分隔，密码可采用加密格式），默认值为picoded:{PLAIN}isAwesome!；
• FORWARD_HOST：后端服务主机名（可使用容器名称），默认值为webhost；
• FORWARD_PORT：后端服务端口，默认值为80；
• FORWARD_PROT：转发协议（http/https），默认值为http；
• AUTH_REALM：认证域名称，默认值为Restricted；
• PROXY_READ_TIMEOUT：代理读取超时时间（秒），默认值为600。

部署示例

Docker Run命令

bash
docker run -d \
  -p 8080:80 \
  -e HTPASSWD='user1:{SHA}5en6G6MezRroT3XKqkdPOmY/BfQ=' \
  -e FORWARD_HOST='my-backend-service' \
  -e FORWARD_PORT='8080' \
  docker.xuanyuan.run/picoded/nginx-remote-auth-proxy

Docker Compose示例

yaml
version: '3'
services:
  auth-proxy:
    image: docker.xuanyuan.run/picoded/nginx-remote-auth-proxy
    ports:
      - "8080:80"
    environment:
      HTPASSWD: 'admin:{SHA}dQNjUIMorJb8Ubj2+wVGYp6eAeY='
      FORWARD_HOST: 'backend'
      FORWARD_PORT: '3000'
      AUTH_REALM: 'Admin Area'
  backend:
    image: docker.xuanyuan.run/your-backend-image
    ports:
      - "3000:3000"

问题反馈

如有问题或建议，请通过GitHub仓库反馈：https://github.com/picoded/dockerfiles