pottava/proxy

pottava/proxy 镜像文档

!circleci status

支持的标签及对应的 Dockerfile 链接：
・latest (https://github.com/pottava/basicauth-reverseproxy/blob/master/prod/Dockerfile)
・1.1 (https://github.com/pottava/basicauth-reverseproxy/blob/master/prod/Dockerfile)
・1 (https://github.com/pottava/basicauth-reverseproxy/blob/master/prod/Dockerfile)

镜像概述和主要用途

该镜像是一个具备基本认证功能的反向代理，可同时处理虚拟主机和虚拟路径代理。除核心反向代理功能外，还支持TLS加密、CORS跨域配置、访问日志记录、内容压缩等扩展特性，适用于需要简单访问控制和灵活路由的服务场景。

核心功能和特性

• 基本认证：支持通过用户名和密码对代理资源进行访问控制
• 灵活代理：可通过虚拟主机（如*.example.com）或虚拟路径（如/static）指定代理规则
• TLS加密：支持配置SSL证书实现HTTPS访问
• CORS支持：可自定义跨域资源共享规则，包括允许的源、方法、请求头和缓存时间
• 访问日志：可将访问日志输出到标准输出，便于容器日志收集
• 内容压缩：根据请求头自动压缩响应数据
• 健康检查：支持指定健康检查路径，始终返回200 OK状态
• 代理头信息：默认设置X-Forwarded-Host头，保留原始请求主机信息

使用场景和适用范围

• 需要简单认证保护的内部服务代理
• 多域名或多路径的服务路由（如静态资源CDN与应用服务分离）
• 需快速实现HTTPS的服务（如内部工具、演示环境）
• 需要跨域配置的API服务代理
• 微服务架构中的简单反向代理层

使用方法和配置说明

环境变量配置

运行示例

基本运行（单URL代理）

bash
docker run -d -p 8080:80 -e PROXY_URL=http://target-service/ pottava/proxy

带基本认证

bash
docker run -d -p 8080:80 \
  -e PROXY_URL=http://target-service/ \
  -e BASIC_AUTH_USER=admin \
  -e BASIC_AUTH_PASS=password \
  pottava/proxy

启用TLS加密

bash
docker run -d -p 443:80 \
  -e PROXY_URL=http://target-service/ \
  -e SSL_CERT_PATH=/etc/certs/cert.pem \
  -e SSL_KEY_PATH=/etc/certs/key.pem \
  -v ./certs:/etc/certs \
  pottava/proxy

配置CORS

bash
docker run -d -p 8080:80 \
  -e PROXY_URL=http://api-service/ \
  -e CORS_ALLOW_ORIGIN=https://example.com \
  -e CORS_ALLOW_METHODS=GET,POST,PUT \
  -e CORS_ALLOW_HEADERS=Content-Type,Authorization \
  -e CORS_MAX_AGE=86400 \
  pottava/proxy

虚拟主机/路径代理

bash
export PROXY_PATTERNS="/static=http://assets.cdn/,*.example.com=http://app.io/,*=http://sorry.com/"
docker run -d -p 8080:80 -e PROXY_PATTERNS pottava/proxy

使用docker-compose（基本配置）

yaml
proxy:
  image: pottava/proxy
  ports:
    - 80:80
  links:
    - web
  environment:
    - PROXY_URL=http://web/
    - BASIC_AUTH_USER=admin
    - BASIC_AUTH_PASS=password
    - ACCESS_LOG=true
  container_name: proxy

使用docker-compose（虚拟主机+SSL/TLS）

yaml
proxy:
  image: pottava/proxy
  ports:
    - 443:80
  links:
    - web
  environment:
    - PROXY_PATTERNS="/static=http://assets.cdn/,*.example.com=http://app.io/,*=http://sorry.com/"
    - SSL_CERT_PATH=/etc/certs/cert.pem
    - SSL_KEY_PATH=/etc/certs/key.pem
  volumes:
    - ./certs:/etc/certs
  container_name: proxy

版权和许可

代码基于 https://github.com/pottava/basicauth-reverseproxy/blob/master/LICENSE 发布。