stefanfritsch/apache-auth-proxy_statup

Apache反向代理（带认证功能）

镜像概述

本镜像基于Apache HTTP Server构建，集成了反向代理与用户认证功能，通过内置登录页面验证用户身份，确保只有授权用户可访问后端服务，适用于需要安全访问控制的反向代理场景。

核心功能与特性

• 反向代理能力：支持HTTP/HTTPS请求转发至后端服务，实现服务隐藏与负载均衡基础。
• 内置认证机制：提供登录页面进行用户身份验证，支持账号密码校验，防止未授权访问。
• 配置灵活性：可通过环境变量或自定义配置文件调整反向代理规则、认证方式及用户信息。
• 兼容性广泛：适配各类后端服务（如Web应用、API服务、静态资源服务器等）。

使用场景与适用范围

• 保护无内置认证的内部Web应用，限制访问权限。
• 为公开暴露的API服务添加前置身份验证层。
• 企业内部系统的反向代理与访问控制管理。
• 需要区分用户权限的多服务统一入口场景。

使用方法与配置说明

基本使用（Docker Run）

bash
docker run -d \
  -p 80:80 \
  -e TARGET_SERVICE=http://backend:8080 \
  -e AUTH_USER=admin \
  -e AUTH_PASSWORD=SecurePass123 \
  --name apache-auth-proxy \
  [镜像名称]

参数说明：

• -p 80:80：映射容器HTTP端口至主机
• TARGET_SERVICE：后端服务地址（必填，格式：http://[IP/域名]:[端口]）
• AUTH_USER：认证用户名（默认：admin）
• AUTH_PASSWORD：认证密码（建议使用强密码，生产环境需加密存储）

Docker Compose配置示例

yaml
version: '3.8'
services:
  proxy:
    image: [镜像名称]
    ports:
      - "80:80"
    environment:
      - TARGET_SERVICE=http://app:3000
      - AUTH_USER=operator
      - AUTH_PASSWORD=AppAccess2024!
      - LOGIN_TITLE=系统访问认证
    volumes:
      - ./custom-login.html:/usr/local/apache2/htdocs/login.html  # 自定义登录页面
    depends_on:
      - app
  app:
    image: [后端应用镜像]
    expose:
      - "3000"

高级配置

1. 自定义反向代理规则

通过挂载Apache配置文件自定义代理路径映射：

bash
docker run -d \
  -p 80:80 \
  -v ./proxy.conf:/usr/local/apache2/conf/extra/proxy.conf \
  [镜像名称]

proxy.conf示例：

apache
# 路径级代理规则
ProxyPass "/api" "http://backend:8080/api"
ProxyPassReverse "/api" "http://backend:8080/api"

# 根路径代理
ProxyPass "/" "http://backend:8080/web"
ProxyPassReverse "/" "http://backend:8080/web"

2. 调整认证方式

默认使用表单认证，可切换为Basic Auth（需提前生成.htpasswd文件）：

bash
# 生成htpasswd文件（需本地安装apache2-utils）
htpasswd -c ./htpasswd admin

# 启动容器时挂载认证文件
docker run -d \
  -p 80:80 \
  -e TARGET_SERVICE=http://backend:8080 \
  -v ./htpasswd:/usr/local/apache2/conf/.htpasswd \
  -v ./basic-auth.conf:/usr/local/apache2/conf/extra/auth.conf \
  [镜像名称]

basic-auth.conf配置：

apache
<Location "/">
  AuthType Basic
  AuthName "Restricted Access"
  AuthUserFile "/usr/local/apache2/conf/.htpasswd"
  Require valid-user
</Location>

3. 启用HTTPS支持

挂载SSL证书并配置HTTPS端口：

bash
docker run -d \
  -p 443:443 \
  -e TARGET_SERVICE=https://backend:443 \
  -v ./ssl:/usr/local/apache2/conf/ssl \  # 包含cert.pem和key.pem
  -v ./ssl.conf:/usr/local/apache2/conf/extra/ssl.conf \
  [镜像名称]

注意事项

• 生产环境必须启用HTTPS，避免密码明文传输（可通过挂载SSL证书实现）。
• 敏感信息（如密码）建议通过Docker Secrets或环境变量加密注入，避免硬编码。
• 定期更新镜像以获取Apache安全补丁及功能更新。
• 高并发场景下建议配合负载均衡器使用，并调整Apache最大连接数配置。