1.1 确认系统版本#

在 设置 → 系统 → 系统信息 → Windows 规格 中查看当前系统版本。

若系统版本低于要求，需要先完成系统升级。

该要求属于系统功能层面的硬性限制，低版本系统无法正常使用 WSL2 及 Docker Desktop。

1.2 检查虚拟化支持#

在 任务管理器 → 性能 → CPU 页面中，查看“虚拟化”是否处于已启用状态。

如果虚拟化未开启，需要重启计算机并进入 BIOS/UEFI 设置界面，启用硬件虚拟化技术（如 Intel VT-x 或 AMD-V），否则 WSL2 及 Docker Desktop 无法正常运行。

1.3 Windows 功能和虚拟化配置（启用 WSL2 的必备步骤）#

在启用 WSL2 之前，需要确保以下 Windows 功能和虚拟化支持已正确开启：

• 适用于 Linux 的 Windows 子系统（Windows Subsystem for Linux）
• 虚拟机平台（Virtual Machine Platform）

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

3.1 在线安装#

在具备网络连接的环境中，可以先安装目标 Linux 发行版，再将其导出为镜像文件，供其他离线设备使用

1
wsl --list --online

1
以下是可安装的有效分发的列表。
2
使用“wsl.exe --install <Distro>”安装。
3

4
NAME                            FRIENDLY NAME
5
Ubuntu                          Ubuntu
6
Ubuntu-24.04                    Ubuntu 24.04 LTS
7
openSUSE-Tumbleweed             openSUSE Tumbleweed
8
openSUSE-Leap-16.0              openSUSE Leap 16.0
9
SUSE-Linux-Enterprise-15-SP7    SUSE Linux Enterprise 15 SP7
10
SUSE-Linux-Enterprise-16.0      SUSE Linux Enterprise 16.0
11
kali-linux                      Kali Linux Rolling
12
Debian                          Debian GNU/Linux
13
AlmaLinux-8                     AlmaLinux OS 8
14
AlmaLinux-9                     AlmaLinux OS 9
15
AlmaLinux-Kitten-10             AlmaLinux OS Kitten 10
16
AlmaLinux-10                    AlmaLinux OS 10
17
archlinux                       Arch Linux
18
FedoraLinux-43                  Fedora Linux 43
19
FedoraLinux-42                  Fedora Linux 42
20
Ubuntu-20.04                    Ubuntu 20.04 LTS
21
Ubuntu-22.04                    Ubuntu 22.04 LTS
22
OracleLinux_7_9                 Oracle Linux 7.9
23
OracleLinux_8_10                Oracle Linux 8.10
24
OracleLinux_9_5                 Oracle Linux 9.5
25
openSUSE-Leap-15.6              openSUSE Leap 15.6
26
SUSE-Linux-Enterprise-15-SP6    SUSE Linux Enterprise 15 SP6

1
wsl --install Ubuntu

3.2 导出 Linux 发行版镜像文件#

在完成 Ubuntu 安装后，可以将该发行版导出为标准的 rootfs 镜像文件，以便在离线环境中导入使用
如果计划在离线环境中使用该发行版，建议在联网状态下提前完成所需软件的安装与环境配置，再进行导出
该方法同样适用于日常 Linux 发行版的备份与迁移
在导出前，建议先停止对应的发行版：

1
wsl --terminate Ubuntu

然后执行导出命令： WSL 导出发行版镜像文件的命令是 wsl --export <发行版名称> <导出的 tar 文件路径>

1
wsl --export Ubuntu ./Ubuntu.tar

该命令会将 Ubuntu 发行版完整导出在当前目录下的 Ubuntu.tar 文件中，可用于后续的离线导入或迁移

3.3 安装 Linux 发行版镜像文件#

如果已经完成发行版镜像文件的导出，则可以在任意已经完成 WSL 配置的机器上进行导入
通过该方式可以自定义发行版磁盘文件的存储位置，避免在线安装时默认在系统盘（通常为 C 盘）创建磁盘文件，占用大量空间

WSL 导入发行版镜像文件的命令是：wsl --import <发行版名称> <安装目录> <镜像文件路径> [--version 2]

其中：

• <发行版名称>：导入后在 WSL 中显示的名称，可自定义
• <安装目录>：发行版解压后的虚拟磁盘与数据存放目录（需提前创建）
• <镜像文件路径>： 发行版镜像文件的存放位置
• --version 2：指定导入的发行版使用 WSL 2（推荐）

将 Ubuntu.tar 镜像文件导入为名为 Ubuntu-offline 的发行版，安装目录为 D:\WSL\Ubuntu ：

1
mkdir D:/WSL/Ubuntu
2
wsl --import Ubuntu-offline D:/WSL/Ubuntu ./Ubuntu.tar --version 2

导入完成后，可通过以下命令确认发行版状态：

1
wsl -l -v

示例输出：

1
NAME             STATE     VERSION
2
Ubuntu-offline   Stopped   2

3.4 使用 .AppxBundle 文件进行离线安装#

NOTE

需要完成 WSL 配置后才可以使用此方法

本质上通过 MicroSoft Store 安装也是通过 .AppxBundle 文件进行安装，因此可以通过下载 Linux 发行版对应的 .AppxBundle 安装包进行离线安装

1
Add-AppxPackage ./Ubuntu_2404.1.0.0_x64.AppxBundle

1
Add-AppxPackage ./Ubuntu_2404.1.68.0_x64.appx

1
wsl -l -v

1
NAME             STATE     VERSION
2
Ubuntu   Stopped   2

5.1 下载并安装 Docker Desktop#

访问 Docker 官网下载 Docker-Desktop：

https://www.docker.com/products/docker-desktop/

下载完成后在需要安装的机器上双击应用进行安装，安装时注意勾选 Use WSL Instead Of HyperV 或 Use WSL 2 based engine

5.2 Docker 使用#

安装完成之后，启动 Docker Desktop ，如果 WSL 配置没有问题，则可以进入到 Docker Desktop 界面
此时 Docker 已安装完成，可以正常使用

5.3 配置 Docker 镜像源（在线使用）#

打开 Settings → Docker Engine
在 JSON 配置中添加如下配置，注意如果有其他内容存在则需要在其他项目的结尾添加 ,
示例加速链接为 毫秒镜像 - 专为中国开发者提供的专业容器仓库服务

1
{
2
    "registry-mirrors": ["https://docker.1ms.run"]
3
}

点击右下角的 “Apply & Restart” 按钮重启 Docker
等待 Docker 重启完成
可以通过CMD或终端，查看配置是否生效：检查Registry Mirrors是否存在对应的加速源

1
docker info