windows11 安装 docker desktop （包含数据迁移到D盘存储）

windows 11 安装 docker desktop（包含数据迁移到D盘存储）

2024年6月28再次更新，本次更新部分有明显颜色区分

• 2024年6月份开始，国内所有镜像加速源基本不行了！因此不需要再配置加速源
• 所有下载镜像操作，请使用魔法操作

1. 设置环境

必要条件：

• 开启 Hyper-V
• 安装 wsl

1.1 开启 Hyper-V

如果没有 Hyper-V 选项，说明你的系统没有安装 Hyper-V（比如家庭版就没有）

• 则需要安装 Hyper-V安装流程如下：在桌面创建一个文件，名称叫：'Hyper-V.bat',内容为：pushd "%~dp0"dir /b %SystemRoot%\servicing\Packages\*Hyper-V*.mum >hyper-v.txtfor /f %%i in ('findstr /i . hyper-v.txt 2^>nul') do dism /online /norestart /add-package:"%SystemRoot%\servicing\Packages\%%i"del hyper-v.txtDism /online /enable-feature /featurename:Microsoft-Hyper-V-All /LimitAccess /ALL【鼠标右击】->选择【以管理员身份运行】。大概等几分钟。重启电脑后“Window功能”就有Hyper-V选项了，已经默认勾上了

1.2 安装 wsl

检查是否有wsl

C:\Users\yzx>wsl --version
WSL 版本： 2.2.4.0
内核版本： 5.15.153.1-2
WSLg 版本： 1.0.61
MSRDC 版本： 1.2.5326
Direct3D 版本： 1.611.1-81528511
DXCore 版本： 10.0.26091.1-240325-1447.ge-release
Windows 版本： 10.0.22631.3810

• 如没有wsl,则需下载安装： 下载地址
• wsl是默认安装路径，是不能修改安装路径的，因此后面docker安装的镜像也是默认安装到wsl目录下的，需要迁移(后面再说)

设置 wsl 版本

# wsl 版本有1和2，这里必须设置为2才能支持docker
wsl --set-default-version 2

2. 安装 docker desktop

下载地址为：下载地址

**

docker desktop

默认安装到c盘的，使用如下命令，可以安装到

D

盘**

# C:\Users\yzx\Desktop\Docker Desktop Installer.exe 是我下载的docker desktop文件目录
# D:\java\docker\docker 为安装的路径
C:\Users\yzx\Desktop>"C:\Users\yzx\Desktop\Docker Desktop Installer.exe" install --installation-dir="D:\java\docker\docker"

运行结果：

C:\Users\yzx\Desktop>-------------------------------------------------------------------------------->8 Version: 4.31.1 (153621) Sha1: Started on: 20240627 02:12:02.152 Resources: C:\Users\yzx\Desktop\resources OS: Windows 10 Home China Edition: CoreCountrySpecific Id: 2009 Build: 22631 BuildLabName: 22621.1.amd64fre.ni_release.220506-1250 File: C:\Users\yzx\AppData\Local\Docker\install-log.txt CommandLine: "C:\Users\yzx\Desktop\Docker Desktop Installer.exe" install --installation-dir="D:\java\docker\docker" You can send feedback, including this log file, at Issues · docker/for-win · GitHub [2024-06-27T02:12:03.467188600Z][ManifestAndExistingInstallationLoader][I] Install path is D:\java\docker\docker. Loading manifest first [2024-06-27T02:12:03.467188600Z][ManifestAndExistingInstallationLoader][I] No manifest found, returning no existing install [2024-06-27T02:12:03.467188600Z][Installer][I] No installation found [2024-06-27T02:12:03.482875600Z][ManifestAndExistingInstallationLoader][I] Not run as admin, relaunching with UAC prompt -------------------------------------------------------------------------------->8 Version: 4.31.1 (153621) Sha1: Started on: 20240627 02:12:07.718 Resources: C:\Users\yzx\Desktop\resources OS: Windows 10 Home China Edition: CoreCountrySpecific Id: 2009 Build: 22631 BuildLabName: 22621.1.amd64fre.ni_release.220506-1250 File: C:\ProgramData\DockerDesktop\install-log-admin.txt CommandLine: "C:\Users\yzx\Desktop\Docker Desktop Installer.exe" "install" -package "res:DockerDesktop" --installation-dir="D:\java\docker\docker" --relaunch-as-admin You can send feedback, including this log file, at Issues · docker/for-win · GitHub [2024-06-27T02:12:08.999653700Z][ManifestAndExistingInstallationLoader][I] Install path is D:\java\docker\docker. Loading manifest first [2024-06-27T02:12:09.015345800Z][ManifestAndExistingInstallationLoader][I] No manifest found, returning no existing install [2024-06-27T02:12:09.015345800Z][Installer][I] No installation found [2024-06-27T02:12:09.363957700Z][InstallWorkflow][I] Using package: res:DockerDesktop [2024-06-27T02:12:09.426521000Z][InstallWorkflow][I] Downloading [2024-06-27T02:12:10.475514900Z][InstallWorkflow][I] Extracting manifest [2024-06-27T02:12:11.465453600Z][InstallWorkflow][I] Manifest found: version=153621, displayVersion=4.31.1, channelUrl=https://desktop-stage.docker.com/win/main/amd64/appcast.xml [2024-06-27T02:12:11.465957100Z][InstallWorkflow][I] Checking prerequisites [2024-06-27T02:12:11.675089500Z][InstallWorkflow][I] Prompting for optional features [2024-06-27T02:12:14.324384200Z][InstallWorkflow][I] Selected backend mode: wsl-2 [2024-06-27T02:12:14.327396500Z][InstallWorkflow][I] Unpacking artifacts [2024-06-27T02:13:35.576078700Z][InstallWorkflow][I] Deploying component Docker.Installer.CreateGroupAction [2024-06-27T02:13:56.086788000Z][InstallWorkflow][I] Deploying component Docker.Installer.AddToGroupAction [2024-06-27T02:14:27.934304900Z][InstallWorkflow][I] Deploying component Docker.Installer.EnableFeaturesAction [2024-06-27T02:14:27.948058600Z][InstallWorkflow-EnableFeaturesAction][I] Required features: VirtualMachinePlatform, Microsoft-Windows-Subsystem-Linux [2024-06-27T02:14:28.342670400Z][InstallWorkflow][I] Deploying component Docker.Installer.ServiceAction [2024-06-27T02:14:28.344593900Z][InstallWorkflow-ServiceAction][I] Removing service [2024-06-27T02:14:28.345684100Z][InstallWorkflow-ServiceAction][I] Creating service [2024-06-27T02:14:28.347590300Z][InstallWorkflow][I] Deploying component Docker.Installer.ShortcutAction [2024-06-27T02:14:28.359598800Z][InstallWorkflow-ShortcutAction][I] Creating shortcut: C:\ProgramData\Microsoft\Windows\Start Menu\Docker Desktop.lnk/Docker Desktop [2024-06-27T02:14:28.364701100Z][InstallWorkflow][I] Deploying component Docker.Installer.ShortcutAction [2024-06-27T02:14:28.365697600Z][InstallWorkflow-ShortcutAction][I] Creating shortcut: C:\Users\yzx\Desktop\Docker Desktop.lnk/Docker Desktop [2024-06-27T02:14:28.367221600Z][InstallWorkflow][I] Deploying component Docker.Installer.AutoStartAction [2024-06-27T02:14:28.371227300Z][InstallWorkflow][I] Deploying component Docker.Installer.PathAction [2024-06-27T02:14:28.535498700Z][InstallWorkflow][I] Deploying component Docker.Installer.ExecAction [2024-06-27T02:14:28.538498800Z][InstallWorkflow-ExecAction][I] Running: D:\java\docker\docker\InstallerCli.exe -i with timeout=-1 [2024-06-27T02:14:30.700959800Z][InstallWorkflow][I] Registering product [2024-06-27T02:14:30.717039300Z][InstallWorkflow][I] Deleting C:\ProgramData\DockerDesktop\install-settings.json [2024-06-27T02:14:30.718040000Z][InstallWorkflow][I] Installation succeeded

3. 运行、迁移数据文件到 D 盘

打开运行 **

docker desktop

**，能正常打开说明安装成功了

非常重要：

**docker安装的镜像、容器等，都放在

C:\Users\yzx\AppData\Local\Docker\wsl 

目录中。请不要在“设置”中修改位置，请使用 wsl 相关命令迁移到 D 盘，重要的事情说三遍**

3.1 迁移 wsl 数据文件到 D 盘

wsl 常见命令

• 更新 wsl：wsl --update
• 查看已经安装的的Linux发行版：wsl --list， Docker Desktop 通过 wsl启动时，会自动创建两个 wsl 子系统：docker-desktop 和 docker-desktop-data``````C:\Users\yzx>wsl --list适用于 Linux 的 Windows 子系统分发:docker-desktop (默认) docker-desktop-data# docker-desktop 对应 # -> C:\Users\yzx\AppData\Local\Docker\wsl\main\ext4.vhdx数据文件# docker-desktop-data 对应# -> C:\Users\yzx\AppData\Local\Docker\wsl\data\ext4.vhd镜像文件
• 将 wsl 2 设置为默认版本：wsl --set-default-version 2
• 关闭所有子系统：wsl --shutdown
• 卸载定子系统：wsl --unregister "名称xxx"

迁移数据之前必做：

**首次启动docker面版的时候，会默认创建两个 wsl 子系统：

docker-desktop

和

docker-desktop-data

**

docker-desktop 对应C:\Users\yzx\AppData\Local\Docker\wsl\main\ext4.vhdx数据文件

docker-desktop-data 对应C:\Users\yzx\AppData\Local\Docker\wsl\data\ext4.vhd镜像文件

然而如果从来没有下载镜像操作，C:\Users\yzx\AppData\Local\Docker\wsl\data\ext4.vhd 这个文件则为空，因此为了后面方便迁移数据，再迁移前务必先随机下载一个镜像(比如mysql、nginx等都可以)

# 先停止docker
# 关闭所有发行版
C:\Users\yzx>wsl --shutdown
# 查看停止情况
# 安装docker后，docker会自动创建个发行版：
# docker-desktop
# docker-desktop-data 有些版本不会创建这个
C:\Users\yzx>wsl --list -v
  NAME                   STATE           VERSION
* docker-desktop         Stopped         2
  docker-desktop-data    Stopped         2

# 备份导出目前已有的数据
# docker-desktop 对应 
# -> C:\Users\yzx\AppData\Local\Docker\wsl\main\ext4.vhdx数据文件
# docker-desktop-data 对应
# -> C:\Users\yzx\AppData\Local\Docker\wsl\data\ext4.vhd镜像文件
# 命令说明：将...wsl\main\ext4.vhdx数据文件备份到C:\Users\yzx\Desktop目录下，并命名为docker-desktop.tar
C:\Users\yzx>wsl --export docker-desktop "C:\Users\yzx\Desktop\docker-desktop.tar"
正在导出，这可能需要几分钟时间。
操作成功完成。
# 命令说明：将...wsl\data\ext4.vhd镜像文件备份到C:\Users\yzx\Desktop目录下，并命名为docker-desktop-data.tar
C:\Users\yzx>wsl --export docker-desktop-data "C:\Users\yzx\Desktop\docker-desktop-data.tar"
正在导出，这可能需要几分钟时间。
操作成功完成。

# 删除原有数据
# 说明：解除当前的docker 数据虚拟盘映射，该操作后会删除原有的ext4.vhdx (数据未备份前请谨慎操作)
C:\Users\yzx>wsl --unregister docker-desktop
正在注销。
操作成功完成。
C:\Users\yzx>wsl --unregister docker-desktop-data
正在注销。
操作成功完成。

# 导入数据到新盘
# 命令说明：将备份数据导入到新的虚拟盘，且指定虚拟盘的存放路径为D:\java\docker\docker_workspace\main，导入完成后在该目录下会存在一个ext4.vhdx的虚拟磁盘路径
C:\Users\yzx>wsl --import docker-desktop "D:\java\docker\docker_workspace\main" "C:\Users\yzx\Desktop\docker-desktop.tar" --version 2
正在导入，这可能需要几分钟时间。
操作成功完成。
# 命令说明：将备份数据导入到新的虚拟盘，且指定虚拟盘的存放路径为D:\java\docker\docker_workspace\data，导入完成后在该目录下会存在一个ext4.vhdx的虚拟磁盘路径
C:\Users\yzx>wsl --import docker-desktop-data "D:\java\docker\docker_workspace\data" "C:\Users\yzx\Desktop\docker-desktop-data.tar" --version 2
正在导入，这可能需要几分钟时间。
操作成功完成

# 创建软链接，必须创建软件链接，否则重启不生效
C:\Users\yzx>mklink "C:\Users\yzx\AppData\Local\Docker\wsl\data\ext4.vhdx" "D:\java\docker\docker_workspace\data\ext4.vhdx"

# 最后启动Docker

docker-desktop-data子系统的数据文件存储在："C:\Users\yzx\AppData\Local\Docker\wsl\data\ext4.vhdx"，当把这个迁移到D盘的时候，虽然当时会显示成功，但是重新启动电脑时，docker-desktop-data子系统就启动不起来了，docker-desktop-data子系统只识别第一次安装时候的数据文件位置，且不能修改，因此必须为 docker-desktop-data 数据创建软件链接，否则重启不生效，

C:\Users\yzx>mklink "C:\Users\yzx\AppData\Local\Docker\wsl\data\ext4.vhdx" "D:\java\docker\docker_workspace\data\ext4.vhdx"