frnkenstien/localstack

Localstack Docker镜像

镜像概述

Localstack Docker镜像为Localstack项目的Docker分支，提供本地AWS云服务模拟环境，支持docker-compose网络，使开发者能够在离线环境中开发、测试和调试AWS相关应用程序，无需依赖真实AWS账户和网络连接。

核心功能与特性

• 本地AWS服务模拟：完整模拟多种AWS核心服务（如S3、DynamoDB、Lambda、EC2等）
• docker-compose网络支持：优化支持多容器应用的docker-compose网络配置，，便于服务间通信
• 离线开发环境：无需连接真实AWS云服务，本地即可构建和测试云应用
• 轻量级部署：容器化设计，资源占用低，部署简单，支持快速启动和销毁

使用场景

• 云应用本地开发：在本地环境构建和调试AWS相关应用，加速开发周期
• 离线功能测试：无网络环境下验证应用功能和AWS服务交互逻辑
• CI/CD流程集成：作为自动化测试环境，在持续集成过程中验证代码兼容性
• AWS服务学习：安全、低成本地学习和实验AWS服务功能

使用方法与配置说明

基础运行命令（docker run）

bash
docker run -d \
  -p 4566:4566 \
  -p 4510-4559:4510-4559 \
  --name localstack \
  localstack/localstack

• -p 4566:4566：Localstack主API端口
• -p 4510-4559:4510-4559：各AWS服务专用端口范围

docker-compose配置示例

yaml
version: '3.8'
services:
  localstack:
    image: localstack/localstack
    container_name: localstack
    ports:
      - "4566:4566"  # 主API端口
      - "4510-4559:4510-4559"  # 服务端口范围
    environment:
      - SERVICES=s3,dynamodb,lambda  # 指定启用的AWS服务
      - DEBUG=1  # 启用调试日志
      - DATA_DIR=/tmp/localstack/data  # 数据持久化目录
      - DOCKER_HOST=unix:///var/run/docker.sock  # 支持docker-compose网络
    volumes:
      - localstack_data:/tmp/localstack/data
      - /var/run/docker.sock:/var/run/docker.sock

volumes:
  localstack_data:

关键环境变量配置

注意事项

• 首次启动时会下载所需服务依赖，可能需要几分钟时间
• 数据持久化需通过DATA_DIR和卷挂载实现，否则容器重启后数据将丢失
• 部分高级功能（如Kinesis、Redshift）可能需要Localstack Pro版本支持
• 服务端口映射需根据启用的具体AWS服务进行调整