作者安装软件大师适用系统Windows 11 / Windows 10 22H2安装路径D:\tools\docker一、前言Docker 是开发必备工具但 Windows 上安装 Docker Desktop 可能会遇到一些挑战——网络连接问题、WSL 迁移、UAC 权限等。本文还原了我在一台全新 Windows 11 电脑上从零安装好 Docker 的完整过程每一步都有命令和截图说明照着操作即可。二、安装前环境检查打开PowerShellWin S 搜索PowerShell逐条运行# 1. 检查 Windows 版本需要 ≥ 19045(Get-CimInstanceWin32_OperatingSystem).Version# 2. 检查系统架构需要 x64$env:PROCESSOR_ARCHITECTURE# 3. 检查 CPU 虚拟化是否已开启True已开False需进BIOS(Get-WmiObject-ClassWin32_Processor).VirtualizationFirmwareEnabled# 4. 检查 Docker 是否已安装docker--version截图参考运行(Get-WmiObject Win32_Processor).VirtualizationFirmwareEnabled后返回True才符合条件无需重启进 BIOS。检查结果参考项目要求状态Windows 版本≥ 19045✅系统架构x64✅CPU 虚拟化True✅Docker 已安装—❌ 未安装如果上面的检查都通过了继续往下。三、开启 Windows 虚拟化功能必须以管理员身份运行 PowerShell按Win X→终端管理员→ 在弹出的 UAC 窗口点是。然后依次执行# 第一步启用 WSL 子系统dism.exe/online/enable-feature/featurename:Microsoft-Windows-Subsystem-Linux/all/norestart# 第二步启用虚拟机平台dism.exe/online/enable-feature/featurename:VirtualMachinePlatform/all/norestart# 第三步启用 Hyper-Vdism.exe/online/enable-feature/featurename:Microsoft-Hyper-V/all/norestart截图参考每条命令执行后会出现蓝色的进度条完成后显示启用操作已成功完成。重启电脑Restart-Computer✅ 这一步结束你的电脑已经具备了运行 Docker 的基础条件。四、安装 WSL2 Ubuntu重启后打开普通 PowerShell不需要管理员了。4.1 设置 WSL2 为默认版本wsl--set-default-version 24.2 安装 Ubuntuwsl--install-d Ubuntu等待下载完成1-5 分钟取决于网速。关键截图Ubuntu 终端会自动弹出要求你设置用户名和密码——Enter new UNIX username: unix_sk New password: [输入密码不会显示字符] Retype new password: [再输一次]用户名建议用英文小写密码记住。4.3 验证wsl-l-v应显示NAME STATE VERSION * Ubuntu Stopped 2五、把 WSL2 迁移到 D 盘推荐避免占满 C 盘Docker 默认把 WSL 放在 C 盘如果你的 C 盘空间紧张可以迁到 D 盘。# 1. 关闭 WSLwsl--shutdown# 2. 创建 D 盘目录New-Item-ItemType Directory-Path D:\tools\docker\wsl\Ubuntu-Force# 3. 导出 Ubuntu约 1.2GB等 1-2 分钟wsl--export Ubuntu D:\tools\docker\wsl\Ubuntu\ubuntu.tar# 4. 注销 C 盘的 Ubuntuwsl--unregister Ubuntu# 5. 导入到 D 盘wsl--import Ubuntu D:\tools\docker\wsl\Ubuntu D:\tools\docker\wsl\Ubuntu\ubuntu.tar--version 2# 6. 恢复登录用户导入后默认是 root$regHKCU:\Software\Microsoft\Windows\CurrentVersion\Lxssforeach($dinGet-ChildItem$reg){if((Get-ItemProperty$d.PSPath).DistributionName-eqUbuntu){Set-ItemProperty$d.PSPath-Name DefaultUid-Value 1000}}⚠️注意第4步wsl --unregister会删除 C 盘的 Ubuntu确保第3步导出成功后再执行。六、下载 Docker Desktop6.1 准备工作安装包大小约629MB如果你在国内直接下载会被墙需要科学上6.2 使用网络加速下载由于网络环境差异直接下载 Docker Desktop 安装包可能较慢。以下提供两种下载方式方式一使用 curl 命令下载推荐# 下载到 D:\tools\dockercurl.exe-L-o D:\tools\docker\DockerDesktopInstaller.exe https://desktop.docker.com/win/main/amd64/Docker%20Desktop%20Installer.exe--connect-timeout30--max-time 3600方式二使用浏览器直接下载如果命令行下载失败也可以直接在浏览器中访问以下链接下载Docker Desktop for Windows 官方下载地址下载完成后将文件保存到D:\tools\docker\目录下。下载提示使用 curl 命令下载时会显示实时进度% Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 100 629M 100 629M 0 0 2.37M 0 0:04:24 0:04:24 2.37M正常速度 2-4 MB/s几分钟完成。如果速度持续低于 100KB/s可以尝试检查网络连接是否稳定更换网络环境如切换到手机热点使用方式二的浏览器直接下载试。6.3 验证文件完整性Get-FileHashD:\tools\docker\DockerDesktopInstaller.exe七、安装 Docker Desktop7.1 创建安装脚本新建D:\tools\docker\install_docker.bat写入以下内容echo off echo echo Docker Desktop 一键安装 echo echo. echo 安装路径: D:\tools\docker\Docker Desktop echo. echo 如果弹出 UAC 窗口请点击是 echo. start /wait D:\tools\docker\DockerDesktopInstaller.exe ^ install --quiet --accept-license ^ --installation-dirD:\tools\docker\Docker Desktop echo. echo 安装完成 (返回码: %errorlevel%) pause7.2 运行安装双击install_docker.bat。关键截图会弹出 UAC 窗口——“你要允许此应用对你的设备进行更改吗”点是。安装过程约 3-5 分钟不需要其他操作。7.3 重启电脑安装完成后重启电脑。重启后 Docker Desktop 会自动启动右下角任务栏会出现 图标。八、验证安装打开新的PowerShell 窗口旧窗口需要关掉重开依次输入docker--version输出示例Docker version 28.0.4, build ...docker compose version输出示例Docker Compose version v2.35.0 ...docker info输出示例一大段 Docker 配置信息能看到Server Version: 28.0.4docker run hello-world输出示例Hello from Docker! This message shows that your installation appears to be working correctly. ...四个命令全部成功 →恭喜Docker 装好了九、常见问题排查Q1下载速度慢或连接失败检查网络连接是否正常尝试使用稳定的网络环境确保防火墙或安全软件没有阻止下载Q2下载速度太慢100KB/s当前网络到 Docker 服务器速度较慢可以尝试更换网络环境如切换到手机热点在网络状况较好的时段重试使用浏览器直接下载方式二Q3WSL 导出失败# 先启动一次 Ubuntuwsl-d Ubuntu-u root--ls/wsl--shutdown# 再导出wsl--export Ubuntu D:\tools\docker\wsl\Ubuntu\ubuntu.tarQ4WSL 迁移后变成 root 登录按第5节第6步设置 DefaultUid1000Q5安装后 docker 命令找不到关掉当前 PowerShell重新打开一个Q6UAC 弹窗没点安装失败回到第7节重新双击install_docker.bat这次记得点是十、最终效果安装完成后的目录结构D:\tools\docker\ ├── Docker Desktop\ ← 安装的程序≈600MB ├── wsl\Ubuntu\ │ ├── ext4.vhdx ← Ubuntu 系统文件1.4GB │ └── ubuntu.tar ← 备份可删除 ├── DockerDesktopInstaller.exe ← 安装包可删除 └── install_docker.bat ← 安装脚本可删除Docker 验证结果docker--version → Docker version 28.0.4 docker compose version → Docker Compose version v2.35.0 docker run hello-world → HellofromDocker! ✅十一、参考链接Docker Desktop 官方文档WSL 安装文档如果这篇文章对你有帮助欢迎点赞、收藏、评论三连有任何安装问题评论区留言我看到就回复。
