eoskin/localstack

本地AWS云栈镜像

镜像概述

本镜像提供一个功能完整的本地AWS云栈环境，允许开发者在无实际AWS账户和网络连接的情况下，离线开发、测试和调试云应用。通过模拟AWS核心服务，实现本地环境与云端环境的一致性，降低开发成本并加速迭代流程。

核心功能和特性

• 完全离线运行：无需连接AWS云服务，所有功能在本地环境独立运行
• AWS服务模拟：支持模拟多种AWS核心服务（如S3、EC2、Lambda、DynamoDB等）
• 数据持久化：支持本地数据存储，确保容器重启后数据不丢失
• API兼容性：提供与AWS API高度兼容的接口，最小化代码迁移成本
• 轻量级部署：容器化设计，资源占用低，部署配置简单

使用场景和适用范围

• 本地开发环境：云应用的本地开发与调试
• CI/CD测试流程：集成到自动化测试 pipeline，验证云功能
• AWS学习培训：学习AWS服务使用，无需实际云资源
• 演示环境：向客户或团队展示云应用功能，无需真实AWS环境

使用方法

Docker Run 基本示例

bash
docker run -d \
  -p 4566:4566 \  # 主API端口
  -v ./aws-local-data:/data \  # 数据持久化卷
  --name local-aws-stack \
  your-image-name:latest

Docker Compose 配置示例

创建 docker-compose.yml 文件：

yaml
version: '3.8'
services:
  local-aws:
    image: your-image-name:latest
    container_name: local-aws
    ports:
      - "4566:4566"  # 主API端口
      - "4571:4571"  # S3静态网站端口（可选）
    volumes:
      - ./aws-data:/data  # 数据持久化
    environment:
      - SERVICES=s3,lambda,dynamodb,ec2  # 指定启动的服务
      - DEFAULT_REGION=us-east-1         # 默认区域
      - DATA_DIR=/data                   # 数据存储路径
      - DEBUG=false                      # 调试模式开关
    restart: unless-stopped

配置参数说明

环境变量配置

常用端口映射

使用注意事项

• 本地模拟服务与AWS实际服务存在细微差异，生产环境需在真实AWS环境验证
• 数据持久化卷需确保有正确的读写权限，避免容器启动失败
• 部分高级AWS功能（如复杂IAM策略、跨区域复制）可能未完全支持，建议参考官方文档确认支持范围
• 启动多个服务时可能增加资源占用，建议根据需求选择必要服务