部署Node.js应用至AWS Elastic Beanstalk遇Docker镜像拉取失败求助

以下是针对你遇到的docker-compose pull失败问题的排查和解决步骤：

• 验证Docker Hub凭证配置

  1. 确认S3中的config.json里的认证令牌未过期，建议使用Docker Hub的**个人访问令牌（PAT）**替代密码，避免密码过期或特殊字符引发的问题。
  2. 通过EB扩展文件（.ebextensions/docker_auth.config）确保凭证文件被放置在正确路径并设置正确权限：

     files:
       /home/ec2-user/.docker/config.json:
         mode: "000600"
         owner: ec2-user
         group: ec2-user
         source: https://your-s3-bucket.s3.amazonaws.com/config.json
     

     权限必须设为600，否则Docker会拒绝加载该凭证文件。

• 检查docker-compose.yml配置

  1. 确保镜像名称是完整格式：[Docker Hub用户名]/[镜像名]:[标签]，不要省略用户名，否则Docker会尝试拉取官方镜像，可能导致权限或存在性问题。
  2. 本地测试时清理镜像缓存，执行docker-compose pull确认无依赖本地缓存的情况。

• 对齐Docker Compose版本
  本地使用的Docker Compose版本可能与EB环境预装版本不一致（比如本地用v2，EB用v1），语法差异可能导致拉取失败。可以通过扩展文件指定安装对应版本：

  commands:
    01_install_docker_compose:
      command: |
        curl -L "https://github.com/docker/compose/releases/download/v2.20.3/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
        chmod +x /usr/local/bin/docker-compose
  

• 查看详细错误日志
  登录EB对应的EC2实例，手动执行docker-compose pull，查看具体错误输出（比如认证失败、镜像不存在、网络超时）。同时可以检查EB的引擎日志/var/log/eb-engine.log，获取更详细的部署报错信息。

• 检查网络连通性

  1. 确认EC2实例所在安全组允许出站访问443端口（Docker Hub使用HTTPS）。
  2. 如果是VPC环境，检查NAT网关是否正常工作，确保实例可以访问公网。

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