Docker第1天：安装+加速配置整理

Windows/macOS/Ubuntu/Debian/CentOS Docker安装教程+加速配置

• • 前言
  • [一、Docker Desktop 桌面一体化容器工具详解](#一、Docker Desktop 桌面一体化容器工具详解)
  • • [1.1 Docker Desktop 组成与底层运行原理](#1.1 Docker Desktop 组成与底层运行原理)
    • [1.2 软硬件强制前置要求](#1.2 软硬件强制前置要求)
    • [1.3 Windows 完整安装流程](#1.3 Windows 完整安装流程)
    • • [方案1 Win10/Win11 WSL2 标准安装（推荐）](#方案1 Win10/Win11 WSL2 标准安装（推荐）)
      • [方案2 Win7/Win8 Docker Toolbox 兼容方案](#方案2 Win7/Win8 Docker Toolbox 兼容方案)
    • [1.4 macOS 两套安装方式](#1.4 macOS 两套安装方式)
    • • [方式一 官方 DMG 图形化安装（新手首选）](#方式一 官方 DMG 图形化安装（新手首选）)
      • [方式二 Homebrew 命令行安装（开发人员常用）](#方式二 Homebrew 命令行安装（开发人员常用）)
    • [1.5 Docker Desktop 可视化面板全功能说明](#1.5 Docker Desktop 可视化面板全功能说明)
    • [1.6 通俗概念辅助理解](#1.6 通俗概念辅助理解)
  • [二、Linux 服务器 Docker Engine 全发行版安装详解](#二、Linux 服务器 Docker Engine 全发行版安装详解)
  • • 两种安装方案优劣对比
    • [2.1 Ubuntu 系统完整安装流程](#2.1 Ubuntu 系统完整安装流程)
    • • 一键脚本快速部署
      • [APT 国内源标准化生产安装](#APT 国内源标准化生产安装)
    • [2.2 Debian 系统完整安装流程](#2.2 Debian 系统完整安装流程)
    • • 一键脚本部署
      • [APT 源标准化安装](#APT 源标准化安装)
    • [2.3 CentOS 系统完整安装流程](#2.3 CentOS 系统完整安装流程)
    • [2.4 Linux 全发行版通用后置优化操作（必执行）](#2.4 Linux 全发行版通用后置优化操作（必执行）)
    • • 环境验证
      • 普通用户免sudo权限（高频优化）
      • [Docker 完整卸载（彻底清理所有数据）](#Docker 完整卸载（彻底清理所有数据）)
  • [三、全平台 Docker 镜像加速配置详解](#三、全平台 Docker 镜像加速配置详解)
  • • [3.1 配置镜像加速核心背景](#3.1 配置镜像加速核心背景)
    • [3.2 可用免费公共镜像地址](#3.2 可用免费公共镜像地址)
    • [3.3 Linux 服务器配置步骤（Ubuntu/Debian/CentOS通用）](#3.3 Linux 服务器配置步骤（Ubuntu/Debian/CentOS通用）)
    • [3.4 Windows/macOS Docker Desktop 图形化配置步骤](#3.4 Windows/macOS Docker Desktop 图形化配置步骤)
    • [3.5 校验镜像加速是否配置成功](#3.5 校验镜像加速是否配置成功)
  • 四、不同场景安装方案选型建议
  • 五、总结

Docker安装教程+加速配置)

前言

Docker 底层依赖 Linux 内核 Namespace、Cgroups 实现容器隔离，Windows、macOS 系统本身不具备原生 Linux 运行环境，因此本地开发需要借助 Docker Desktop 内置虚拟化层间接运行容器；而 Ubuntu、Debian、CentOS 这类 Linux 发行版自带 Linux 内核，可直接安装原生 Docker Engine 服务用于线上服务器部署。

国内直连 Docker Hub 镜像仓库网络延迟极高，拉取镜像极易出现超时、卡死、下载失败问题，因此无论本地 PC 还是云服务器，安装完成后都必须配置国内镜像加速。本文整合 Docker Desktop、Windows、macOS、Ubuntu、Debian、CentOS 安装、镜像加速7份教程内容，从底层原理、软硬件前置条件、多套安装方案、安装后优化、卸载流程、排错细节全方位展开，覆盖个人开发、企业生产两套落地标准。

一、Docker Desktop 桌面一体化容器工具详解

1.1 Docker Desktop 组成与底层运行原理

Docker Desktop 是 Docker 官方面向 Windows、macOS、Linux 桌面端推出的一体化开发套件，完整包含四大核心组件：轻量级 Linux 虚拟机、Docker Engine 容器引擎、可视化图形管理界面、可一键启用的本地 Kubernetes 集群，专门解决非 Linux 系统无法原生运行 Linux 容器的痛点。

不同操作系统底层虚拟化实现方案存在差异：

1. Windows 平台：提供两套虚拟化后端，优先推荐 WSL2（Windows Subsystem for Linux 2），兼容性、文件读写性能远优于传统 Hyper-V；老旧系统无 WSL2 支持时自动切换 Hyper-V 虚拟机层；
2. macOS 平台：采用 HyperKit 轻量化虚拟化工具，创建独立微型 Linux 虚拟机承载 Docker Engine；Intel 芯片、Apple Silicon M1/M2/M3 全架构适配；
3. Linux 桌面系统：依托系统自带 KVM 虚拟化模块，资源占用最低。
   所有镜像、容器、数据卷实际存储在内置虚拟机内部，本地主机文件、端口通过双向映射实现互通，Windows 挂载本地项目目录时会存在一定性能损耗，根源在于 WSL2/虚拟层文件转发开销。

1.2 软硬件强制前置要求

1. 内存：最低 4GB，同时运行数据库、中间件、多个微服务场景建议 8GB 及以上；内存不足会出现容器启动卡死、GUI 卡顿、K8s 无法启用；
2. BIOS/UEFI 硬件虚拟化：必须开启 VT-x（Intel CPU）/AMD-V（AMD CPU），未开启虚拟化时 Docker Desktop 直接安装失败、启动报错；
3. Windows 系统版本区分：
   • Win10 2004 及以上专业/企业/教育版、Win11 全版本：支持新版 Docker Desktop + WSL2；家庭版部分功能受限；
   • Win7、Win8 老旧系统：不支持 WSL2、Hyper-V 功能残缺，只能使用淘汰的 Docker Toolbox，底层基于 VirtualBox 虚拟机，无图形管理界面，仅通过专用终端执行 docker 命令；
4. macOS：macOS Sierra 10.12 及以上所有机型，区分 Intel x86_64、Apple arm64 两套安装包，下载时需匹配本机芯片架构。

1.3 Windows 完整安装流程

方案1 Win10/Win11 WSL2 标准安装（推荐）

1. 管理员身份打开 PowerShell，启用系统虚拟化组件：

wsl --install
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

2. 重启电脑后，安装微软官方 WSL2 Linux 内核更新包；
3. 前往 Docker 官网下载对应 Windows 安装包，双击启动安装程序，务必勾选 Use WSL 2 instead of Hyper-V；
4. 安装完成后重启电脑，系统托盘出现鲸鱼 Docker 图标即为启动成功；
5. 打开 CMD/PowerShell 执行 docker version，客户端、服务端均正常输出版本号代表环境就绪。

方案2 Win7/Win8 Docker Toolbox 兼容方案

1. 下载 VirtualBox 虚拟机软件与 Docker Toolbox 一体安装包；
2. 安装后桌面生成 Docker QuickStart Terminal 快捷方式，仅能通过该终端操作 docker；
3. 内置 Linux 虚拟机 IP 固定，本地访问容器服务需要手动配置端口转发，不推荐新项目使用。

1.4 macOS 两套安装方式

方式一 官方 DMG 图形化安装（新手首选）

1. 官网区分 Intel、Apple Silicon 下载对应 DMG 镜像；
2. 打开镜像，将 Docker 程序拖拽至「应用程序」文件夹；
3. 启动程序，首次运行需要授予磁盘、网络权限；顶部菜单栏出现 Docker 鲸鱼图标代表运行成功。

方式二 Homebrew 命令行安装（开发人员常用）

brew install --cask docker

安装完成后在启动台打开 Docker 程序初始化引擎。

1.5 Docker Desktop 可视化面板全功能说明

软件内置五大核心管理面板，图形操作与命令行指令双向同步：

1. Containers（容器管理）：展示所有运行/停止容器，支持一键启停、重启、删除、查看实时日志、进入容器交互式终端、监控 CPU/内存/磁盘资源占用；
2. Images（镜像管理）：展示本地全部镜像，可拉取远程镜像、删除无用镜像、基于镜像启动容器、导出镜像文件；
3. Volumes（数据卷）：统一管理持久化存储卷，创建、删除、查看卷挂载信息，解决容器删除数据丢失问题；
4. Builds（构建记录）：缓存所有 docker build 镜像构建日志，方便排查 Dockerfile 构建报错；
5. Settings（全局设置）：分配虚拟机 CPU、内存、磁盘空间、配置国内镜像加速、一键开关本地 Kubernetes、配置代理、修改网络、文件挂载权限。

1.6 通俗概念辅助理解

镜像（Image）：只读的标准化模板，类比一份完整菜谱，包含系统、依赖、项目代码；

容器（Container）：镜像运行生成的独立实例，类比按照菜谱做出的菜品，一个镜像可创建多个隔离容器；

镜像仓库（Registry）：存放海量镜像的平台，Docker Hub 为官方公共仓库，Harbor 为企业私有仓库。

二、Linux 服务器 Docker Engine 全发行版安装详解

Linux 内核原生支持容器技术，服务器环境仅需安装轻量化 Docker Engine，无多余图形组件，资源开销极低。所有发行版统一提供两种安装方案，分别适配测试临时环境、企业生产环境。

两种安装方案优劣对比

1. 官方一键脚本方案
   执行一条命令自动完成源配置、依赖安装、Docker 全套组件部署；优点是部署速度快、零手动配置；缺点是强制安装最新版本，无法锁定固定稳定版本，无自定义源能力，企业生产环境禁止使用，仅适合个人测试、临时演示服务器。
2. 官方软件源手动安装方案
   手动清理旧版本、配置国内镜像软件源、导入安全密钥、按需指定安装版本；优点是版本可控、下载速度稳定、可统一运维批量管控，支持升级回滚，为线上生产环境标准方案。

2.1 Ubuntu 系统完整安装流程

支持 Ubuntu 16.04、18.04、20.04、22.04、24.04 全系列 LTS 长期支持版本，兼容 amd64、arm64、ppc64le 多硬件架构。

一键脚本快速部署

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
# 设置开机自启并立即启动服务
sudo systemctl enable --now docker

APT 国内源标准化生产安装

1. 卸载系统自带老旧冲突组件

sudo apt-get remove docker docker-engine docker.io containerd runc

2. 更新软件索引，安装 HTTPS 传输、密钥校验依赖

sudo apt update
sudo apt install apt-transport-https ca-certificates curl gnupg-agent software-properties-common

3. 导入中科大 Docker 源 GPG 安全密钥，校验软件合法性

curl -fsSL https://mirrors.ustc.edu.cn/docker-ce/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc

4. 写入系统 Docker 稳定软件源，自动适配本机系统版本与CPU架构

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://mirrors.ustc.edu.cn/docker-ce/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update

5. 安装完整 Docker 社区套件

# 安装当前最新稳定版
sudo apt install docker-ce docker-ce-cli containerd.io
# 如需锁定固定版本，先查询可用版本：apt-cache madison docker-ce
# 指定版本安装示例 sudo apt install docker-ce=5:26.0.2-1~ubuntu.22.04~jammy docker-ce-cli=5:26.0.2-1~ubuntu.22.04~jammy containerd.io

2.2 Debian 系统完整安装流程

适配 Debian 11 Bullseye、Debian 12 Bookworm 稳定发行版，安装逻辑与 Ubuntu 高度一致，清理旧组件命令覆盖更多冲突包，安装时自动附带 buildx、compose 扩展插件。

一键脚本部署

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo systemctl enable --now docker

APT 源标准化安装

1. 批量清理系统内所有Docker相关冲突软件

for pkg in docker.io docker-doc docker-compose podman-docker containerd runc; do sudo apt-get remove $pkg; done

2. 更新系统与基础依赖

sudo apt update && sudo apt upgrade
sudo apt install apt-transport-https ca-certificates curl software-properties-common

3. 添加官方GPG密钥并赋予读取权限

sudo curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

4. 配置Docker软件源并刷新索引

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update

5. 安装包含扩展插件的全套Docker组件

sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo systemctl enable --now docker

2.3 CentOS 系统完整安装流程

主流适配 CentOS 7、CentOS Stream 8、CentOS Stream 9，采用 dnf 包管理器，源配置完成后替换清华镜像地址加速下载。

1. 卸载系统内置旧版Docker全套组件

sudo dnf remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine

2. 安装源管理工具

sudo dnf -y install dnf-plugins-core

3. 添加官方源并替换国内镜像地址

sudo dnf config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sed -i 's+https://download.docker.com+https://mirrors.tuna.tsinghua.edu.cn/docker-ce+' /etc/yum.repos.d/docker-ce.repo

4. 安装Docker主程序与扩展插件

sudo dnf install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
# 开机自启并立即启动服务
sudo systemctl enable --now docker

2.4 Linux 全发行版通用后置优化操作（必执行）

环境验证

# 输出版本号校验客户端
docker --version
# 运行官方测试容器，验证引擎完整可用
sudo docker run hello-world

普通用户免sudo权限（高频优化）

默认 docker 操作需要 root 管理员权限，将当前登录用户加入 docker 用户组后，无需每次输入 sudo，注销重登或执行 newgrp docker 即时生效：

sudo usermod -aG docker $USER
newgrp docker

Docker 完整卸载（彻底清理所有数据）

仅卸载软件包不会删除本地镜像、容器、数据卷，如需完全清空环境执行以下命令：

# Ubuntu/Debian 卸载软件
sudo apt-get purge docker-ce docker-ce-cli containerd.io
# CentOS 卸载软件
sudo dnf remove docker-ce docker-ce-cli containerd.io
# 删除全部容器、镜像、持久化数据
sudo rm -rf /var/lib/docker

三、全平台 Docker 镜像加速配置详解

3.1 配置镜像加速核心背景

Docker Hub 境外服务器国内网络访问受限，直接拉取 Nginx、MySQL、Java 等镜像时，经常出现几十KB/s下载速度、连接超时、镜像拉取中断问题。国内各大云厂商、高校维护了免费公共镜像加速器，转发镜像缓存，大幅提升下载速度，所有使用 Docker 的环境都必须配置。

3.2 可用免费公共镜像地址

1. 中国科学技术大学：https://docker.mirrors.ustc.edu.cn
2. 网易镜像加速器：https://hub-mirror.c.163.com
3. 七牛云公共镜像：https://reg-mirror.qiniu.com
4. 阿里云专属加速器：登录阿里云控制台-容器镜像服务，生成个人专属镜像地址，带宽与稳定性最优。

3.3 Linux 服务器配置步骤（Ubuntu/Debian/CentOS通用）

Docker 镜像加速配置存储在 /etc/docker/daemon.json 守护进程配置文件中，文件默认不存在，需要手动创建写入镜像列表：

# 创建配置目录并写入镜像加速配置
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://docker.mirrors.ustc.edu.cn",
    "https://reg-mirror.qiniu.com"
  ]
}
EOF
# 重载系统服务配置，重启Docker引擎生效
sudo systemctl daemon-reload
sudo systemctl restart docker

3.4 Windows/macOS Docker Desktop 图形化配置步骤

1. 点击系统托盘（Windows）/顶部菜单栏（macOS）Docker 鲸鱼图标；
2. 选择 Settings / Preferences 进入全局设置；
3. 左侧菜单栏切换至 Docker Engine；
4. 在右侧 JSON 配置的 registry-mirrors 数组中填入国内镜像地址；
5. 点击 Apply & Restart，软件自动重启 Docker 引擎，配置即时生效。

3.5 校验镜像加速是否配置成功

终端执行如下命令，输出信息中存在 Registry Mirrors 字段，且显示刚才填写的国内镜像地址，代表配置正常：

docker info

四、不同场景安装方案选型建议

1. 本地个人开发（Windows/macOS）：优先 Docker Desktop，可视化界面降低操作门槛，支持一键启动本地K8s集群调试云原生项目；老旧Win7/8系统选用Docker Toolbox作为兼容方案。
2. 线上生产云服务器（Ubuntu/Debian/CentOS）：统一采用官方软件源手动安装方案，锁定稳定版本、使用国内软件源，便于批量运维、版本管控、故障回滚。
3. 临时测试演示服务器：可使用一键脚本快速部署，节省手动配置时间，测试完成后可完整卸载清理。
4. 通用强制优化项：无论本地PC还是线上服务器，Docker安装完毕后第一时间配置国内镜像加速器，规避镜像下载慢、超时故障。

五、总结

Docker Desktop 专为本地开发设计，可视化管理简化容器操作；

Linux Docker Engine 轻量化无冗余组件，适配线上业务长期稳定运行；

镜像加速是国内使用Docker不可或缺的基础优化。