Docker Desktop For Windows 完整安装教程

Docker 官方网站：

Docker Desktop下载：https://www.docker.com/products/docker-desktop/

使用 WSL 在 Windows 上安装 Linux
官方文档：https://learn.microsoft.com/zh-cn/windows/wsl/install

Docker Desktop安装前提

在 Windows 上运行 Docker Desktop，依赖于两项核心的 Windows 功能：

简单来说，Docker Desktop 利用 Hyper-V 创建虚拟环境，并在此环境中集成 WSL 2 来高效运行 Linux 容器。

1、开启Hyper-V

2、WSL 2安装

• WSL 2 的全称是 Windows Subsystem for Linux 2，即 Windows 子系统 for Linux 第2版。
• 安装前提：系统版本是Windows 22H2以下的建议升级版本： 设置” > “更新和安全” > “Windows 更新”，检查并安装最新的功能更新。
• 按 Win + R 键，输入 winver 运行，显示版本号22H2（至少是22H2版本才可以）

• 启用WSL功能：以管理员身份打开PowerShell，输入并执行：

# 1、这个命令默认安装WSL 2和默认的Linux发行版（通常是Ubuntu）
wsl –install

# 2、设置WSL 2为默认版本
wsl –set-default-version 2

a：仅安装WSL 2（不装发行版Ubuntu）：

• 下载WSL 2内核：访问微软WSL2内核更新包下载，wsl_update_x64.msi包：
  https://learn.microsoft.com/zh-cn/windows/wsl/install-manual#step-4—download-the-linux-kernel-update-package

b：安装Ubuntu 22.04.5 LTS （可选）

安装Ubuntu 22.04.5 LTS时报错

Please create a default UNIX user account. The username does not need to match your Windows username.
For more information visit: https://aka.ms/wslusers
Enter new UNIX username: ubuntu
参考的对象类型不支持尝试的操作。
Enter new UNIX username: ubuntu

这个错误通常是由于某些网络监控软件（如杀毒软件、防火墙、VPN客户端、游戏加速器）与WSL2的虚拟网络驱动发生冲突导致的。你需要中断当前卡住的过程，并修复网络配置。

方法：强制关闭并重置

# 1、关闭所有WSL相关进程
wsl –shutdown

# 2、网络重置
netsh winsock reset
netsh int ip reset all

# 3、重启电脑

把wsl2设置为默认版本

# 1、将 WSL2 设置为默认版本
wsl –set-default-version 2

# 2、检查当前WSL版本
wsl -l -v

3、安装Docker Desktop Installer.exe

• 注意：安装docker默认在c盘，界面没有修改安装目录的选项，所以可以用命令安装到d盘，准备d盘安装目录：

D:\\install_package
├── Docker_Desktop
│ ├── install_path\\ ← Docker将安装在这里
│ ├── downloads\\ ← 存放安装包
│ └── data\\ ← 后续存放数据文件

a：创建文件夹

# 在PowerShell中执行
New-Item -ItemType Directory -Path "D:\\install_package\\Docker_Desktop\\install_path" -Force
New-Item -ItemType Directory -Path "D:\\install_package\\Docker_Desktop\\downloads" -Force
New-Item -ItemType Directory -Path "D:\\install_package\\Docker_Desktop\\data" -Force

b：设置文件夹权限

# 给文件夹完全控制权限（避免安装失败）
icacls "D:\\install_package\\Docker_Desktop\\install_path" /grant "Everyone:F" /T
icacls "D:\\install_package\\Docker_Desktop\\install_path" /grant "Users:F" /T

c：使用命令行安装到指定路径

将安装包移动到：D:\\install_package\\Docker_Desktop\\downloads\\

# 以管理员身份打开PowerShell
# 切换到下载目录
cd "D:\\install_package\\Docker_Desktop\\downloads"

# 查看安装包文件名（通常是 Docker Desktop Installer.exe）
dir *.exe

# 运行安装命令，指定安装路径
# 注意：根据你的实际文件名调整
.\\"Docker Desktop Installer.exe" install –installation-dir="D:\\install_package\\Docker_Desktop\\install_path"

d：设置环境变量

# 1、在系统上搜索 docker.exe目录
Get-Command docker -ErrorAction SilentlyContinue

# 2、设置docker.exe路径变量
$dockerCliPath = "D:\\install_package\\Docker_Desktop\\install_path\\resources\\bin"

# 3、将Docker添加到系统PATH
[Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";$dockerCliPath", "Machine")
Write-Host "已将 $dockerCliPath 添加到系统 PATH"

# 4、检查Docker版本
docker –version

Docker version 29.1.3, build f52814d

问题1：docker无法正常显示解决方法

• 这是 Docker Desktop 检测到你的 WSL (Windows Subsystem for Linux) 版本太旧了

# 1、打开PowerShell直接输入这个命令，不需要切换目录！
wsl –update

# 2、设置 WSL2 为默认版本
wsl –set-default-version 2

# 3、检查当前WSL版本
wsl -l -v

• docker version: Client（客户端） 和 Server（服务器/引擎）

docker run –rm hello-world

代写：要迁移整个 WSL2 Docker 发行版到其他盘
C:\\Users\\用户名\\AppData\\Local\\Docker\\wsl：

# 1. 拉取官方 Python 镜像（公开，无需登录）
docker pull python:3.10-slim-bookworm

# 2. 给镜像打本地别名，方便使用
docker tag python:3.10-slim-bookworm my-python:3.10

# 3. 验证：运行容器并输出 Python 版本（–rm 自动清理容器）
docker run –rm my-python:3.10 python –version

# 4. 查看本地镜像（两个标签指向同一镜像）
docker images

# 5. 检查是否配置了镜像加速器（空输出表示未手动配置）
docker info | findstr -i "registry"

问题2：Docker Desktop 与 虚拟机Oracle VirtualBox 有冲突

• 关闭 Hyper-V 即可重新使用 VirtualBox ，使用 Docker Desktop 时重新打开 Hyper-V