Docker Desktop 在 Windows 上的安装与配置指南
前置要求:安装 WSL2 与 Linux 发行版
在 Windows 上使用 Docker Desktop 依赖 WSL 2 作为后端运行环境。因此,在安装 Docker Desktop 之前,需要先安装 WSL 2 并配置至少一个 Linux 发行版(如 Ubuntu)。
启用 WSL 和虚拟机平台
- 打开任务管理器查看是否开启虚拟化,此设置通常默认开启。
- 进入程序和功能界面,点击启用或关闭 Windows 功能。
- 找到并勾选以下两项,然后点击确定,系统将开始应用更改。随后会弹出提示要求重启计算机,点击立即重新启动以完成设置:
- 适用于 Linux 的 Windows 子系统
- 虚拟机平台 / Windows 虚拟机监控程序平台
- 重启完后再打开 Windows 功能查看是否有 Hyper-V 选项,没有的话需要手动安装 Hyper-V。
安装 Hyper-V
Windows 11/10 家庭中文版中 Hyper-V 默认隐藏,可通过命令开启。
- 在桌面创建
hyper-v.cmd文件,内容如下:
pushd "%~dp0"
dir /b %SystemRoot%\servicing\Packages\*Hyper-V*.mum >hyper-v.txt
for /f %%i in ('findstr /i . hyper-v.txt 2^>nul') do dism /online /norestart /add-package:"%SystemRoot%\servicing\Packages\%%i"
del hyper-v.txt
Dism /online /enable-feature /featurename:Microsoft-Hyper-V-All /LimitAccess /ALL
- 以管理员身份运行该脚本。
- 等待执行结束后,再次打开启用或关闭 Windows 功能查看 Hyper-V 选项是否开启,点击确定即可。
安装 WSL2
检查 Windows 版本
在 PowerShell 或运行(Win + R)中输入:
winver
WSL2 需要至少满足 Windows 22H2 或更高版本。
手动升级 Windows
如果版本不满足,可访问 Microsoft 官网下载 Windows 11 安装助手进行升级。升级完成后再次检查版本。
更新 WSL 内核
以管理员身份运行 PowerShell,输入:
wsl --version
如果版本不是 2.0 以上或不显示版本信息,需要更新 WSL。请确保网络连接稳定。
wsl --update
安装 Linux 系统
继续以管理员身份运行 PowerShell,运行 wsl --install。
wsl --install
如果此命令无法运行,可尝试列出可用发行版并指定安装:
wsl --list --online
wsl --install -d Ubuntu-24.04
Windows 10 可能需要设置默认版本为 2:
wsl --set-default-version 2

