2. Docker安装与配置:在Linux/Windows/macOS上安装Docker Engine、配置镜像加速器

Docker Engine 是运行容器的基础设施层,支持 Linux、Windows 和 macOS 三大主流操作系统。不同平台的安装方式与底层虚拟化技术存在差异,但核心配置逻辑一致。本章将按平台分别说明安装步骤,并统一配置镜像加速器以提升国内镜像拉取速度。

2.1 平台支持与核心差异

平台 底层技术 安装方式 适用场景
Linux 直接使用 cgroups / namespaces 包管理器(apt/yum)或官方脚本 生产服务器、CI/CD 节点
Windows Hyper-V / WSL 2 后端 Docker Desktop 或 CLI 工具 本地开发、混合环境测试
macOS HyperKit / Apple Virtualization Docker Desktop 或 Colima 前端/后端本地开发
提示:Linux 是 Docker 的原生运行平台,性能最优;Windows 和 macOS 通过轻量级虚拟机运行 Docker Engine,适合开发环境,不建议用于生产。

2.2 Linux 安装 Docker Engine(以 Ubuntu 为例)

Linux 安装 Docker Engine 推荐使用官方 APT 仓库,确保获取最新稳定版本。

# 1. 卸载旧版本
sudo apt-get remove docker docker-engine docker.io containerd runc

# 2. 更新包索引并安装依赖
sudo apt-get update
sudo apt-get install ca-certificates curl gnupg lsb-release

# 3. 添加 Docker 官方 GPG 密钥
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# 4. 设置稳定版仓库
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 5. 安装 Docker Engine
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin

# 6. 启动并验证
sudo systemctl start docker
sudo docker run hello-world
注意:安装完成后,默认需要 sudo 权限运行 docker 命令。若希望非 root 用户直接使用,请执行 sudo usermod -aG docker $USER 并重新登录。

2.3 Windows 安装 Docker Desktop

Windows 环境推荐使用 Docker Desktop,它集成了 Docker Engine、Docker CLI、Docker Compose 和 Kubernetes 支持。

  1. 启用 WSL 2:以管理员身份打开 PowerShell,执行 wsl --install 安装 Linux 内核更新包。
  2. 下载安装包:访问 https://docs.docker.com/desktop/install/windows-install/ 下载 Docker Desktop Installer。
  3. 安装:双击安装程序,勾选“Use WSL 2 instead of Hyper-V”(推荐),等待安装完成。
  4. 启动并验证:启动 Docker Desktop,在终端执行 docker version 确认客户端与服务端版本。
关键配置:Docker Desktop 默认使用 WSL 2 后端,可在 Settings → Resources → WSL Integration 中指定与哪个 Linux 发行版集成。

2.4 macOS 安装 Docker Desktop

macOS 安装同样以 Docker Desktop 为主,支持 Intel 和 Apple Silicon 芯片。

  1. 下载:从 Docker Hub 下载对应芯片架构的 Docker Desktop for Mac。
  2. 安装:将 .dmg 文件中的 Docker.app 拖入 Applications 文件夹。
  3. 首次启动:打开 Docker.app,接受服务条款,等待 Docker Engine 启动(状态栏图标变为绿色)。
  4. 验证:终端执行 docker info 查看系统信息,确认运行正常。
提示:Apple Silicon 用户建议使用 Docker Desktop 4.3+ 版本,原生支持 ARM64 容器,性能优于 Rosetta 2 转译。

2.5 配置镜像加速器

国内访问 Docker Hub 镜像仓库速度较慢,配置镜像加速器可显著提升拉取效率。主流云服务商均提供免费加速服务。

加速器地址 提供方 适用区域
https://registry.cn-hangzhou.aliyuncs.com 阿里云 中国大陆
https://docker.mirrors.ustc.edu.cn 中科大 中国大陆
https://mirror.ccs.tencentyun.com 腾讯云 中国大陆
https://hub-mirror.c.163.com 网易 中国大陆

Linux 配置方法:编辑或创建 /etc/docker/daemon.json,写入以下内容后重启 Docker。

{
  "registry-mirrors": [
    "https://registry.cn-hangzhou.aliyuncs.com",
    "https://docker.mirrors.ustc.edu.cn"
  ]
}
sudo systemctl daemon-reload
sudo systemctl restart docker

Windows / macOS 配置方法:在 Docker Desktop 的 Settings → Docker Engine 中,编辑 JSON 配置,添加 registry-mirrors 数组,点击“Apply & Restart”。

验证加速器是否生效:执行 docker info,在输出中查找 Registry Mirrors: 字段,确认已列出配置的加速地址。

2.6 安装验证与基础测试

无论使用哪个平台,安装完成后都应执行以下验证步骤,确保 Docker Engine 正常工作。

  1. 检查版本:docker version 显示客户端与服务端版本号。
  2. 运行测试容器:docker run hello-world 拉取并运行测试镜像,输出欢迎信息。
  3. 查看系统信息:docker info 显示容器数量、镜像数量、存储驱动、镜像加速器等关键信息。
常见问题排查:
  • “Cannot connect to the Docker daemon”:检查 Docker 服务是否启动(Linux 执行 systemctl status docker)。
  • “permission denied”:当前用户未加入 docker 用户组,执行 sudo usermod -aG docker $USER 后重新登录。
  • 镜像拉取超时:确认镜像加速器配置正确,或更换其他加速地址。
Docker Engine 安装与配置流程 选择目标平台 Linux (apt/yum) Windows (Docker Desktop) macOS (Docker Desktop) 安装 Docker Engine 安装 Docker Desktop 安装 Docker Desktop 配置镜像加速器 (daemon.json) 验证:docker version / docker info Linux 无需额外虚拟机层

2.7 安装后检查清单

完成安装与加速器配置后,建议逐项核对以下清单,确保环境就绪。

检查项 验证命令 预期结果
Docker 服务运行中 systemctl status docker (Linux) active (running)
客户端与服务端版本 docker version Client 和 Server 均显示版本号
镜像加速器生效 docker info Registry Mirrors 列表包含配置地址
容器运行正常 docker run hello-world 输出 Hello from Docker! 信息
非 root 用户权限 docker ps (非 root) 正常列出容器列表,无权限错误