rjpr/s3lazy

https://img.shields.io/badge/Also%20on-GitHub%20Container%20Registry-blue?logo=github](https://ghcr.io/rjpr/s3lazy)

s3lazy

你是否曾在本地测试时修改S3对象，意外破坏了共享开发环境？

s3lazy是一款懒加载S3代理。将你的应用指向它而非AWS，对象会在首次访问时被获取并本地存储。你的修改将保持隔离，队友也能保持愉快。

为什么选择s3lazy？

• 本地开发：无需提前下载所有内容，即可使用生产环境S3数据
• CI/CD管道：仅缓存测试实际需要的S3对象
• 成本优化：通过缓存频繁访问的对象减少S3 GET请求
• 离线开发：一旦缓存，无需AWS连接即可访问对象

快速开始

docker run -p 9000:9000 \
  -v ./data:/data \
  -e AWS_ACCESS_KEY_ID=你的密钥 \
  -e AWS_SECRET_ACCESS_KEY=你的秘密密钥 \
  -e S3LAZY_INIT_BUCKETS=我的存储桶 \
  rjpr/s3lazy

或使用Docker Compose：

services:
  s3lazy:
    image: rjpr/s3lazy
    ports:
      - "9000:9000"
    volumes:
      - ./data:/data
    environment:
      - AWS_ACCESS_KEY_ID=${AWS_ACCESS_KEY_ID}
      - AWS_SECRET_ACCESS_KEY=${AWS_SECRET_ACCESS_KEY}
      - S3LAZY_INIT_BUCKETS=我的存储桶
      - S3LAZY_BUCKET_MAP=我的存储桶:生产存储桶名称

然后将你的AWS SDK指向http://localhost:9000而非AWS。

提示：使用-v ~/.aws:/home/s3lazy/.aws:ro挂载AWS凭证，而非直接使用访问密钥。

配置

• S3LAZY_BACKEND：disk（默认）、memory或localstack
• S3LAZY_DATA_DIR：缓存目录（默认：/data）
• S3LAZY_INIT_BUCKETS：启动时创建的存储桶（逗号分隔）
• S3LAZY_BUCKET_MAP：本地与AWS存储桶名称映射：local1:aws1,local2:aws2

查看https://github.com/rjpr/s3lazy#configuration%E8%8E%B7%E5%8F%96%E6%89%80%E6%9C%89%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F%E3%80%81YAML%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%E5%8F%8ASDK%E7%A4%BA%E4%BE%8B%E3%80%82

链接

• https://github.com/rjpr/s3lazy
• https://github.com/rjpr/s3lazy#readme