Windows 11 下 Docker Desktop 安装与部署指南

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

三、安装 WSL 2 Linux 内核更新包

方式一:

1. 访问 Microsoft 官方文档页面下载 WSL 2 Linux 内核更新包： https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi
2. 下载完成后，双击运行安装包
3. 按照安装向导完成安装

方式二:

1. 以管理员身份打开 PowerShell:

运行以下命令：wsl --install

系统会自动安装 Ubuntu 分布版

四、设置 WSL 2 为默认版本

1. 以管理员身份打开 PowerShell
2. 运行以下命令：

wsl --set-default-version 2

1. 验证 WSL 版本：

wsl --list --verbose

五、下载 Docker Desktop

1. 访问 Docker 官网下载页面： https://www.docker.com/products/docker-desktop
2. 点击"Download for Windows"按钮
3. 选择稳定版本进行下载

六、安装 Docker Desktop

安装步骤：

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

2. 在安装向导中，确保勾选以下选项：

   • Install required Windows components for WSL 2
   • Add shortcut to desktop

3. 点击"OK"开始安装

4. 安装过程可能需要几分钟，请耐心等待

5. 安装完成后，点击"Close"并重启计算机

七、首次配置 Docker Desktop

1. 启动 Docker Desktop

1. 重启后，从开始菜单或桌面快捷方式启动 Docker Desktop
2. 首次启动会显示服务协议，阅读并接受协议

2. 配置设置

1. 进入 Docker Desktop 设置界面

2. General 设置：

   • 勾选"Start Docker Desktop when you log in"（可选）
   • 选择"Use WSL 2 based engine"

3. Resources 设置：

   • 调整 CPU 和内存分配（建议内存至少 4GB）
   • 配置磁盘镜像位置

4. Docker Engine 设置： 可以配置 Docker 守护进程的 JSON 配置，例如镜像加速器

{
  "registry-mirrors": [
    "https://registry.docker-cn.com",
    "https://docker.mirrors.ustc.edu.cn"
  ],
  "insecure-registries": [],
  "debug": true,
  "experimental": false
}

八、验证安装

1. 检查 Docker 版本

1. 打开命令提示符或 PowerShell
2. 运行以下命令：

docker --version
docker-compose --version
docker system info

2. 运行测试容器

1. 运行一个简单的 Hello World 容器：

docker run hello-world

1. 如果看到欢迎信息，说明安装成功

九、常用 Docker 命令

基本命令

# 查看 Docker 信息
docker info
# 查看镜像列表
docker images
# 查看容器列表
docker ps -a
# 拉取镜像
docker pull [镜像名]
# 运行容器
docker run -it [镜像名] [命令]
# 停止容器
docker stop [容器 ID]
# 删除容器
docker rm [容器 ID]
# 删除镜像
docker rmi [镜像 ID]

实用示例

# 运行 Nginx 容器
docker run -d -p 80:80 --name my-nginx nginx
# 运行 MySQL 容器
docker run -d --name mysql -e MYSQL_ROOT_PASSWORD=123456 -p 3306:3306 mysql:8.0
# 查看容器日志
docker logs [容器名]

十、常见问题解决

1. Docker Desktop 无法启动

可能原因：

• WSL 2 未正确安装
• 虚拟化未启用
• 系统组件缺失

解决方案：

• 检查 BIOS/UEFI 中的虚拟化设置
• 重新安装 WSL 2
• 以管理员身份运行 Docker Desktop

2. 镜像下载速度慢

解决方案： 配置国内镜像加速器，在 Docker Desktop 设置中添加：

{
  "registry-mirrors": [
    "https://docker.mirrors.ustc.edu.cn",
    "https://hub-mirror.c.163.com",
    "https://registry.docker-cn.com"
  ]
}

3. 端口被占用

解决方案：

• 更改容器映射端口
• 停止占用端口的进程

十一、最佳实践建议

1. 资源管理：根据项目需求合理分配 CPU 和内存资源
2. 数据持久化：使用 volumes 或 bind mounts 保存重要数据
3. 镜像管理：定期清理无用镜像和容器释放磁盘空间
4. 安全考虑：不要在生产环境中使用默认配置
5. 备份策略：定期备份重要的 Docker 镜像和 volumes

结语

通过本指南，您应该已经成功在 Windows 11 系统上安装并配置了 Docker Desktop。Docker 为开发、测试和部署应用程序提供了极大的便利，是现代软件开发中不可或缺的工具。

随着对 Docker 的深入使用，您将能够更高效地管理应用程序的依赖关系，实现快速部署和扩展。建议继续学习 Docker Compose、Docker Swarm 或 Kubernetes 等高级功能，以充分发挥容器化技术的优势。