Windows环境下安装Docker的详细教程

一、系统要求检查

硬件要求

• Windows 10/11 64位：专业版、企业版或教育版（家庭版需使用Docker Desktop替代方案）
• 虚拟化已启用：在BIOS/UEFI中开启Intel VT-x或AMD-V
• 至少4GB RAM（建议8GB以上）
• CPU支持SLAT（第二代或更新）

软件要求

• WSL 2（Windows Subsystem for Linux 2）
• Windows更新：确保系统为最新版本

二、安装前准备

1. 启用虚拟化

# 以管理员身份打开PowerShell，检查虚拟化状态
systeminfo

# 查看是否显示：
# Hyper-V 要求：检测到虚拟机监控程序。将不显示 Hyper-V 所需的功能。

2. 启用Hyper-V和容器功能

# 启用Hyper-V（适用于Windows专业版/企业版）
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All

# 启用容器功能（适用于所有Windows版本）
Enable-WindowsOptionalFeature -Online -FeatureName Containers -All

3. 安装WSL 2（必需步骤）

# 1. 启用WSL功能
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# 2. 启用虚拟机平台
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

# 3. 重启计算机

# 4. 下载并安装WSL 2内核更新包
# 访问：https://aka.ms/wsl2kernel

# 5. 设置WSL 2为默认版本
wsl --set-default-version 2

三、安装Docker Desktop

方法1：使用安装程序（推荐）

下载Docker Desktop

• 访问：https://www.docker.com/products/docker-desktop
• 下载 Windows 版本（Docker Desktop Installer.exe）

运行安装程序

# 双击安装文件，按步骤安装：
# 1. 接受许可条款
# 2. 选择安装选项（建议勾选所有选项）
# 3. 等待安装完成

配置选项

• 安装完成后，首次启动会提示配置：
  • 选择使用WSL 2而不是Hyper-V（推荐）
  • 设置Docker Desktop为开机启动（可选）

方法2：使用winget（Windows包管理器）

# 搜索可用版本
winget search docker

# 安装Docker Desktop
winget install Docker.DockerDesktop

四、安装后配置与验证

1. 启动Docker Desktop

# 首次启动需要权限确认
# 等待Docker服务启动（约1-2分钟）

2. 验证安装

# 打开PowerShell或命令提示符
docker --version
# 输出类似：Docker version 20.10.12, build e91ed57

docker-compose --version
# 输出类似：Docker Compose version v2.2.3

docker run hello-world
# 应看到Hello from Docker!消息

3. WSL集成配置（可选）

五、常见问题解决方案

问题1：WSL 2安装失败

解决方案：

# 重置WSL
wsl --shutdown
wsl --unregister Ubuntu  # 替换为你的发行版名称
wsl --install -d Ubuntu

问题2：Docker启动失败

检查步骤：

确保虚拟化已启用

# PowerShell检查
Get-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V

关闭冲突的虚拟机软件（如VMware、VirtualBox）

问题3：镜像下载慢

配置国内镜像源：

// Docker Desktop设置 → Docker Engine
{
  "registry-mirrors": [
    "https://docker.mirrors.ustc.edu.cn",
    "https://hub-mirror.c.163.com",
    "https://mirror.baidubce.com"
  ]
}

六、基础使用示例

1. 运行第一个容器

# 运行Nginx
docker run -d -p 80:80 --name mynginx nginx

# 查看运行中的容器
docker ps

# 停止容器
docker stop mynginx

# 删除容器
docker rm mynginx

2. 构建自定义镜像

# 创建Dockerfile
# FROM node:14
# WORKDIR /app
# COPY package*.json ./
# RUN npm install
# COPY . .
# EXPOSE 3000
# CMD ["npm", "start"]

# 构建镜像
docker build -t myapp .

# 运行自定义镜像
docker run -p 3000:3000 myapp

七、卸载Docker

完全卸载步骤

• C:\Program Files\Docker
• C:\Users\<用户名>\.docker
• C:\ProgramData\Docker

wsl --unregister docker-desktop
wsl --unregister docker-desktop-data

八、学习资源推荐

• 官方文档：https://docs.docker.com/desktop/windows/
• Docker Hub：https://hub.docker.com/
• 学习课程：Docker官方入门教程

注意事项

安装完成后，建议通过运行一些简单的容器来熟悉基本操作。如有问题，可查阅Docker官方文档或社区论坛获取帮助。