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集成配置(可选)
打开Docker Desktop设置
选择"Resources" → "WSL Integration"
启用需要集成的Linux发行版
五、常见问题解决方案
问题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
完全卸载步骤
停止所有Docker容器
卸载Docker Desktop程序
删除残留文件:
- C:\Program Files\Docker
- C:\Users\<用户名>\.docker
- C:\ProgramData\Docker
清理WSL数据(可选):wsl --unregister docker-desktop
wsl --unregister docker-desktop-data
八、学习资源推荐
- 官方文档:https://docs.docker.com/desktop/windows/
- Docker Hub:https://hub.docker.com/
- 学习课程:Docker官方入门教程
注意事项
Windows家庭版需要安装WSL 2才能使用Docker Desktop
建议定期更新Docker Desktop获取最新功能和安全补丁
生产环境建议使用Linux服务器运行Docker
安装完成后,建议通过运行一些简单的容器来熟悉基本操作。如有问题,可查阅Docker官方文档或社区论坛获取帮助。