WSL2 + Docker Desktop 安装与 Ubuntu 镜像迁移至 D 盘指南
在 Windows 环境下安装 WSL2 及 Docker Desktop 的完整流程。内容包括启用必要的系统功能、检查版本、安装 Ubuntu 发行版并将其迁移至 D 盘以节省空间。随后讲解了 Docker Desktop 的安装步骤及磁盘镜像存储位置的修改方法,帮助开发者构建高效的容器化开发环境。

在 Windows 环境下安装 WSL2 及 Docker Desktop 的完整流程。内容包括启用必要的系统功能、检查版本、安装 Ubuntu 发行版并将其迁移至 D 盘以节省空间。随后讲解了 Docker Desktop 的安装步骤及磁盘镜像存储位置的修改方法,帮助开发者构建高效的容器化开发环境。

必须先启用'适用于 Linux 的 Windows 子系统'可选功能,然后才能在 Windows 上安装任何 Linux 分发版。 以管理员身份打开 cmd 命令行或者 PowerShell,输入以下命令:
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
安装 WSL 2 之前,必须启用虚拟机平台功能。计算机将需要虚拟化功能才能使用此功能。 运行以下命令:
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
运行以上两条命令之后重启电脑。
若要使用 WSL 2,对于 x64 系统:版本 1903 或更高版本,内部版本为 18362.1049 或更高版本。对于 ARM64 系统:版本 2004 或更高版本,内部版本为 19041 或更高版本。
查看系统版本方法:Win + R,输入 winver。
若要查看 Linux 分发版是否设置为 WSL 2,请使用以下命令:
wsl --list --verbose
以管理员身份运行以下命令,查看可用发行版本:
wsl --list --online
选择安装 Ubuntu 最新 LTS 发行版(如 Ubuntu-24.04),也可以选择 Ubuntu-22.04 或 Ubuntu-20.04。 安装命令示例:
wsl --install -d Ubuntu-24.04
为系统设置用户名和密码: 启动后按提示操作。 如果出现 Linux 内核更新包缺失,执行以下命令下载:
wsl --update
重启电脑,此时电脑上可以看到 WSL 界面。
使用 WSL 官方导出/导入功能,这是最灵活、最可靠的方法。 1、确定你的发行版名称 打开 cmd 或 PowerShell(以管理员身份运行),输入以下命令:
wsl --list --verbose
复制发行版名称(例如:Ubuntu-24.04)。
2、导出发行版到一个文件 将系统打包成 .tar 文件,导出到 D 盘临时位置:
wsl --export Ubuntu-24.04 D:\wsl-ubuntu24.04-backup.tar
3、注销(卸载)原有的发行版 注意:此操作会删除 C 盘上的原始 ext4.vhdx 文件。请确保上一步导出成功。
wsl --unregister Ubuntu-24.04
4、在 D 盘的新位置导入该文件并创建新的发行版 将备份文件导入到 D 盘新文件夹中。需事先创建好文件夹(如 D:\WSL\Ubuntu-24.04)。
wsl --import Ubuntu-24.04 D:\WSL\Ubuntu-24.04 D:\wsl-ubuntu24.04-backup.tar --version 2
5、设置默认用户 导入的系统默认以 root 用户启动。将其设置回原来的用户。 启动新 Ubuntu 系统:
wsl -d Ubuntu-24.04
执行以下命令(将 <你的用户名> 替换为你原来在 Ubuntu 里使用的用户名):
usermod -u <UID> <username>
# 或者在 /etc/passwd 中修改
exit
退出所有 WSL 窗口,在 PowerShell 中执行 wsl --shutdown 彻底关闭 WSL,再重新启动 wsl 命令,就会以普通用户身份登录了。
6、清理临时文件
删除导出的临时备份文件 D:\wsl-ubuntu24.04-backup.tar 以节省空间。
Docker Desktop 官网:https://www.docker.com/products/docker-desktop/ Windows-AMD64 选对应版本(x64-based PC 代表 Windows-AMD64)。 下载完成后选择 OK。 Docker Desktop 应用本身不提供自定义安装目录,只能默认安装在 C 盘(C:\Program Files\Docker\)下。 如果想自定义安装到 D 盘,需通过符号链接或修改配置,但占用空间最大的磁盘镜像目录可以修改。 安装成功后重启电脑。 打开 Docker Desktop,选择 Accept。登录不登录均可。 看到Engine running和电脑右下角 Docker 图标说明大功告成!
点击设置。 修改磁盘镜像存储位置到自定义的 D 盘。 后续使用 Docker Desktop 搜索镜像拉取时需要网络连接正常。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online
通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online
将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online