thelab/dind

Docker-in-Docker 镜像文档

一、镜像概述和主要用途

本镜像是基于 ubuntu:16.04 构建的 Docker-in-Docker（DinD）专用镜像，预安装了 Docker 引擎、docker-compose 和 Git 工具。其核心用途是在容器内部提供完整的 Docker 运行环境，允许用户在隔离的容器中构建、运行和管理其他容器，即实现“Docker-in-Docker”模式。适用于需要在隔离环境中进行容器化应用开发、测试或部署的场景。

二、核心功能和特性

1. 预安装关键组件

• Docker 引擎：提供容器创建、运行、管理的核心能力，支持标准 Docker 命令操作。
• docker-compose：简化多容器应用的编排与管理，支持通过 YAML 文件定义多容器服务关系。
• Git：集成版本控制系统，方便拉取代码仓库、管理项目版本。

2. 基础环境

• 基于 ubuntu:16.04 操作系统，提供稳定的运行基础。

3. DinD 支持

• 支持 Docker-in-Docker 模式，允许在容器内部启动 Docker 守护进程（daemon），实现容器内嵌套容器的运行能力。

三、使用场景和适用范围

1. CI/CD 流水线

• 在持续集成/持续部署流程中，作为隔离的构建环境，用于构建、测试容器化应用，避免对宿主机 Docker 环境的依赖和污染。

2. 隔离开发环境

• 为开发人员提供包含 Docker 工具链的隔离开发环境，快速搭建一致的容器化开发环境，无需在本地直接安装 Docker。

3. 教学与演示

• 用于演示 Docker-in-Docker 概念，或教学中展示容器嵌套运行、多容器应用编排等场景。

四、使用方法和配置说明

1. 基本运行命令

Docker-in-Docker 运行需启用特权模式（--privileged）以支持容器内 Docker 守护进程正常工作。基础命令格式如下：

bash
docker run -it --privileged \
  -p <宿主机端口>:<容器端口> \  # 可选，如需外部访问容器内 Docker 服务
  -v <宿主机目录>:/var/lib/docker \  # 可选，持久化容器内 Docker 数据
  <镜像名称> \
  bash  # 进入交互式终端

示例：
运行镜像并进入交互式终端，持久化容器内 Docker 数据到宿主机 ./dind-data 目录：

bash
docker run -it --privileged \
  -v $(pwd)/dind-data:/var/lib/docker \
  docker.xuanyuan.run/docker-in-docker \
  bash

2. 容器内基本操作

进入容器后，可直接使用 Docker 相关命令：

（1）检查 Docker 环境

bash
# 检查 Docker 引擎版本
docker --version

# 检查 docker-compose 版本
docker-compose --version

# 检查 Git 版本
git --version

（2）运行测试容器

在容器内启动一个 Nginx 测试容器：

bash
docker run -d -p 8080:80 docker.xuanyuan.run/nginx:alpine

（3）使用 docker-compose 编排多容器应用

创建 docker-compose.yml 文件（示例为启动 Nginx 和 Redis）：

yaml
version: '3'
services:
  web:
    image: docker.xuanyuan.run/nginx:alpine
    ports:
      - "8080:80"
  db:
    image: docker.xuanyuan.run/redis:alpine

运行编排应用：

bash
docker-compose up -d

3. 环境变量与配置

（1）环境变量

• DOCKER_HOST：默认无需设置，容器内 Docker 守护进程监听本地 Unix 套接字（unix:///var/run/docker.sock）。
• 代理配置：如需通过代理访问外部镜像仓库，可设置 HTTP_PROXY、HTTPS_PROXY、NO_PROXY 环境变量，例如：

  bash
  docker run -it --privileged \
    -e HTTP_PROXY=http://proxy.example.com:8080 \
    docker.xuanyuan.run/docker-in-docker \
    bash
  

（2）Docker 守护进程配置

如需自定义容器内 Docker 守护进程参数（如镜像仓库镜像、存储驱动等），可通过挂载配置文件实现：
将宿主机的 daemon.json（Docker 守护进程配置文件）挂载到容器内 /etc/docker/daemon.json：

bash
docker run -it --privileged \
  -v $(pwd)/daemon.json:/etc/docker/daemon.json \
  docker.xuanyuan.run/docker-in-docker \
  bash

4. 数据持久化

容器内 Docker 数据默认存储在 /var/lib/docker，重启容器后数据会丢失。如需持久化，需通过 -v 参数将该目录挂载到宿主机，如上文“基本运行命令”示例。

五、注意事项

1. 安全风险：--privileged 模式会赋予容器几乎与宿主机同等的权限，存在安全隐患，仅在可信环境中使用。
2. 基础镜像支持：ubuntu:16.04 已停止官方支持（EOL），可能存在未修复的安全漏洞，生产环境使用前需评估安全风险。
3. 性能影响：Docker-in-Docker 模式可能引入额外性能开销，不建议用于高并发生产环境。

六、docker-compose 部署示例

如需通过 docker-compose 管理 DinD 服务，可创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  dind:
    image: docker.xuanyuan.run/docker-in-docker
    privileged: true
    volumes:
      - ./dind-data:/var/lib/docker  # 持久化 Docker 数据
    ports:
      - "2375:2375"  # 暴露 Docker 守护进程 TCP 端口（仅测试用，生产环境禁止暴露）
    tty: true  # 保持容器运行

启动服务：

bash
docker-compose up -d

进入容器：

bash
docker-compose exec dind bash