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

▲ 三大平台一条龙:不管你是 Windows、Mac 还是 Linux 用户,都能找到适合你的安装路线。
一、先搞清楚:Docker CE 和 Docker EE 有啥区别?
在安装之前,你得知道 Docker 有两个版本:
| 版本 | 全称 | 适用场景 | 价格 |
|---|---|---|---|
| Docker CE | Community Edition(社区版) | 个人学习、开发、中小项目 | 免费 |
| Docker EE | Enterprise 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
这条命令会自动:
-
启用 WSL 功能
-
启用虚拟机平台
-
下载并安装 Linux 内核
-
默认安装 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
-
双击下载的
Docker Desktop Installer.exe -
勾选 Use WSL 2 instead of Hyper-V(关键!)
-
点击 OK 开始安装
-
安装完成后重启电脑
-
启动 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 安装步骤
-
去官网下载安装包:👉 Docker Desktop: The #1 Containerization Tool for Developers | Docker
-
根据芯片选择对应版本下载
-
双击
.dmg文件 -
把 Docker 图标拖到 Applications 文件夹
-
打开 Launchpad,点击 Docker 启动
-
首次启动会要求授权系统权限,点"允许"
等顶部菜单栏出现 鲸鱼图标 且不再转圈,就启动成功了。
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)
-
打开 Docker Desktop → Settings → Docker Engine
-
在 JSON 配置中添加
registry-mirrors字段:
{
"builder": {
"gc": {
"defaultKeepStorage": "20GB",
"enabled": true
}
},
"experimental": false,
"registry-mirrors": [
"https://xxx.mirror.aliyuncs.com",
"https://docker.mirrors.ustc.edu.cn"
]
}
-
点 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 Version | Docker 引擎版本 |
Storage Driver | 存储驱动(一般是 overlay2) |
Cgroup Driver | 资源管控驱动(cgroupfs 或 systemd) |
Registry Mirrors | 已配置的镜像加速器 |
Operating System | 宿主机操作系统 |
Total Memory | Docker 可用的总内存 |
小贴士:排查问题时,
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
解决:
-
重启电脑,进入 BIOS(开机按 F2 / DEL / ESC,不同电脑按键不同)
-
找到 Virtualization Technology(Intel 叫 VT-x,AMD 叫 AMD-V)
-
设置为 Enabled
-
保存退出
问题 3:Docker Desktop 启动后一直转圈
解决:
-
右键任务栏 Docker 图标 → Quit Docker Desktop
-
删除配置目录:
%APPDATA%\Docker(Windows)或~/.docker(Mac) -
重新启动 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 芯片,下载对应版本 |
| Linux | Ubuntu 用 apt,CentOS 用 yum,记得加 docker 组免 sudo |
| 验证安装 | docker run hello-world,看到欢迎信息就说明 OK |
| 镜像加速 | 国内必配,推荐阿里云专属地址 |
| 查看环境 | docker version 看版本,docker info 看全局信息 |
装好 Docker 只是第一步,下一篇文章咱们正式认识 Docker 的三大核心概念:镜像、容器、仓库。 搞懂它们之间的关系,才算真正入门。
参考资料
更多推荐

所有评论(0)