先说结论:在Windows上装Docker,绕不开WSL 2。很多朋友第一次折腾Docker部署,卡在环境搭建这一关,不是Docker Desktop安装失败,就是启动报“virtualization support not detected”,再或者wsl --install跑半天没反应。这篇博文我按自己实际部署的流程从头梳理了一遍,把Windows系统准备、WSL 2安装、Docker Desktop配置、镜像加速、以及一整套实战验证步骤都写清楚,中间还穿插了几个翻车现场和排查方法。适合刚接触Docker、打算在Windows上搞一套开发环境的朋友参考,已经装了但启动有问题的也可以直接跳到对应小节看。
1. 环境摸底与方案选型:为什么是WSL 2
1.1 先搞清楚你的Windows版本和硬件
Docker在Windows上有两条路,一条是传统的Hyper-V后端,另一条是WSL 2后端。Hyper-V方案要求系统必须开启Hyper-V功能,会占内存,而且和很多虚拟化软件冲突;WSL 2方案靠的是轻量级虚拟机,启动快、内存占用可控,和Windows Terminal、VSCode的配合也更顺手一些,所以现在官方默认推荐的就是WSL 2后端。
硬件和系统方面,你只需要满足这几个条件:
- Windows 10 2004(Build 19041)及以上,或者Windows 11
- 系统是64位,且CPU支持虚拟化并在BIOS中已开启
- 内存建议至少8G,实际跑Docker容器8G有点紧,16G会更从容一些
- 安装时确保磁盘有足够剩余空间,Docker Desktop本身占几个G,镜像和数据卷是大头
如果你用的是Windows 10 LTSC或者Windows Server,也能装,但步骤略有不同。LTSC默认不带WSL所需的内核组件,后面执行wsl --update时可能需要手动处理,这个我们在排查章节单独讲。
1.2 WSL 2相比WSL 1和Hyper-V方案到底强在哪
我先用自己的话把这三个方案的区别讲明白,选型就清晰了。
- WSL 1:通过系统调用转换层兼容Linux程序,不需要虚拟化,但网络和I/O性能和真实的Linux环境差得远。跑个MySQL、Redis还行,跑Docker这种依赖完整内核特性的工具就吃力了。
- WSL 2:在轻量级虚拟机里跑一个完整的Linux内核,系统调用完全兼容,Docker容器本质上就是一个进程,直接依托内核能力运行,性能和裸机Linux非常接近。
- Hyper-V方案:本地所有容器都跑在Hyper-V虚拟机里,多一层虚拟化,启动慢,内存开销大,而且Hyper-V一旦开启,VirtualBox、VMware这些工具全部会失灵。
所以我个人建议,只要系统和CPU支持,无脑选WSL 2。
1.3 为什么我不建议用老的Docker Toolbox
早年间Windows上装Docker只能靠Docker Toolbox,它集成的是VirtualBox虚拟机,安装后从虚拟机里转发端口到Windows。这一套在当年确实是个办法,但现在官方已经停止维护了,和Docker Desktop相比没有任何优势:不支持Docker Compose v2、容器内网络问题多、文件挂载性能差、升级麻烦。这篇教程里我没有再提Toolbox,纯粹是基于2025年这个时间点,它已经完全没有折腾的必要了。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 动手前先把虚拟化和WSL服务弄明白
2.1 确认CPU虚拟化是否已开启
很多人卡在Docker Desktop启动报错,第一句就是“virtualization support not detected”。这句话翻译过来就是:你的CPU虚拟化没打开。怎么看呢,最简单的办法是打开任务管理器,切到“性能”标签页,点“CPU”,右下角会显示“虚拟化:已启用/已禁用”。
如果显示“已禁用”,需要重启进BIOS开启。Intel的CPU找Intel Virtualization Technology(VT-x),AMD的CPU找SVM Mode,不同主板菜单名不一样,但基本都是这两个关键词。开启后保存重启,再次打开任务管理器确认已启用。
这里有个坑:部分品牌机(尤其是某些轻薄本)BIOS里把虚拟化选项藏得很深,或者默认锁死。这时候可以去Windows功能里勾选“Windows 虚拟机监控程序平台”,重启完再查一次,部分场景下能绕过去,但不是每台机器都适用,后面排查表里我再细化。
2.2 用一条命令安装WSL
确认虚拟化已经开启之后,打开PowerShell,右键选择“以管理员身份运行”,执行:
powershell复制wsl --install
如果系统版本比较新,这条命令会一次性完成三件事:启用WSL功能、安装最新版Linux内核
