Windows 系统 docker 安装全指南

想在 Windows 上用 Docker 来部署应用、搭建开发环境，却不知道从何下手？别担心，这篇教程将手把手带你完成从安装到运行第一个容器的全过程。无论你是刚接触 Docker 的新手，还是有一定基础想系统梳理的用户，都能在这里找到清晰的指引。

一、安装前的准备与选择

在 Windows 上安装 Docker，主要看你的系统版本。Docker 官方为 Windows 提供了两种不同的“引擎”，选择哪一个至关重要。

1. 确定你的系统类型 首先，按下键盘上的 Win + R 键，输入 winver 并回车。在弹出的窗口中，查看你的 Windows 规格 和 系统类型。

Windows 10 专业版/企业版/教育版（64位），且版本号在 2004（内部版本 19041）或更高。
- 推荐方案：Docker Desktop for Windows (WSL 2 后端)
- 这是目前最主流、性能最好的方式。它利用 Windows 内置的 Linux 子系统（WSL 2）来运行 Docker 引擎，资源占用更少，文件读写速度更快，并且能同时支持 Linux 和 Windows 容器。
Windows 10 家庭版或较旧的 Windows 10 专业版（版本低于 2004）
- 传统方案：Docker Desktop for Windows (Hyper-V 后端)
- 这种方式需要借助 Windows 的 Hyper-V 虚拟化技术。需要注意的是，Windows 10 家庭版默认不包含 Hyper-V，你需要先通过一些方法启用它（过程稍复杂），或者考虑升级到专业版。
Windows 11
- 绝大多数 Win11 版本都直接支持 Docker Desktop for Windows (WSL 2 后端)，这是你的首选。

简单来说：

如果你的系统是 Win10/11 专业版及以上，直接走 WSL 2 路线。
如果是家庭版，可以先尝试按 WSL 2 路线准备，如果不行再考虑启用 Hyper-V 或升级系统。

2. 开启必要的系统功能 对于 WSL 2 方案，我们需要先确保两个 Windows 功能已经开启。

步骤一：开启“适用于 Linux 的 Windows 子系统”
1. 以管理员身份打开 PowerShell（在开始菜单搜索 PowerShell，右键选择“以管理员身份运行”）。
2. 复制并粘贴以下命令，然后按回车：
```
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
```
  这条命令会启用 WSL 基础功能。
步骤二：开启“虚拟机平台” 继续在刚才的管理员 PowerShell 中，输入以下命令并回车：
```
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
```
这条命令为 WSL 2 提供了虚拟化支持。
步骤三：重启电脑 执行完以上两条命令后，务必重启你的电脑，让设置生效。
步骤四：将 WSL 2 设为默认版本 电脑重启后，再次以管理员身份打开 PowerShell，输入：
```
wsl --set-default-version 2
```
如果看到提示“WSL 2 需要更新其内核组件”，它会提供一个链接让你下载并安装“WSL2 Linux 内核更新包”，按照提示下载安装即可，然后再执行一次上面的命令。

二、下载与安装 Docker Desktop

1. 下载安装包 访问 Docker 官网的下载页面，找到 Docker Desktop for Windows 的下载链接。下载过程是免费的，但需要你注册一个 Docker Hub 账号（免费），用于登录和管理镜像。

2. 安装过程

双击下载好的 Docker Desktop Installer.exe 文件。
安装向导会提示你选择安装选项。强烈建议勾选以下两项：
- Use WSL 2 instead of Hyper-V (recommended)：使用 WSL 2 而不是 Hyper-V。这正是我们前面准备工作的目的。
- Add shortcut to desktop：在桌面创建快捷方式，方便以后打开。
点击“OK”开始安装。安装过程可能需要几分钟，请耐心等待。
安装完成后，点击“Close”关闭安装向导，并根据提示重启电脑。

三、首次配置与验证

启动 Docker Desktop 电脑重启后，在开始菜单或桌面找到 Docker Desktop 图标，双击启动。第一次启动会进行初始化，可能需要一点时间。你会看到 Docker 的“小鲸鱼”图标出现在任务栏右下角。
登录账号（可选但推荐） 启动后可能会弹出登录窗口，输入你在 Docker Hub 注册的账号密码登录。登录后可以方便地拉取公共镜像，并管理自己的镜像仓库。
验证安装是否成功 这是最关键的一步！我们需要用命令行来验证 Docker 能否正常工作。
- 按下 Win + R，输入 cmd 打开命令提示符，或者直接打开 PowerShell。
- 在命令行中输入以下命令，然后按回车：
```
docker --version
```
  如果安装成功，你会看到类似 Docker version 20.10.xx, build xxxxx 的版本信息。
- 再输入一个更重要的命令：
```
docker run hello-world
```
  这条命令会让 Docker 从远程仓库拉取一个名为 hello-world 的极小型测试镜像，并在容器中运行它。
  - 如果成功，你会在屏幕上看到一段“Hello from Docker!”的欢迎信息，并附带解释说明你的安装正在正常工作。
  - 如果失败，通常会提示连接错误或权限问题。请检查：
    - Docker Desktop 是否已经成功启动（任务栏图标是否稳定，没有显示红色错误标志）。
    - 网络连接是否正常。

四、基础使用：运行你的第一个实用容器

安装验证通过后，我们来点实际的，运行一个常用的 Nginx 服务器容器，感受一下 Docker 的便捷。

拉取 Nginx 镜像 在命令行中输入：
```
docker pull nginx:latest
```
这会将最新的 Nginx 镜像下载到你的本地电脑。
运行 Nginx 容器 输入以下命令：
```
docker run -d -p 8080:80 --name my-nginx nginx
```
- -d：让容器在“后台”运行。
- -p 8080:80：将你电脑的 8080 端口 映射到容器内部的 80 端口（Nginx 默认端口）。
- --name my-nginx：给这个容器起个名字，方便管理，这里叫 my-nginx。
- nginx：指定使用的镜像名称。
访问测试 打开你的浏览器（如 Chrome, Edge），在地址栏输入：
```
http://localhost:8080
```
如果一切正常，你将看到 Nginx 的默认欢迎页面，上面写着“Welcome to nginx!”。恭喜你，你已经成功在 Docker 中运行了一个 Web 服务器！
查看和管理容器
- 查看正在运行的容器：docker ps
- 停止容器：docker stop my-nginx
- 删除已停止的容器：docker rm my-nginx

五、常见问题与优化设置

启动慢或资源占用高？ 进入 Docker Desktop 设置（右键任务栏图标 -> Settings）：
- Resources -> WSL Integration：确保与你安装的 Linux 发行版（如 Ubuntu）的集成已开启。
- Resources -> Advanced：可以调整分配给 Docker 的 CPU 核心数、内存和交换空间大小，根据你电脑的配置合理设置，避免占用过多资源影响其他程序。
拉取镜像速度慢？ 由于网络原因，从 Docker 官方仓库拉取镜像可能很慢。可以配置国内镜像加速器。在 Docker Desktop 设置中，找到 Docker Engine，将配置 JSON 文件中的 registry-mirrors 项修改为国内镜像地址，例如：
```
{
  "registry-mirrors": [
    "https://docker.mirrors.ustc.edu.cn",
    "https://hub-mirror.c.163.com"
  ]
}
```
修改后点击“Apply & Restart”重启 Docker 生效。
文件存放在哪里？ Docker 的镜像和容器数据默认存储在 Windows 系统的 C:\Users\你的用户名\AppData\Local\Docker 目录下。如果 C 盘空间紧张，可以在设置中的 Resources -> Advanced -> Disk image location 里更改存储路径到一个更大的磁盘。

按照以上步骤，你就能在 Windows 上顺利搭建起 Docker 环境。Docker 的魅力在于一次配置，随处运行，它能极大地简化开发、测试和部署的流程。从今天这个简单的 Nginx 容器开始，你可以尝试部署更复杂的应用栈，比如 WordPress（博客系统）或 MySQL（数据库），开启你的容器化之旅。