patrickdk/s3-proxy

AWS S3反向代理（带基本认证支持）

多架构构建支持。

镜像概述

这是一个AWS S3反向代理工具，支持基本认证功能，无需将S3存储桶配置为“网站托管”模式即可使用。
URL映射示例：http://this-proxy.com/access/ -> s3://bucket/access/index.html

核心功能与特性

• 反向代理：将HTTP请求代理至指定S3存储桶，无需配置S3网站托管
• 认证保护：支持基本认证（Basic Auth）和JWT认证，增强资源访问安全性
• 目录列表：可配置目录文件列表功能，支持多种列表格式（html/shtml/apache）
• 多场景适配：支持单页应用（SPA）模式、自定义缓存策略、CORS配置
• 安全增强：提供TLS加密、IP白名单、请求来源IP解析等安全功能
• 灵活配置：丰富的环境变量参数，支持自定义端口、日志、健康检查、指标暴露等
• 多架构支持：适配多种硬件架构

使用场景

• 需要通过认证保护S3存储桶资源访问（如内部文档、私有静态资源）
• 静态网站托管，无需配置S3原生网站托管功能
• 需自定义缓存策略、CORS规则或响应头的S3资源访问场景
• 内部服务文档或资产库，需要目录浏览功能
• 需要集成JWT认证或IP限制的S3资源访问控制

使用方法与配置说明

1. 环境变量配置

以下是所有可用环境变量的详细说明：

2. 启动容器

基本启动命令

bash
docker run -d -p 8080:80 -e AWS_REGION -e AWS_S3_BUCKET patrickdk/s3-proxy

带基本认证的启动

bash
docker run -d -p 8080:80 -e AWS_REGION -e AWS_S3_BUCKET -e BASIC_AUTH_USER -e BASIC_AUTH_PASS patrickdk/s3-proxy

带TLS加密的启动

bash
docker run -d -p 8080:80 -e AWS_REGION -e AWS_S3_BUCKET -e SSL_CERT_PATH -e SSL_KEY_PATH patrickdk/s3-proxy

带CORS配置的启动

bash
docker run -d -p 8080:80 -e CORS_ALLOW_ORIGIN -e CORS_ALLOW_METHODS -e CORS_ALLOW_HEADERS -e CORS_MAX_AGE patrickdk/s3-proxy

Docker Compose示例

yaml
proxy:
  image: patrickdk/s3-proxy
  ports:
    - 8080:80
  environment:
    - AWS_REGION=ap-northeast-1
    - AWS_ACCESS_KEY_ID
    - AWS_SECRET_ACCESS_KEY
    - AWS_S3_BUCKET
    - BASIC_AUTH_USER=admin
    - BASIC_AUTH_PASS=password
    - ACCESS_LOG=true
  container_name: proxy

版权与许可

代码以https://github.com/pottava/aws-s3-proxy/blob/master/LICENSE%E5%8F%91%E5%B8%83%E3%80%82