S3 Ninja Docker镜像

概述

S3 Ninja Docker镜像是一个轻量级工具，用于模拟Amazon AWS S3 API，无需依赖真实的AWS账户即可在本地环境中开发和测试S3相关应用。该镜像提供HTTP访问接口，并支持数据持久化，确保容器重启后文件不丢失。

核心功能与特性

• S3 API模拟：完整模拟Amazon AWS S3 API，支持常见操作如创建bucket、上传/下载文件等
• HTTP访问：默认通过内部端口9000提供HTTP服务，可通过端口映射暴露到主机
• 数据持久化：支持挂载/home/sirius/data目录，实现容器重启后数据保留
• 轻量级部署：镜像体积小，启动快速，适合本地开发和CI/CD环境集成

使用场景

• 本地开发S3相关应用时的API测试环境
• CI/CD流程中集成测试S3功能，避免依赖外部云服务
• 教学或演示环境中模拟S3服务，无需AWS账户

使用方法

基本运行

通过以下命令启动S3 Ninja容器，将容器内9000端口映射到主机的9444端口：

bash
docker run -p 9444:9000 scireum/s3-ninja

启动后，可通过http://localhost:9444访问S3 Ninja服务。

数据持久化配置

为确保容器重启后数据不丢失，可挂载主机目录到容器内的/home/sirius/data：

bash
docker run -p 9444:9000 -v /本地目录:/home/sirius/data scireum/s3-ninja

其中/本地目录为您主机上用于存储S3数据的路径。

Docker Compose配置示例

创建docker-compose.yml文件，配置如下：

yaml
version: '3'
services:
  s3-ninja:
    image: scireum/s3-ninja
    ports:
      - "9444:9000"
    volumes:
      - ./s3-data:/home/sirius/data  # 本地s3-data目录映射到容器数据目录
    restart: always

运行docker-compose up -d启动服务。

贡献与源码

• 源码仓库：[***]
• Dockerfile：[***]
• 欢迎提交Issue或Pull Request参与贡献