Laradock 中的 Docker in Docker(DinD):在容器内构建与运行容器,为自托管 CI Runner 赋能
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
几个关键前提:
- 网络一致:Runner 容器必须与 dind 处于同一个
backend网络,否则无法解析docker-in-docker主机名; - 端口匹配:
2375即 compose 中expose声明的端口; - 代码可用:
${APP_CODE_PATH_HOST}目录被挂载到容器内的${APP_CODE_PATH_CONTAINER}(默认/var/www),构建时可以直接引用项目代码; - 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 构建环境。