dealercom/nginx-auth-proxy

dealercom/nginx-auth-proxy 镜像说明

镜像概述

dealercom/nginx-auth-proxy是一个基于nginx的代理镜像，利用nginx的auth_request模块实现请求的认证检查，支持通过环境变量灵活配置，适用于需要对后端服务进行认证保护的场景。

核心功能

1. 通过环境变量配置认证服务器、代理地址及后端服务地址
2. 利用auth_request模块向认证服务器发送检查请求，验证用户登录状态
3. 认证失败时重定向至登录端点，认证成功则转发请求至后端服务

使用场景

• 内部系统的访问认证保护
• 需要登录验证的Web应用后端代理
• 多服务环境下的统一认证入口

配置说明

环境变量

• AUTH_SERVER_URL: 认证服务器的基础URL
• PROXY_URL_BASE: 该代理服务的可达基础URL
• BACKEND_URL: 需代理的后端服务URL

认证服务器规范

• /auth/check: 用于检查登录信息有效性的端点
• /auth/login: 登录检查失败时重定向的端点（更多细节可参考nginx官方文档：http://nginx.org/en/docs/http/ngx_http_auth_request_module.html%EF%BC%89

部署示例

Docker Run命令

bash
docker run -d \
  -p 8080:80 \
  -e AUTH_SERVER_URL=http://your-auth-server.com \
  -e PROXY_URL_BASE=http://your-proxy.com \
  -e BACKEND_URL=http://your-backend-service.com \
  docker.xuanyuan.run/dealercom/nginx-auth-proxy

Docker Compose示例

yaml
version: '3'
services:
  nginx-auth-proxy:
    image: dealercom/nginx-auth-proxy
    ports:
      - "8080:80"
    environment:
      - AUTH_SERVER_URL=[***]
      - PROXY_URL_BASE=http://localhost:8080
      - BACKEND_URL=[***]