nahuelnucera/ministack

MiniStack 镜像文档

镜像概述

MiniStack是一个免费开源的LocalStack替代品，旨在本地环境中模拟AWS服务。它支持20种AWS服务，通过单一端口提供服务，无需账户、API密钥，无遥测功能，采用MIT许可协议。相比LocalStack，MiniStack保持了开源免费的特性，适合本地开发和测试场景。

核心功能与特性

• 多AWS服务支持：覆盖20种常用AWS服务，包括S3、SQS、DynamoDB、Lambda等
• 真实执行环境：支持真实Python Lambda执行、ECS真实Docker容器、RDS真实Postgres/MySQL容器、ElastiCache真实Redis容器
• 零依赖配置：无需注册账户，无需API密钥，开箱即用
• 轻量级设计：约150MB镜像大小，空闲时仅占用约30MB内存，启动时间约2秒
• 兼容性强：原生支持所有AWS工具（如AWS CLI），无需额外适配

支持的服务

• 对象存储：S3
• 消息队列：SQS、SNS
• 数据库：DynamoDB、RDS（Postgres/MySQL）、ElastiCache（Redis）
• 计算：Lambda（真实Python执行）、ECS（真实Docker容器）
• 身份与访问管理：IAM、STS
• 监控与日志：CloudWatch Logs、CloudWatch Metrics
• 其他服务：Secrets Manager、SSM Parameter Store、EventBridge、Kinesis、SES、Step Functions、Glue、Athena（可选通过DuckDB提供真实SQL支持）

使用场景

• 本地AWS应用开发与调试
• CI/CD流程中的AWS服务模拟测试
• 无需真实AWS账户的功能验证
• 学习AWS服务的本地实验环境

使用方法

Docker Run 部署

通过以下命令快速启动MiniStack：

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

与AWS工具配合使用

启动后，可直接使用AWS CLI与MiniStack交互：

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侧车）

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

yaml
services:
  ministack:
    image: docker.xuanyuan.run/nahuelnucera/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"

启动命令：

bash
docker-compose up -d

参考链接

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