ministackorg/ministack

MiniStack Docker镜像文档

镜像概述和主要用途

MiniStack是一个免费开源的LocalStack替代方案，提供20种AWS服务的本地模拟环境，所有服务通过单个端口（4566）访问。与LocalStack不同，MiniStack采用MIT许可，无需账户注册、API密钥，也不包含遥测功能，适合本地开发、测试和CI/CD环境中模拟AWS服务。

核心功能和特性

支持的AWS服务

• S3：对象存储服务
• SQS：简单队列服务
• SNS：简单通知服务
• DynamoDB：NoSQL数据库服务
• Lambda：支持真实Python代码执行的无服务器计算服务
• IAM：身份与访问管理服务
• STS：安全令牌服务
• Secrets Manager：密钥管理服务
• CloudWatch Logs：日志管理服务
• SSM Parameter Store：参数存储服务
• EventBridge：事件总线服务
• Kinesis：流数据处理服务
• CloudWatch Metrics：指标监控服务
• SES：简单邮件服务
• Step Functions：工作流服务
• ECS：支持真实Docker容器的容器编排服务
• RDS：支持真实Postgres/MySQL容器的关系型数据库服务
• ElastiCache：支持真实Redis容器的缓存服务
• Glue：ETL服务
• Athena：支持DuckDB的SQL查询服务（可选）

轻量级与高性能

• 镜像大小约150MB
• 空闲时内存占用约30MB
• 启动时间约2秒

其他特性

• MIT许可，完全开源
• 无需账户注册和API密钥
• 无遥测数据收集
• 与AWS官方工具（如AWS CLI）无缝兼容

使用场景和适用范围

• 本地AWS应用开发与调试
• 单元测试和集成测试环境搭建
• CI/CD流水线中的AWS服务模拟
• 学习AWS服务操作，无需真实AWS账户
• 演示环境快速部署

使用方法和配置说明

快速启动

通过以下命令直接启动MiniStack容器：

bash
docker run -p 4566:4566 docker.xuanyuan.run/ministackorg/ministack

与AWS CLI配合使用

MiniStack可直接与AWS CLI配合使用，只需指定端点URL：

bash
# 创建S3存储桶
aws --endpoint-url=http://localhost:4566 s3 mb s3://my-bucket

# 列出DynamoDB表
aws --endpoint-url=http://localhost:4566 dynamodb list-tables

# 创建SQS队列
aws --endpoint-url=http://localhost:4566 sqs create-queue --queue-name my-queue

Docker Compose配置（包含Redis sidecar）

对于需要Redis支持的场景，可使用以下Docker Compose配置：

yaml
services:
  ministack:
    image: docker.xuanyuan.run/ministackorg/ministack
    ports:
      - "4566:4566"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock  # 用于支持ECS等需要Docker访问的服务
    environment:
      - REDIS_HOST=redis  # 指定Redis服务地址
  redis:
    image: docker.xuanyuan.run/redis:7-alpine
    ports:
      - "6379:6379"

更多信息

• GitHub仓库：https://github.com/ministackorg/ministack