使用npm testcontainers访问私有镜像仓库的认证配置问题

以下是几个无需将凭证明文存储在Git中的可行方案：

1. 传递Docker配置文件路径给Testcontainers #

GitHub Actions中执行docker login后，凭证会自动写入当前用户的~/.docker/config.json文件。你可以通过环境变量强制Testcontainers读取这个已包含有效凭证的配置文件：

• 先在CI步骤中完成私有仓库登录：

  - name: 登录私有镜像仓库
    run: docker login my-registry.com -u ${{ secrets.REGISTRY_USER }} -p ${{ secrets.REGISTRY_PASS }}
  

• 接着设置Testcontainers的环境变量，指定配置文件路径：

  - name: 运行集成测试
    env:
      TESTCONTAINERS_DOCKER_CONFIG_OVERRIDE: /home/runner/.docker/config.json
      # 若DinD以root用户运行，路径需改为/root/.docker/config.json，根据实际情况调整
    run: ./gradlew test # 替换为你的测试启动命令
  

该方案让Testcontainers直接复用已完成认证的Docker配置，无需额外处理凭证。

2. 直接通过Testcontainers环境变量注入凭证 #

Testcontainers支持通过专用环境变量传递私有仓库认证信息，无需依赖Docker配置文件：

• 在测试执行步骤中设置环境变量，用GitHub Secrets填充敏感信息：

  - name: 运行集成测试
    env:
      TESTCONTAINERS_REGISTRY_AUTH: "my-registry.com:${{ secrets.REGISTRY_USER }}:${{ secrets.REGISTRY_PASS }}"
      # 多仓库场景用逗号分隔：repo1.com:user:pass,repo2.com:user2:pass2
    run: ./gradlew test
  

不同语言的Testcontainers绑定可能有更针对性的配置方式（比如Java可使用-Ddocker.auth.config系统属性），但环境变量是跨语言通用的方案。

3. 确保Testcontainers连接到正确的DinD Docker Daemon #

若Testcontainers未连接到DinD的Docker守护进程，会导致无法复用已有的仓库凭证。你可以手动指定DinD的连接参数：

- name: 运行集成测试
  env:
    DOCKER_HOST: tcp://localhost:2376
    DOCKER_TLS_VERIFY: 1
    DOCKER_CERT_PATH: /certs/client
    # 同时添加上述任意一种凭证配置
  run: ./gradlew test

GitHub Actions的DinD服务通常默认暴露这些变量，但手动指定可避免因配置变动导致的连接异常，确保Testcontainers使用已完成认证的守护进程。

排查要点 #

• 在测试步骤前添加cat ~/.docker/config.json命令，确认凭证已正确写入配置文件
• 查看Testcontainers日志，确认拉取镜像时使用的Docker守护进程和配置路径
• 确保执行docker login和测试命令的用户一致（比如均为runner用户）

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