2. Docker安装与配置：Linux/Windows/Mac环境下的Docker Engine安装与镜像加速器配置

Docker Engine 是运行和管理容器的核心组件。本章将覆盖三大主流操作系统（Linux、Windows、macOS）下的安装流程，并重点配置镜像加速器以提升国内用户的拉取速度。正确的安装与配置是后续搭建连接池水位监控环境的基础。

2.1 环境准备与版本选择

在安装前，请确认操作系统满足最低要求。不同平台的依赖项与安装方式差异较大，下表列出了关键对比：

2.2 Linux 环境安装（以 Ubuntu 为例）

Linux 是 Docker 的原生运行平台，推荐使用包管理器安装。以下步骤适用于 Ubuntu 22.04 LTS：

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 docker run hello-world

2.3 Windows 环境安装

Windows 环境下推荐使用 Docker Desktop，它基于 WSL2（Windows Subsystem for Linux 2）后端运行，提供完整的 Docker 体验。

• 前置条件： 启用 WSL2 并安装 Linux 内核更新包。在 PowerShell（管理员）中执行：wsl --install -d Ubuntu。
• 下载安装： 访问 https://docs.docker.com/desktop/install/windows-install/ 下载 Docker Desktop Installer.exe，双击安装并勾选“Use WSL 2 instead of Hyper-V”。
• 启动验证： 安装完成后启动 Docker Desktop，在终端执行 docker version 确认客户端与引擎版本。

2.4 macOS 环境安装

macOS 用户同样使用 Docker Desktop，它原生支持 Intel 和 Apple Silicon 芯片。

• 下载： 从 Docker Hub 下载对应芯片架构的 Docker.dmg 安装包。
• 安装： 将 Docker 图标拖入 Applications 文件夹，首次启动时需授权并输入系统密码。
• 验证： 终端执行 docker --version 和 docker compose version 确认安装成功。

2.5 镜像加速器配置

由于网络原因，从 Docker Hub 拉取镜像可能较慢。配置镜像加速器可显著提升拉取速度。国内主流云服务商均提供免费加速服务。

以下为 Docker Engine 配置镜像加速器的通用步骤：

1. 编辑配置文件（Linux/macOS）：sudo vi /etc/docker/daemon.json。Windows 用户通过 Docker Desktop 设置界面配置。
2. 写入加速器地址（以阿里云为例，需替换为个人专属地址）：
   

   {
     "registry-mirrors": [
       "https://your-id.mirror.aliyuncs.com",
       "https://docker.mirrors.ustc.edu.cn"
     ]
   }

3. 重启 Docker 服务：
   
   • Linux：sudo systemctl daemon-reload && sudo systemctl restart docker
   • macOS：点击 Docker 菜单栏图标 → Restart
   • Windows：在 Docker Desktop 中点击 Troubleshoot → Restart
4. 验证配置：docker info | grep -A 1 "Registry Mirrors"，确认加速器地址已生效。

2.6 安装验证与基础测试

完成安装与加速器配置后，执行以下命令验证环境是否就绪：

# 查看 Docker 版本信息
docker version

# 查看系统级配置（含镜像加速器）
docker info

# 运行测试容器（拉取 hello-world 镜像并运行）
docker run hello-world

# 查看当前运行的容器
docker ps

# 查看所有容器（包括已停止的）
docker ps -a

如果 docker run hello-world 输出欢迎信息且无网络超时错误，说明安装与加速器配置均成功。

2.7 常见问题与排错