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 支持。
- 启用 WSL 2:以管理员身份打开 PowerShell,执行
wsl --install安装 Linux 内核更新包。 - 下载安装包:访问
https://docs.docker.com/desktop/install/windows-install/下载 Docker Desktop Installer。 - 安装:双击安装程序,勾选“Use WSL 2 instead of Hyper-V”(推荐),等待安装完成。
- 启动并验证:启动 Docker Desktop,在终端执行
docker version确认客户端与服务端版本。
关键配置:Docker Desktop 默认使用 WSL 2 后端,可在 Settings → Resources → WSL Integration 中指定与哪个 Linux 发行版集成。
2.4 macOS 安装 Docker Desktop
macOS 安装同样以 Docker Desktop 为主,支持 Intel 和 Apple Silicon 芯片。
- 下载:从 Docker Hub 下载对应芯片架构的 Docker Desktop for Mac。
- 安装:将 .dmg 文件中的 Docker.app 拖入 Applications 文件夹。
- 首次启动:打开 Docker.app,接受服务条款,等待 Docker Engine 启动(状态栏图标变为绿色)。
- 验证:终端执行
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 正常工作。
- 检查版本:
docker version显示客户端与服务端版本号。 - 运行测试容器:
docker run hello-world拉取并运行测试镜像,输出欢迎信息。 - 查看系统信息:
docker info显示容器数量、镜像数量、存储驱动、镜像加速器等关键信息。
常见问题排查:
- “Cannot connect to the Docker daemon”:检查 Docker 服务是否启动(Linux 执行
systemctl status docker)。 - “permission denied”:当前用户未加入 docker 用户组,执行
sudo usermod -aG docker $USER后重新登录。 - 镜像拉取超时:确认镜像加速器配置正确,或更换其他加速地址。
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) |
正常列出容器列表,无权限错误 |