装环境是新手学 Docker 的第一道坎。你可能在搜索引擎里看到过各种教程,有的让你装 Docker Toolbox(已经淘汰了),有的让你配虚拟机,还有的让你编译源码……越看越懵。别慌,本文手把手带你走完 Windows、Mac、Linux 三大平台的安装流程,附赠镜像加速器配置和常见问题排查,让你一次性把地基打好。

▲ 三大平台一条龙:不管你是 Windows、Mac 还是 Linux 用户,都能找到适合你的安装路线。


一、先搞清楚:Docker CE 和 Docker EE 有啥区别?

在安装之前,你得知道 Docker 有两个版本:

版本全称适用场景价格
Docker CECommunity Edition(社区版)个人学习、开发、中小项目免费
Docker EEEnterprise Edition(企业版)大型企业生产环境,需要官方支持付费(按年订阅)

咱们学 Docker,装 CE 就够了。 99% 的教程、博客、开源项目用的都是 CE,功能完全够用。EE 多出来的是企业级安全加固、官方技术支持这些"增值服务",等你进了大厂用到了再说。

一句话:个人开发者装 CE,企业用户看情况。


二、Windows 安装:WSL2 方式(推荐)

▲ Windows 上推荐的安装路线:装 WSL2 → 装 Docker Desktop → 关联 WSL 集成 → 验证运行。

2.1 为什么选 WSL2?

Windows 上装 Docker 有两种方式:

方式原理推荐度
WSL2(推荐)在 Windows 里跑一个轻量 Linux 内核⭐⭐⭐⭐⭐
Hyper-V用传统虚拟机跑完整 Linux⭐⭐(已不推荐)

WSL2(Windows Subsystem for Linux 2)是微软官方的"Linux 子系统",比传统虚拟机启动快、资源占用小,Docker 官方也推荐使用这种方式。

2.2 前置条件

  • Windows 10(版本 1903 及以上)或 Windows 11

  • 开启 WSL2 功能

  • CPU 支持虚拟化(BIOS 里开启 VT-x / AMD-V)

2.3 第一步:安装 WSL2

打开 PowerShell(管理员模式),执行:

wsl --install

这条命令会自动:

  1. 启用 WSL 功能

  2. 启用虚拟机平台

  3. 下载并安装 Linux 内核

  4. 默认安装 Ubuntu 发行版

安装完成后重启电脑。

重启后,Ubuntu 会自动启动,让你设置用户名和密码(这个密码后面 sudo 要用,记住它):

Enter new UNIX username: myuser
New password: ****
Retype new password: ****
passwd: password updated successfully
Installation successful!

验证 WSL2 版本:

wsl -l -v

输出类似:

  NAME      STATE           VERSION
* Ubuntu    Running         2

看到 VERSION 是 2 就说明 WSL2 装好了。如果显示 1,手动转换一下:

wsl --set-version Ubuntu 2

2.4 第二步:下载 Docker Desktop

去官网下载安装包:

👉 Docker Desktop: The #1 Containerization Tool for Developers | Docker

选择 Windows - AMD64 版本下载(大部分电脑都是这个架构)。

2.5 第三步:安装 Docker Desktop

  1. 双击下载的 Docker Desktop Installer.exe

  2. 勾选 Use WSL 2 instead of Hyper-V(关键!)

  3. 点击 OK 开始安装

  4. 安装完成后重启电脑

  5. 启动 Docker Desktop,同意协议

首次启动会看到 Docker Engine 正在启动的界面,等它跑完(通常 1-2 分钟),底部状态栏出现 绿色小鲸鱼图标 就说明启动成功了。

2.6 第四步:关联 WSL2

打开 Docker Desktop → Settings → Resources → WSL integration:

  • 打开 Enable integration with my default WSL distro

  • 打开你安装的 Ubuntu 后面的开关

点 Apply & Restart。

现在打开 WSL Ubuntu 终端,直接就能用 docker 命令了:

docker --version

输出:

Docker version 24.0.7, build afdd53b

三、Mac 安装:注意芯片区别

3.1 Intel 芯片 vs Apple Silicon(M1/M2/M3)

Mac 安装 Docker 很简单,但一定要选对芯片架构,否则装了也跑不起来:

芯片怎么看下载哪个
Intel点左上角 → 关于本机 → 看"处理器"Mac with Intel Chip
Apple Silicon(M1/M2/M3)点左上角 → 关于本机 → 看"芯片"Mac with Apple Chip

3.2 安装步骤

  1. 去官网下载安装包:👉 Docker Desktop: The #1 Containerization Tool for Developers | Docker

  2. 根据芯片选择对应版本下载

  3. 双击 .dmg 文件

  4. 把 Docker 图标拖到 Applications 文件夹

  5. 打开 Launchpad,点击 Docker 启动

  6. 首次启动会要求授权系统权限,点"允许"

等顶部菜单栏出现 鲸鱼图标 且不再转圈,就启动成功了。

3.3 验证安装

打开终端:

docker --version

输出:

Docker version 24.0.7, build afdd53b

四、Linux 安装:Docker Engine(命令行版)

Linux 是 Docker 的"原生家园",安装最直接。这里讲两个主流发行版:Ubuntu 和 CentOS。

4.1 Ubuntu 安装(apt 方式)

第一步:卸载旧版本(如果装过)
sudo apt-get remove docker docker-engine docker.io containerd runc

没装过的话会提示"找不到包",忽略即可。

第二步:安装依赖工具
sudo apt-get update
sudo apt-get install -y ca-certificates curl gnupg lsb-release
第三步:添加 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
sudo chmod a+r /etc/apt/keyrings/docker.gpg
第四步:添加 Docker 仓库
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
第五步:安装 Docker Engine
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
第六步:把当前用户加入 docker 组(免 sudo)
sudo usermod -aG docker $USER

这一步执行完要退出终端重新登录才生效。 不加这步的话,每次敲 docker 命令都得加 sudo,很烦。

4.2 CentOS 安装(yum 方式)

第一步:卸载旧版本
sudo yum remove docker docker-client docker-client-latest docker-common \
  docker-latest docker-latest-logrotate docker-logrotate docker-engine
第二步:安装依赖工具
sudo yum install -y yum-utils
第三步:添加 Docker 仓库
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
第四步:安装 Docker Engine
sudo yum install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
第五步:启动并设置开机自启
sudo systemctl start docker
sudo systemctl enable docker
第六步:免 sudo 配置
sudo usermod -aG docker $USER

同样,重新登录终端生效。


五、安装后验证:跑一下 hello-world

不管你是哪个平台,装完后都要跑这个"验证命令":

docker run hello-world

如果看到下面这段输出,恭喜你,Docker 装好了:

Hello from Docker!
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
 1. The Docker client contacted the Docker daemon.
 2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
    (amd64)
 3. The Docker daemon created a new container from that image which runs the
    executable that produces the output you are currently reading.
 4. The Docker daemon streamed that output to the Docker client, which sent it
    to your terminal.

To try something more ambitious, you can run an Ubuntu container with:
 $ docker run -it ubuntu bash

Share images, automate workflows, and more with a free Docker ID:
 https://hub.docker.com/

For more examples and ideas, visit:
 https://docs.docker.com/get-started/

这段话的意思是:Docker 客户端联系了 Docker 守护进程 → 从 Docker Hub 拉取了 hello-world 镜像 → 用这个镜像创建了一个容器 → 容器运行后输出这段文字。整个流程跑通了,说明安装没问题。


六、配置镜像加速器(国内必做)

Docker 默认从 Docker Hub(docker.io)拉取镜像,服务器在国外,国内下载经常慢到怀疑人生。配置一个国内镜像加速器,速度能提升 10 倍以上。

▲ 左边直连海外仓库跨洋传输慢,右边经国内镜像加速器就近拉取,速度大幅提升。

6.1 常用镜像加速地址

加速器地址说明
阿里云https://xxx.mirror.aliyuncs.com需要登录控制台获取专属地址(免费)
中科大https://docker.mirrors.ustc.edu.cn无需注册,直接用
网易https://hub-mirror.c.163.com无需注册,直接用
腾讯云https://mirror.ccs.tencentyun.com无需注册,直接用

推荐阿里云:去 阿里云容器镜像服务 登录后能看到你的专属加速地址,比公共地址稳定。

6.2 Docker Desktop 配置(Windows / Mac)

  1. 打开 Docker Desktop → Settings → Docker Engine

  2. 在 JSON 配置中添加 registry-mirrors 字段:

{
  "builder": {
    "gc": {
      "defaultKeepStorage": "20GB",
      "enabled": true
    }
  },
  "experimental": false,
  "registry-mirrors": [
    "https://xxx.mirror.aliyuncs.com",
    "https://docker.mirrors.ustc.edu.cn"
  ]
}
  1. 点 Apply & Restart

6.3 Linux 配置

创建或编辑 Docker 配置文件:

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://xxx.mirror.aliyuncs.com",
    "https://docker.mirrors.ustc.edu.cn"
  ]
}
EOF

重启 Docker 服务:

sudo systemctl daemon-reload
sudo systemctl restart docker

6.4 验证加速器是否生效

docker info

在输出中找到 Registry Mirrors 部分:

Registry Mirrors:
 https://xxx.mirror.aliyuncs.com/
 https://docker.mirrors.ustc.edu.cn/

看到这个就说明配置生效了。


七、两个常用命令:摸清你的 Docker 环境

7.1 docker version —— 看版本号

docker version

输出:

Client: Docker Engine - Community
 Version:           24.0.7
 API version:       1.43
 Go version:        go1.20.10
 Git commit:        afdd53b
 Built:             Thu Oct 26 09:07:41 2023
 OS/Arch:           linux/amd64
 Context:           default

Server: Docker Engine - Community
 containerd:
  Version:          1.6.24
  GitCommit:        61f9fd88f79f081d64d6fa3bb1a0dc71ec870523
 runc:
  Version:          1.1.9
  GitCommit:        v1.1.9-0-gccaecfc
 docker-init:
  Version:          0.19.0
  GitCommit:        de40ad0

关注两个版本号:

  • Client:docker 命令行客户端的版本

  • Server:Docker 守护进程(dockerd)的版本

两者版本号一致最好,不一致一般也不影响使用。

7.2 docker info —— 看全局信息

docker info

这条命令输出很多,挑几个重点看:

字段含义
Containers当前容器总数(运行中/暂停/停止)
Images本地已有的镜像数量
Server VersionDocker 引擎版本
Storage Driver存储驱动(一般是 overlay2)
Cgroup Driver资源管控驱动(cgroupfs 或 systemd)
Registry Mirrors已配置的镜像加速器
Operating System宿主机操作系统
Total MemoryDocker 可用的总内存

小贴士:排查问题时,docker info 比 docker version 更有用,因为它能反映 Docker 的实际运行状态。


八、常见安装问题排查

问题 1:WSL2 未安装或版本不对

报错:WSL2 installation is incomplete

解决:

# PowerShell 管理员模式
wsl --install
wsl --set-default-version 2

安装完重启电脑。

问题 2:虚拟化未开启

报错:Hardware assisted virtualization and data execution protection must be enabled in the BIOS

解决:

  1. 重启电脑,进入 BIOS(开机按 F2 / DEL / ESC,不同电脑按键不同)

  2. 找到 Virtualization Technology(Intel 叫 VT-x,AMD 叫 AMD-V)

  3. 设置为 Enabled

  4. 保存退出

问题 3:Docker Desktop 启动后一直转圈

解决:

  1. 右键任务栏 Docker 图标 → Quit Docker Desktop

  2. 删除配置目录:%APPDATA%\Docker(Windows)或 ~/.docker(Mac)

  3. 重新启动 Docker Desktop

问题 4:Linux 下 docker 命令需要 sudo

解决:

sudo usermod -aG docker $USER
# 然后退出终端,重新登录

问题 5:拉取镜像超时

报错:net/http: TLS handshake timeout

解决:配置镜像加速器(见第六节),或者使用代理。


九、本文要点回顾

要点核心内容
CE vs EE个人用 CE(免费),企业看情况选 EE(付费)
Windows先装 WSL2,再装 Docker Desktop,开启 WSL integration
Mac注意区分 Intel 和 Apple Silicon 芯片,下载对应版本
LinuxUbuntu 用 apt,CentOS 用 yum,记得加 docker 组免 sudo
验证安装docker run hello-world,看到欢迎信息就说明 OK
镜像加速国内必配,推荐阿里云专属地址
查看环境docker version 看版本,docker info 看全局信息

装好 Docker 只是第一步,下一篇文章咱们正式认识 Docker 的三大核心概念:镜像、容器、仓库。 搞懂它们之间的关系,才算真正入门。


参考资料

更多推荐