Docker构建中用Testcontainers遇环境错误，如何通过Socket或TCP解决？

一、构建阶段能否使用Docker Socket？ #

常规docker build流程默认无法直接挂载宿主机的/var/run/docker.sock到构建阶段的临时容器，但可以通过Docker BuildKit实现挂载，这是最安全且推荐的方案：

1. 使用BuildKit挂载Socket（推荐） #

修改Dockerfile并启用BuildKit，让Testcontainers通过挂载的Socket访问宿主机Docker：

# syntax=docker/dockerfile:1.4
FROM amazoncorretto:17-alpine as builder
# 挂载宿主机Docker Socket到构建容器内
RUN --mount=type=bind,source=/var/run/docker.sock,target=/var/run/docker.sock \
    ./gradlew build

FROM amazoncorretto:17-alpine
COPY --from=builder build/libs/*.jar app.jar
ENTRYPOINT ["java","-jar","/app.jar"]

执行构建时需开启BuildKit：

DOCKER_BUILDKIT=1 docker build .

2. 宿主机预构建后复制产物（更简单） #

放弃在镜像构建阶段运行测试，先在宿主机/CI机器完成构建和测试，再将产物复制到镜像：
修改Dockerfile：

FROM amazoncorretto:17-alpine
COPY build/libs/*.jar app.jar
ENTRYPOINT ["java","-jar","/app.jar"]

执行流程：

# 本地/CI先执行测试与构建
./gradlew build
# 再构建镜像
docker build .

二、配置宿主机Docker暴露TCP端口（不推荐，安全性低） #

如果无法使用Socket方案，可配置宿主机Docker监听TCP端口，但存在安全风险，仅限内部可信环境使用：

1. 修改Docker配置文件 #

编辑/etc/docker/daemon.json（无则新建）：

{
  "hosts": ["unix:///var/run/docker.sock", "tcp://0.0.0.0:2375"]
}

注意：必须保留unix:///var/run/docker.sock，否则本地docker命令会失效。

2. 重启Docker服务 #

sudo systemctl restart docker

3. 构建时传递环境变量 #

修改Dockerfile的builder阶段，添加环境变量参数：

FROM amazoncorretto:17-alpine as builder
ARG DOCKER_HOST
ENV DOCKER_HOST=$DOCKER_HOST
ADD . .
RUN ./gradlew build

FROM amazoncorretto:17-alpine
COPY --from=builder build/libs/*.jar app.jar
ENTRYPOINT ["java","-jar","/app.jar"]

构建时指定宿主机IP：

docker build --build-arg DOCKER_HOST=tcp://<宿主机IP>:2375 .

安全提醒：暴露无认证的TCP端口会让任何可访问该端口的机器控制你的Docker，生产环境绝对禁用；若必须使用TCP，建议开启TLS认证（配置复杂，不适合构建场景）。

三、docker:dind的适配方式 #

适合CI环境（如GitLab CI、GitHub Actions），通过Docker-in-Docker创建独立的Docker环境：

1. 启动dind容器：

docker run -d --name dind-service --privileged docker:20.10.14-dind

2. 获取dind容器IP：

DIND_IP=$(docker inspect -f '{{range .NetworkSettings.Networks}}{{.IPAddress}}{{end}}' dind-service)

3. 构建时传递DOCKER_HOST：

docker build --build-arg DOCKER_HOST=tcp://$DIND_IP:2375 .

该方案会在dind内运行测试容器，不影响宿主机，但需要特权模式，构建速度较慢。

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