LocalStack最新镜像连接失败咨询：GitLab-CI无法访问S3服务

LocalStack v2.x 核心变更点 #

• 网络绑定策略调整：从v2.x版本开始，LocalStack默认仅绑定127.0.0.1，不再像旧版本那样默认绑定0.0.0.0。这导致容器外部（比如GitLab-CI的runner环境）无法直接通过localhost:4566访问服务，除非显式配置对外绑定规则。
• 环境变量迭代：旧版的HOSTNAME_EXTERNAL作用被拆分优化，新版更推荐使用LOCALSTACK_HOSTNAME定义外部访问的主机名；同时新增BIND_ADDRESS变量，用于控制服务监听的网卡地址。
• 容器网络隔离强化：新版对容器内部网络的隔离更严格，跨容器访问时必须使用容器服务名而非localhost（如果GitLab-CI runner和LocalStack同属一个Docker网络的话）。

调整后的配置方案 #

1. 更新docker-compose.yml配置 #

修改LocalStack服务的环境变量，确保对外开放端口并正确配置主机参数：

localstack:
    container_name: config-localstack
    image: localstack/localstack:latest
    ports:
      - '4566-4599:4566-4599'
    environment:
      SERVICES: s3
      DEFAULT_REGION: 'eu-central-1'
      DATA_DIR: /tmp/localstack/data
      LOCALSTACK_HOSTNAME: localhost
      BIND_ADDRESS: 0.0.0.0  # 关键配置：让服务监听所有网卡地址，允许外部访问
      HOSTNAME: localstack

2. 修正GitLab-CI执行命令 #

如果GitLab-CI runner是容器化运行且和LocalStack处于同一个Docker网络，必须用容器服务名替代localhost（因为runner容器内的localhost指向自身，而非LocalStack容器）：

aws s3api head-bucket --bucket test-bucket --endpoint http://localstack:4566 && echo "Success"

若runner是直接在宿主机上执行（非容器化runner），则可以保持http://localhost:4566，但需确认宿主机能正常访问LocalStack容器的端口。

3. 额外验证步骤 #

• 启动容器后，在宿主机执行curl http://localhost:4566/health，确认返回健康状态，验证端口是否正常对外开放。
• 检查GitLab-CI的runner网络配置，确保其能访问到LocalStack容器所在的网络（若使用Docker runner，需配置与LocalStack同网络）。

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