Docker Desktop Windows 安装与配置完全指南

Docker Desktop Windows 安装与配置完全指南

docs Source repo for Docker's Documentation 项目地址: https://gitcode.com/gh_mirrors/docs3/docs

前言

Docker Desktop 是开发者在 Windows 系统上运行 Docker 容器的最佳选择。本文将详细介绍在 Windows 系统上安装和配置 Docker Desktop 的完整流程，包括系统要求、安装步骤、常见问题解答等内容，帮助开发者快速搭建 Docker 开发环境。

系统要求

在安装 Docker Desktop 之前，请确保您的 Windows 系统满足以下最低要求：

基于 WSL 2 后端的系统要求（x86_64 架构）

• 操作系统：
  • Windows 11 64位：家庭版、专业版 22H2 或更高版本
  • Windows 10 64位：家庭版、专业版 22H2（build 19045）或更高版本
• WSL 版本：2.1.5 或更高
• 硬件要求：
  • 支持二级地址转换(SLAT)的64位处理器
  • 4GB 系统内存
  • BIOS/UEFI 中启用了硬件虚拟化

基于 Hyper-V 后端的系统要求（x86_64 架构）

• 操作系统：
  • Windows 11 64位：企业版、专业版或教育版 22H2 或更高
  • Windows 10 64位：企业版、专业版或教育版 22H2（build 19045）或更高
• 功能要求：需要启用 Hyper-V 和容器 Windows 功能
• 硬件要求：与 WSL 2 后端相同

注意事项

1. Windows 容器支持：要运行 Windows 容器，必须使用 Windows 10/11 专业版或企业版。家庭版和教育版仅支持 Linux 容器。

2. 服务器系统：Docker Desktop 不支持 Windows Server 系统（如 Windows Server 2019/2022）。

3. ARM 架构：目前 ARM 架构的 Docker Desktop 处于早期访问阶段，不支持 Windows 容器。

安装前准备

启用必要功能

根据您选择的后端类型，需要启用不同的 Windows 功能：

对于 WSL 2 后端

1. 以管理员身份打开 PowerShell
2. 运行以下命令启用 WSL 功能：

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

3. 运行以下命令启用虚拟机平台功能：

   dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
   

4. 重启计算机使更改生效
5. 将 WSL 2 设置为默认版本：

   wsl --set-default-version 2
   

对于 Hyper-V 后端

1. 以管理员身份打开 PowerShell
2. 运行以下命令启用 Hyper-V：

   Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V -All
   

3. 重启计算机使更改生效

安装 Docker Desktop

交互式安装（推荐）

1. 下载最新版 Docker Desktop 安装程序

2. 双击运行 Docker Desktop Installer.exe

3. 在安装向导中：

   • 选择安装位置（默认为 C:\Program Files\Docker\Docker）
   • 根据需求选择是否使用 WSL 2 替代 Hyper-V
   • 完成授权和安装过程

4. 安装完成后点击"关闭"

5. 如果您的用户账户不是管理员账户，需要将用户添加到 docker-users 组：

   • 以管理员身份运行"计算机管理"
   • 导航至"本地用户和组" > "组" > "docker-users"
   • 右键添加用户到该组
   • 注销并重新登录使更改生效

命令行安装（适合批量部署）

下载安装程序后，可以使用以下命令进行静默安装：

Start-Process 'Docker Desktop Installer.exe' -Wait install

常用安装参数：

• --quiet：静默安装
• --accept-license：自动接受许可协议
• --installation-dir=<路径>：指定安装目录
• --backend=<后端类型>：指定默认后端（hyper-v/wsl-2）
• --allowed-org=<组织名>：限制只能使用指定 Docker 镜像仓库组织的账户登录

首次运行与配置

1. 通过开始菜单或搜索启动 Docker Desktop

2. 阅读并接受 Docker 订阅服务协议

3. Docker Desktop 启动后，系统托盘会出现鲸鱼图标

4. 右键点击图标可以访问常用功能：

   • 切换 Windows/Linux 容器
   • 访问设置面板
   • 管理容器和镜像

常见问题解答

Q：如何切换 Windows 和 Linux 容器？

A：通过 Docker Desktop 菜单选择"Switch to Windows containers"或"Switch to Linux containers"。注意切换后部分设置会分别保存。

Q：安装后无法启动怎么办？

A：请检查：

1. 是否满足系统要求
2. 是否启用了必要的 Windows 功能
3. 用户是否已加入 docker-users 组
4. BIOS 中是否启用了虚拟化支持

Q：如何在没有管理员权限的情况下运行？

A：可以使用 --always-run-service 参数安装，但某些功能可能受限。

最佳实践建议

1. 数据存储位置：对于大型项目，建议将 Docker 数据存储迁移到非系统盘：

   • 修改 wsl-default-data-root 或 hyper-v-default-data-root 参数

2. 代理设置：如果处于企业网络环境中，可能需要配置代理：

   --proxy-http-mode=manual --override-proxy-http=http://proxy.example.com:8080
   

3. 资源分配：在设置中合理分配 CPU 和内存资源，避免影响主机性能

4. 镜像下载优化：在网络环境受限的情况下，建议配置镜像下载优化工具

后续步骤

成功安装 Docker Desktop 后，您可以：

1. 运行 docker version 验证安装
2. 尝试拉取并运行第一个容器：docker run hello-world
3. 探索 Docker Compose 进行多容器应用管理
4. 学习如何构建自定义 Docker 镜像

通过本文的指导，您应该已经成功在 Windows 系统上安装并配置了 Docker Desktop，为容器化开发做好了准备。如果在使用过程中遇到任何问题，可以参考 Docker 官方文档或社区资源获取帮助。

docs Source repo for Docker's Documentation 项目地址: https://gitcode.com/gh_mirrors/docs3/docs