nemopay/fake-s3

Fake S3 Docker镜像文档

镜像概述

本镜像基于Ruby 2.2环境构建，集成fakes3工具，用于模拟Amazon S3服务的核心功能。它允许开发者在本地环境中搭建轻量级S3兼容服务，无需依赖真实的AWS S3账户，适用于开发、测试及离线环境下的S3功能验证。

核心功能和特性

• 环境基础：基于Ruby 2.2官方镜像，确保运行环境稳定
• 工具集成：预装fakes3 gem，开箱即可使用S3模拟服务
• 数据持久化：通过卷挂载/fakes3_root目录，支持数据持久化存储
• 端口暴露：默认暴露4567端口，提供S3服务访问端点
• 即开即用：内置启动命令，无需复杂配置即可快速启动服务

使用场景和适用范围

• 本地开发测试：为依赖S3服务的应用提供本地开发环境
• CI/CD流程：在持续集成/部署流程中模拟S3服务，验证应用交互逻辑
• 离线环境验证：在无网络或无法访问AWS的环境中测试S3相关功能
• S3 API学习：作为学习S3 API的本地实验环境

使用方法和配置说明

基本运行命令

通过以下命令快速启动Fake S3服务：

bash
docker run -d -p 4567:4567 --name fakes3-container fakes3

数据持久化配置

为确保数据在容器重启后不丢失，可挂载本地目录至/fakes3_root：

bash
docker run -d -p 4567:4567 -v /本地目录路径:/fakes3_root --name fakes3-container fakes3

docker-compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  fakes3:
    image: fakes3
    ports:
      - "4567:4567"
    volumes:
      - ./fakes3_data:/fakes3_root
    restart: always

启动服务：

bash
docker-compose up -d

服务访问

服务启动后，可通过http://localhost:4567访问Fake S3服务，使用S3客户端工具（如AWS CLI、s3cmd等）连接时需指定endpoint-url：

bash
aws s3 --endpoint-url http://localhost:4567 ls

核心配置说明

• 数据存储路径：/fakes3_root（可通过卷挂载自定义）
• 服务端口：4567（镜像固定配置，如需修改需重新构建镜像）
• 启动命令：fakes3 -r /fakes3_root -p 4567（指定数据根目录和服务端口）