LocalStack容器启动后以退出码0终止，为何无法正常运行？

退出码0表示进程正常执行后退出，而非异常崩溃。针对你遇到的LocalStack启动后立刻退出的问题，可从以下几个方向排查解决：

1. 指定稳定镜像版本 #

最新版LocalStack可能存在兼容性问题，建议锁定一个经过验证的稳定版本，比如2.3.2：

image: localstack/localstack:2.3.2

2. 调整环境变量与持久化配置 #

添加PERSISTENCE=1开启数据持久化，该配置会让LocalStack启动后保持运行状态，而非完成初始化就退出：

environment:
  - SERVICES=s3,iam
  - DEBUG=1
  - PERSISTENCE=1

3. 解决Docker Socket权限问题 #

挂载/var/run/docker.sock时，容器内进程可能因权限不足无法访问，导致服务启动失败后退出。可添加用户身份配置，让容器以当前主机用户身份运行：

user: "${UID}:${GID}"

同时，建议新增LocalStack数据卷挂载，避免权限冲突并持久化数据：

volumes:
  - /var/run/docker.sock:/var/run/docker.sock
  - localstack_data:/var/lib/localstack

# 在compose文件末尾添加数据卷定义
volumes:
  localstack_data:

4. 临时移除Docker Socket挂载测试 #

如果不需要LocalStack内部启动其他容器，可先移除/var/run/docker.sock的挂载，验证服务是否能正常运行：

volumes:
  # 注释或删除该行：- /var/run/docker.sock:/var/run/docker.sock

修改后的完整docker-compose配置示例：

localstack:
  image: localstack/localstack:2.3.2
  environment:
    - SERVICES=s3,iam
    - DEBUG=1
    - PERSISTENCE=1
  ports:
    - "4566:4566"
  volumes:
    - /var/run/docker.sock:/var/run/docker.sock
    - localstack_data:/var/lib/localstack
  networks:
    - backend-network
  user: "${UID}:${GID}"

volumes:
  localstack_data:

networks:
  backend-network:
    external: true  # 若你的backend-network已提前创建，需添加该行；否则可移除

内容的提问来源于stack exchange，提问作者Enow Sinke