pottava/s3-proxy

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

!circleci状态

支持的标签及对应的Dockerfile链接：

・latest (https://github.com/pottava/aws-s3-proxy/blob/master/docker/linux/2.0/Dockerfile)
・2.0 (https://github.com/pottava/aws-s3-proxy/blob/master/docker/linux/2.0/Dockerfile)
・1.4 (https://github.com/pottava/aws-s3-proxy/blob/master/docker/linux/1.4/Dockerfile)
・1.4-win (https://github.com/pottava/aws-s3-proxy/blob/master/docker/windows/1.4/Dockerfile)
・1 (https://github.com/pottava/aws-s3-proxy/blob/master/docker/linux/1.4/Dockerfile)

镜像概述

这是一个AWS S3的反向代理工具，支持基本认证功能。无需为S3桶配置“网站托管”，即可通过代理访问桶内资源。例如：[***] -> s3://bucket/access/index.html。

核心功能

1. 反向代理S3桶：直接代理访问S3桶内资源，无需网站托管配置；
2. 基本认证：通过用户名和密码保护S3资源访问；
3. 自定义缓存控制：可覆盖S3对象的Cache-Control和Expires头；
4. CORS支持：配置跨域资源共享策略；
5. TLS加密：支持HTTPS访问；
6. 目录列表：可选开启目录文件列表功能；
7. 访问日志：可将访问日志输出到标准输出；
8. 健康检查：配置健康检查路径，返回200 OK状态。

使用场景

• 需要为公开的S3桶添加基本认证保护；
• 简化S3资源的访问路径，无需暴露原始S3域名；
• 本地开发环境中模拟S3访问；
• 需要对S3资源设置自定义缓存策略或CORS规则。

配置说明

以下是可配置的环境变量：

部署示例

Docker Run命令

1. 基础运行：

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

2. 带基本认证：

bash
docker run -d -p 8080:80 -e AWS_REGION -e AWS_S3_BUCKET -e BASIC_AUTH_USER=admin -e BASIC_AUTH_PASS=password pottava/s3-proxy

3. 带TLS：

bash
docker run -d -p 8080:80 -e AWS_REGION -e AWS_S3_BUCKET -e SSL_CERT_PATH=/path/to/cert.pem -e SSL_KEY_PATH=/path/to/key.pem pottava/s3-proxy

4. 带CORS：

bash
docker run -d -p 8080:80 -e CORS_ALLOW_ORIGIN=https://example.com -e CORS_ALLOW_METHODS=GET,POST -e CORS_ALLOW_HEADERS=Content-Type -e CORS_MAX_AGE=3600 pottava/s3-proxy

Docker Compose配置

yaml
proxy:
  image: pottava/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