justinmchase/s3rver

s3rver-docker镜像

本镜像用于在Docker容器中运行S3模拟服务器（s3rver），帮助开发人员在本地环境快速测试AWS S3相关功能，降低云服务依赖成本。

核心功能

• 模拟S3基础操作：创建桶、上传/下载文件、删除对象等
• 支持事件订阅：将S3事件（如对象创建、删除）推送至指定服务
• 兼容AWS生态：适配AWS CLI和AWS SDK，无缝集成现有开发流程

使用场景

• 本地开发调试S3相关代码，避免真实云服务费用
• 验证S3事件通知逻辑，确保应用响应正确
• 离线环境下测试S3集成功能

配置说明

Docker Compose部署

yml
version: "3"
services:
  s3rver:
    image: docker.xuanyuan.run/justinmchase/s3rver
    volumes:
      - $PWD/.data:/app/.data  # 持久化存储模拟数据
    ports:
      - "4569:4569"  # 暴露S3服务端口

AWS CLI交互示例

sh
# 启动服务
docker-compose up -d

# 创建测试桶
aws s3 mb example --endpoint-url http://localhost:4569

# 上传本地文件至桶
aws s3 cp ./hello.txt s3://example/hello.txt --endpoint-url http://localhost:4569

AWS SDK配置

js
import { S3 } from 'aws-sdk'
const s3 = new S3({
  endpoint: 'http://localhost:4569',
  s3BucketEndpoint: true,
  s3ForcePathStyle: true  // 强制路径样式访问
})

事件订阅设置

通过SUBSCRIBE环境变量配置事件推送：

yml
version: "3"
services:
  subscriber:
    build: .  # 自定义订阅服务
    ports: ["3000:3000"]
  
  s3rver:
    image: docker.xuanyuan.run/justinmchase/s3rver
    ports: ["4569:4569"]
    links: [subscriber]
    environment:
      SUBSCRIBE: "example:ObjectCreated:Put(http://subscriber:3000)"  # 桶+事件+动作+目标URL

订阅语***则：

ml
Subscriptions = 多个Subscription用逗号分隔
Subscription = 桶名:事件类型:动作(目标URL)
事件类型：ObjectCreated | ObjectRemoved | *（所有事件）
动作：Put | Post | Copy | Delete | *（所有动作）

AWS文档参考

• https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html
• https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html#supported-notification-event-types
• https://docs.aws.amazon.com/AmazonS3/latest/dev/notification-content-structure.html