Docker Desktop安装和迁移

Posted at 2025-09-10

下载
准备工作
- 启用 WSL2和虚拟化平台
安装和配置
- 安装
- 配置国内镜像源
验证正常使用
数据迁移
其他问题

下载

在国内Docker Desktop 官方安装包下载速度缓慢，国内镜像站或一些网盘中的安装包并不是最新版本，踩坑下了一个镜像站的安装包版本太旧，捣鼓半天，运行不了，最后去官网下了最新版，慢就慢吧，起码能用
如果你的处理器是Intel / AMD 的就下 Download for Windows - AMD64
大概500多MB
官方链接：https://www.docker.com/products/docker-desktop/
官方文档：https://docs.docker.com/

准备工作

启用 WSL2和虚拟化平台

以管理员身份运行powershell
先看看有没有启用下面2个功能: WSL2 和虚拟化平台

# 1. 查询“适用于 Linux 的 Windows 子系统”
Get-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux | Select FeatureName, State

# 2. 查询“虚拟机平台”（WSL2 依赖的核心虚拟化组件）
Get-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform | Select FeatureName, State

输出结果如下：

FeatureName                          State
-----------                          -----
Microsoft-Windows-Subsystem-Linux    Enabled
VirtualMachinePlatform               Enabled

如果不是Enabled,而是Disabled,输入以下指令

1
2
3

# 一次性把两个都打开（仍需管理员权限）
dism /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

重启电脑
2. 安装WSL和Linux发行版

1 2	# 对于已安装的旧版本的WSL需要更新一下 wsl --update

如果之前没装过WSL，需要去微软官网下载并安装Linux内核更新包

1 2	# 安装Linux发行版，默认应该是Ubuntu-22.04 wsl --install

1 2	# 在安装好新的Linux发行版后，将WSL2设置为默认版本 wsl --set-default-vesion 2

重启电脑

1 2	# 重启后在cmd中输入如下指令，可以查看已安装的Linux发行版和版本 wsl -l -v

使用WSL2中的Ubuntu：

可以在cmd中直接输入wsl,回车打开，第一次使用需要设置账号和密码（密码输入时看不见）
也可以在开始中选择WSL或Ubuntu，点击后打开使用

安装和配置

安装

双击安装包下载，选不了安装路径，确保选中以下选项
Install required Windows componenets for WSL2
2025/9/10 我装的最新版好像没有这个选项，点击OK后能正常使用
接下来会从网络上安装一些资源，等页面出现Close,点击关闭程序
从开始中打开Docker Desktop, Accept协议条款
会出现弹窗显示Docker is starting

配置国内镜像源

为了解决拉取镜像慢的问题

打开 Docker Desktop → 点击右上角设置图标 ⚙️ → 选择 Docker Engine

在 JSON 配置中添加如下内容：

1
2
3

"registry-mirrors": [
  "https://docker.1ms.run"
]

点击 Apply & Restart 重启 Docker 生效

验证正常使用

cmd或Ubuntu中输入：

1	docker run hello-world

看到hello from docker等信息说明Docker Desktop 正常运行了
如果看到了，真要恭喜你，这一路真是不容易！

数据迁移

Docker Desktop 默认安装在C盘，但是C盘空间常常不够用，所以要把数据迁移到其他盘中，迁移前记得对数据进行备份
使用WSL指令进行迁移

停掉WSL并检查状态

1 2	wsl --shutdown wsl -l -v # 确保 docker-desktop 和 docker-desktop-data 状态都是Stopped

导出子系统（4.30版本后运行wsl -l -v只显示docker-desktop,此版本之后把docker-desktop和docker-desktop-data进行了合并）
1
wsl --export docker-desktop D:\DockerWSL\docker-desktop.tar

注销docker-desktop

1 2	wsl --unregister docker-desktop wsl -l -v 检查一下是否真的注销了

在新路径重新导入docker-desktop

1	wsl --import docker-desktop D:\DockerWSL\docker-desktop D:\DockerWSL\docker-desktop.tar

在docker desktop 中 settings 的 Resources 中更改Disk image location 的路径，Apply 后重启

检查数据是否迁移成功

docker version 
docker images --format "table {{.Repository}}:{{.Tag}}\t{{.ID}}\t{{.Size}}"
docker volume ls
docker run hello-world

其他问题

Docker Desktop 启动WSL2后端失效

1 2	# 重启WSL2系统 wsl --shutdown

重新打开Docker Desktop,查看是否能正常使用

1 2	# 清理并重建 Docker 发行版 wsl --unregister docker-desktop

注意：
官方说明：从 4.30 及更高版本开始，Docker Desktop 改为直接创建和管理一个虚拟硬盘（VHDX）来存储数据，而不再依赖 docker-desktop-data 分发版——除非该分发版是由早期版本安装后已经存在，而且没有被重置或清空的话
https://docs.docker.com/desktop/features/wsl

重启Docker Desktop

1 2	# 检查WSL2是否正常运行 wsl -l -v

所有发行版的状态（State)应该是Running,且版本（Version）为2

自查清单：
[ ] 系统是否支持虚拟化，WSL2
[ ] WSL2的版本，Linux 内核版本，Docker Desktop 版本
[ ] 网络连接是否正常

我的系统是Win11

Previous post: 图片上传测试 Next post: 被AI外包的思考

Infinity

无限进步

下载