Laradock 中的 Docker in Docker(DinD):在容器内构建与运行容器,为自托管 CI Runner 赋能

原创2026-09-22 16:30:571,620 阅读
文章标签:后端开发工具DevOps

Laradock 中的 Docker in Docker(DinD):在容器内构建与运行容器,为自托管 CI Runner 赋能

Docker in Docker(简称 dind)允许在一个容器内部运行完整的 Docker 守护进程,使该容器(或网络中指向它的其他容器)能够独立执行 docker build 与 docker run,而无需挂载宿主机的 Docker socket。Laradock 以官方 docker:29-dind 镜像原样封装了这一能力,是自托管 CI Runner(Jenkins、GitLab Runner 或自定义流水线)在隔离环境中安全构建镜像的标准做法。读完本文,你将掌握在 Laradock 中一键启动 dind 服务、从其他容器安全连接其守护进程、以及完整重置其构建缓存与数据的方法。

什么是 Docker in Docker

普通容器内没有 Docker 守护进程,想在 CI 流程中构建镜像,传统方案是把宿主机的 /var/run/docker.sock 挂载进容器,让容器内的 Docker CLI 直接驱动宿主机守护进程——这会带来权限放大与宿主机被污染的风险。Docker in Docker 的解法是:在容器内运行一个完整的 Docker daemon,让该容器自己拥有"宿主"能力,进而构建镜像、运行容器。

在 Laradock 中,这一能力由 docker-in-docker/compose.yml 定义的 docker-in-docker 服务提供。它直接使用官方 docker:29-dind 镜像,未做任何定制修改,也没有自定义 Dockerfile——从 docker-compose.yml 中对该服务的 include 声明可以看到,它甚至没有关联的 defaults.env 文件,这意味着该服务不存在任何 Laradock 专属的环境变量。

典型应用场景包括:

  • 自托管 CI Runner:让 Jenkins / GitLab Runner 容器通过 DOCKER_HOST 指向本守护进程,在流水线中执行 docker build / docker run;
  • 隔离构建环境:开发团队希望构建过程不接触宿主机 Docker,避免 socket 挂载带来的安全风险;
  • 手动测试镜像构建:在提交流水线之前,先在容器内验证 Dockerfile 是否可构建。

服务定义与配置解析

该服务没有任何 Laradock 专属环境变量(目录下没有 docker-in-docker/defaults.env 文件),所有配置都直接写在 docker-in-docker/compose.yml 中。完整内容如下:

services:

    docker-in-docker:
      restart: always
      image: docker:29-dind
      environment:
        DOCKER_TLS_SAN: DNS:docker-in-docker
      privileged: true
      volumes:
        - ${APP_CODE_PATH_HOST}:${APP_CODE_PATH_CONTAINER}
        - docker-in-docker:/certs/client
      expose:
        - 2375
      networks:
        - backend

各配置项的作用如下:

设置 值 作用
image docker:29-dind Docker in Docker 镜像及版本,即 29.x 系列的 dind 变体
DOCKER_TLS_SAN DNS:docker-in-docker 将容器名加入守护进程的 TLS 证书(Subject Alternative Name),使客户端能够以 docker-in-docker 这个名称通过 TLS 连接守护进程
privileged true dind 必需:只有特权模式才能让内部守护进程自行管理 cgroups 与网络栈
expose 2375 Docker 守护进程端口,仅暴露给同一 backend 网络内的其他容器,不会发布到宿主机端口
restart always 容器异常退出后自动拉起,保证守护进程长期可用
volumes ${APP_CODE_PATH_HOST}:${APP_CODE_PATH_CONTAINER} 将宿主机代码目录挂载进容器,构建时可直接访问项目代码
volumes docker-in-docker:/certs/client 命名卷,用于持久化 TLS 客户端证书,供网络内其他容器共享使用

与根 compose 文件的关联

该服务引用的两个资源都在根级 docker-compose.yml 中声明:

  • backend 网络:定义于根文件第 4-5 行,driver 由 .env 中的 NETWORKS_DRIVER 控制(默认 bridge)。dind 守护进程只在该网络内可达;
  • docker-in-docker 命名卷:定义于根文件第 11-12 行,driver 由 VOLUMES_DRIVER 控制(默认 local)。内部守护进程构建的所有镜像层与 /certs/client 下的 TLS 证书都保存在这个卷中。

涉及的 .env 变量

挂载代码目录用到的两个变量定义在 .env.example 中:

# Point to the path of your applications code on your host
APP_CODE_PATH_HOST=../

# Point to where the `APP_CODE_PATH_HOST` should be in the container
APP_CODE_PATH_CONTAINER=/var/www

默认情况下,宿主机的 Laradock 上级目录(../)会被挂载到容器内的 /var/www,你的项目代码因此在构建时始终可用。如需更换镜像版本,直接修改 docker-in-docker/compose.yml 中的 image: 一行(例如固定到其他 Docker 版本),然后重新执行启动命令,Compose 会拉取新标签并重建容器。

启动 Docker in Docker

启动该服务有两种等效方式:Laradock CLI 或原生 Docker Compose。

方式一:Laradock CLI

./laradock start docker-in-docker

方式二:Docker Compose

docker compose up -d docker-in-docker

从 laradock 的 CLI 分发逻辑可以看到,start/up 最终都会转化为 docker compose 命令执行(CLI 的设计契约是"无状态、不生成文件、每次打印真实执行的 compose 命令",因此底层仍是同一套 compose 行为)。容器以 privileged: true 运行(dind 管理自身 cgroups 与网络的必要条件),并通过 restart: always 保持常驻。

停止与移除

停止守护进程容器(停止后镜像与容器数据仍保留):

./laradock stop docker-in-docker
# 或
docker compose stop docker-in-docker

停止后,容器内构建的所有镜像与容器数据都保存在名为 docker-in-docker 的命名卷(挂载于 /certs/client)以及 Docker 内部存储中,两者在卷被删除前都会持续保留。

彻底删除容器(命名卷及其中的全部数据不受影响):

./laradock remove docker-in-docker
# 或
docker compose rm -sf docker-in-docker

在 CLI 中 remove/delete 就是 docker compose rm -sf 的语义封装(见 laradock),即停止并移除容器,但不会触碰命名卷。

在容器内直接运行 Docker 命令

这对于检查守护进程是否健康、或在接入 CI Runner 之前手动验证构建非常有用:

./laradock enter docker-in-docker
# 或
docker compose exec docker-in-docker sh

进入容器后,使用镜像自带的 Docker CLI 连接它自己的本地守护进程:

docker version
docker ps

执行 docker ps 时,你会看到 dind 容器自身以及它内部运行着的容器;docker version 则会同时显示客户端与服务端的版本,服务端部分即为容器内守护进程的版本。

从其他容器连接该守护进程

docker-in-docker 服务没有宿主机端口映射(只有 expose),因此无法从宿主机直接访问该守护进程,只能从同一 Laradock 网络内的其他容器访问。这是刻意设计的隔离边界:守护进程对宿主机完全不可见。

同一 backend 网络内的其他容器,只需将 Docker 客户端指向以下地址即可使用该守护进程:

export DOCKER_HOST=tcp://docker-in-docker:2375

几个关键前提:

  1. 网络一致:Runner 容器必须与 dind 处于同一个 backend 网络,否则无法解析 docker-in-docker 主机名;
  2. 端口匹配:2375 即 compose 中 expose 声明的端口;
  3. 代码可用:${APP_CODE_PATH_HOST} 目录被挂载到容器内的 ${APP_CODE_PATH_CONTAINER}(默认 /var/www),构建时可以直接引用项目代码;
  4. TLS 证书共享:客户端证书通过 docker-in-docker 命名卷在 /certs/client 目录共享,容器间可以通过该目录加载证书完成 TLS 握手。

重置:清空 dind 构建的一切

当需要回收磁盘空间,或希望内部守护进程从完全干净的状态重新开始时,需要同时删除容器与其命名卷,然后重新启动:

方式一:Laradock CLI

./laradock stop docker-in-docker
./laradock remove docker-in-docker
docker volume rm $(docker volume ls -q --filter name=docker-in-docker)
./laradock start docker-in-docker

方式二:Docker Compose

docker compose stop docker-in-docker
docker compose rm -sf docker-in-docker
docker volume rm $(docker volume ls -q --filter name=docker-in-docker)
docker compose up -d docker-in-docker

这会删除内部守护进程曾构建或拉取的全部镜像、容器、镜像层,以及其 TLS 客户端证书。与数据库不同,该容器不保存任何你的应用直接依赖的数据,因此重置前无需备份任何东西——这正是 dind 作为"无状态构建环境"的一大优势。

常见问题排查

  • CI Runner 容器连接失败。 确认 Runner 容器位于同一个 backend 网络,且 DOCKER_HOST 指向 tcp://docker-in-docker:2375,而不是 localhost。
  • 报错 Cannot connect to the Docker daemon。 dind 容器启动后,内部守护进程需要几秒钟完成初始化。稍等片刻,再用 ./laradock logs docker-in-docker 查看日志,确认守护进程是否已输出 "API listen on" 一行。
  • 构建失败,出现权限或 cgroup 错误。 dind 必须运行在 privileged: true 下,该配置已写在 docker-in-docker/compose.yml 中。如果自行定制过 compose 文件并移除了该选项,守护进程将无法正常工作。
  • 执行 docker compose down -v 后内部镜像消失。 -v 标志会删除命名卷,包括支撑本容器证书与镜像层的 docker-in-docker 卷。如需保留数据,应使用 ./laradock stop docker-in-docker 或不带 -v 的 docker compose down。

与 Docker Registry 搭配使用

dind 守护进程构建出的镜像需要一个推送目的地。Laradock 提供了配套的 Docker Registry 服务(见 docker-registry 服务文档),可以在内网自建镜像仓库,让 dind 构建的产物直接 docker push 到私有仓库中,形成完整的"构建 → 存储"闭环。若你刚接触 Laradock,建议先阅读 快速开始 了解整体配置模型(尤其是 APP_CODE_PATH_HOST 等 .env 变量的含义),再回来搭建你的 CI 构建环境。

登录后查看全文
laradock