说实话在Windows上跑Docker这事儿在几年前真的是折腾。那时候你要么装个VirtualBox再跑一层Docker Toolbox要么用Hyper-V后端启动慢、内存吃紧、文件挂载还容易出幺蛾子。直到WSL2成熟起来、Docker Desktop默认走WSL2后端之后Windows上的容器开发体验才算真正能打。如果你最近也在捣鼓这个——刚接触Docker、想在本机跑MySQL/Redis/ES这些中间件或者单纯被网上各种旧教程坑得头疼——那这篇就是给你写的。下面这套流程我用过不止一次从全新Windows系统到已经装了Docker Desktop但天天卡死的机器都处理过。我会把原理、安装、配置、实战、排查一条龙讲清楚照着操作基本能一步到位。1. 方案选型为什么是WSL2加Docker Desktop1.1 WSL2到底是什么WSL2Windows Subsystem for Linux 2本质上是一个运行在轻量级虚拟机里的完整Linux内核。它跟WSL1最大的区别是WSL1只是把Linux系统调用翻译成Windows系统调用模拟出来的环境很多内核级的功能比如Docker需要的overlayfs、iptables都跑不流畅WSL2是微软自己维护的一个真实Linux内核跑在Hyper-V虚拟化平台上除了启动比VMware、VirtualBox快好几个量级之外跟真实的Ubuntu服务器几乎没区别。所以Docker在WSL2里能跑得稳不是偶然是因为WSL2提供了一个真正能承载容器运行的Linux环境。你用Docker Desktop的时候Windows上的Docker CLI其实是在Windows侧而真正跑容器的Docker Engine是跑在WSL2那个小虚拟机里的两边通过一个套接字连接。1.2 为什么默认选Docker Desktop而不是在WSL2里装Docker Engine每次说到这个都有人杠说直接在WSL2里apt install docker.io不就行了吗确实行但有几个痛点你需要自己负责Docker Engine和containerd的升级维护Docker Desktop这边是自动更新。K8s单机版、Docker Compose、Buildx这些插件Docker Desktop是打包好的在WSL2里装这些还得额外配。文件互操作、端口自动转发、资源视图、日志清理这些体验Docker Desktop做得更完善。Docker Desktop支持把多个WSL2发行版纳入管理你在Ubuntu里跑容器在Debian里也跑容器都能统一操作。当然如果你极度反感GUI、喜欢纯命令行控制一切那在WSL2里装原生Docker Engine也不是不行这个我后面会提。但新手或者大多数日常开发场景Docker Desktop绝对是最省事的路径。1.3 三种容器运行方案的横向对比方案底层实现启动速度内存占用体验评级Docker Toolbox基于VirtualBox完整虚拟机 Boot2Docker慢分钟级固定分配很占不推荐历史遗留Docker Desktop Hyper-V后端Hyper-V虚拟机较快固定分配还行但和VMware冲突Docker Desktop WSL2后端WSL2轻量虚拟机秒级动态按需占用强烈推荐实测下来WSL2的后端让你开机不用主动启动Docker Desktop只要你打开终端执行docker命令Docker引擎会自动醒来基本感知不到虚拟机的存在。2. 安装前的环境准备2.1 检查系统版本和虚拟化支持先确认你的Windows能不能用WSL2要求是Windows 10 2004及以上内部版本号19041以上Windows 11更不用说。右键“此电脑”选属性或者按WinR输入winver就能看到。然后是CPU虚拟化。这个检查方法很简单打开任务管理器点“性能”选项卡看“CPU”——右下角有“虚拟化已启用”就是开了。如果显示未启用就得进BIOS里找Intel Virtualization Technology英特尔平台或者SVM ModeAMD平台把它设为Enabled。这一步很多人忽略但非常关键。WSL2依赖虚拟化功能BIOS里没开后面怎么装都跑不起来。2.2 启用Windows功能接下来需要开启两个Windows特性“适用于Linux的Windows子系统”和“虚拟机平台”。最快的办法是用管理员身份打开PowerShell或终端执行dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart如果系统提示需要重启先重启然后再往下走。这里我插一句网上很多教程是让去“控制面板-程序-启用或关闭Windows功能”里勾选也行但那个界面每次加载都慢而且手动勾容易少选。用命令最稳一次搞定。2.3 更新WSL到最新版本老版本的WSL需要手动安装内核升级包新版本的Windows 11和更新后的Windows 10直接用wsl命令就能更新。建议先确认一下wsl --version如果你看到的是带版本号的信息比如WSL版本1.2.x说明已经是新版本。如果提示“WSL正在进入维护模式”或者只显示“没有已安装的分发版”就执行wsl --update没有管理员权限的话还可以去微软官方GitHub Release页面手动下载WSL2的MSI安装包这个是离线安装的办法适合内网机器。3. 安装WSL2和Ubuntu发行版3.1 一条命令装好WSL2在新版本WSL里安装默认发行版就一条命令wsl --install这条命令会自动做三件事启用前面说的两个Windows功能、下载最新WSL2内核、安装默认的Ubuntu发行版。装完重启系统会弹出一个Ubuntu窗口让你设置初始用户名和密码。如果你想指定其他发行版先看看有哪些可选wsl --list --online然后指定安装比如wsl --install -d Ubuntu-22.04对于国内网络环境个别时候从商店下载发行版慢得离谱。我的建议是能直接用wsl --install就先直接装如果卡住打开微软商店搜Ubuntu 22.04.5 LTS手动安装或者从微软官方的WSL发行版下载页拿离线安装包。3.2 设置WSL默认版本为2安装完Ubuntu后记得把默认版本切到2。虽然新版WSL2默认就是2但如果你的发行版是从老环境升级过来的可能还是用的WSL1需要手动转wsl --set-version Ubuntu-22.04 2转换过程需要一两分钟中途别关窗口。之后可以用这条命令验证所有发行版的状态wsl --list --verbose看到VERSION列显示2就对了。如果VERSION列是1检查一下是否前面忘了开启虚拟机平台功能。3.3 Ubuntu初始化的一些经验首次进入Ubuntu会让你创建用户名和密码。这里有个小技巧用户名不需要和Windows用户名一致因为WSL内部有独立的用户体系。密码输入时屏幕不显示内容正常输入后回车就行并非常规所见即所得。进来之后建议先做两件事sudo apt update sudo apt upgrade -y然后安装一些常用工具比如网络排查工具、文本编辑器sudo apt install -y net-tools curl wget vimUbuntu窗口里输入exit退出Windows终端里输入wsl又可以重新进来。你现在就有了一个Linux环境可以使用之后Docker容器都跑在这个环境里和Windows的互动也完全透明。3.4 常用WSL2管理命令我把平时用最多的几个命令整理出来避免以后找不到意图命令查看所有发行版和版本wsl --list --verbose启动默认发行版wsl关闭WSL释放内存wsl --shutdown设置默认发行版wsl --set-default Ubuntu-22.04在WSL内执行命令wsl -d Ubuntu-22.04 -- uname -a导出发行版为tarwsl --export Ubuntu-22.04 D:\wsl-ubuntu.tar从tar导入发行版wsl --import Ubuntu-Docker D:\wsl-docker D:\wsl-ubuntu.tar这个导出导入功能我特别推荐处理Docker镜像导致WSL虚拟磁盘vhdx文件膨胀的场景后面排查部分会细说。4. 安装Docker Desktop4.1 下载与安装去Docker官网下载Docker Desktop for Windows的安装包下载地址docker.com/products/docker-desktop/下载下来的文件一般是几百MB的exe。双击安装走到配置页面时有两个选项需要注意勾选“Use WSL 2 based engine”——这是核心技术点用WSL2后端。“Add shortcut to desktop”按需勾选。安装完之后不一定立刻要求重启但建议重启一下让系统状态彻底干净。之后打开Docker Desktop它会自动初始化WSL2后端。然后到设置里确认一下Settings - General - Use the WSL 2 based engine确认是选中状态。4.2 配置WSL集成为了让Ubuntu里的终端能直接用docker命令需要打开Settings - Resources - WSL Integration。在“Enable integration with my default WSL distro”处打勾然后选择你安装的发行版比如Ubuntu-22.04应用并重启Docker Desktop。这样你在Ubuntu终端里敲docker --version就能看到版本信息不需要额外装任何东西。4.3 验证安装打开Windows终端PowerShell或Ubuntu都行执行docker --version docker compose version然后跑一个hello-world验证引擎是否正常docker run hello-world第一次运行会从远程仓库拉取镜像网络状况不好时可能卡住看到“Unable to find image hello-world:latest locally”之后等一会儿能打印出“Hello from Docker!”就说明整个链路通了。4.4 配置镜像加速国内拉取Docker Hub镜像经常很慢这是个老生常谈的问题。Docker Desktop在Windows下配置镜像加速很简单打开Settings - Docker Engine把registry-mirrors配置写进JSON里然后点击“Apply restart”。{ registry-mirrors: [ https://docker.m.daocloud.io, https://dockerproxy.com, https://docker.mirrors.ustc.edu.cn ] }这里我多说一句公共镜像加速站有时效性挂了就换一个原理就是让Docker拉镜像时先去这些代理仓库找缓存。配置完之后拉镜像的速度通常会好很多但具体多少还得看你自己网络和对方镜像站的状态。5. 实战用Docker Compose部署MySQL 8.0安装完Docker不能只放着看很多人折腾这个就是为了在Windows上跑一些中间件最典型的就是MySQL。我用Docker Compose来演示因为这种方式可复现、可配置、不会散落在各种docker run命令里。5.1 准备项目目录和docker-compose.yml先在WSL的Ubuntu里建一个目录来统一放这些容器编排文件mkdir -p ~/docker-services/mysql8 cd ~/docker-services/mysql8 vim docker-compose.yml把下面这个配置贴进去services: mysql8: image: mysql:8.0 container_name: mysql8 restart: always environment: MYSQL_ROOT_PASSWORD: root123456 TZ: Asia/Shanghai command: --character-set-serverutf8mb4 --collation-serverutf8mb4_unicode_ci --default-time-zone08:00 ports: - 3306:3306 volumes: - ./data:/var/lib/mysql - ./conf:/etc/mysql/conf.d - ./logs:/var/log/mysql healthcheck: test: [CMD, mysqladmin, ping, -h, localhost, -proot123456] interval: 10s timeout: 5s retries: 5简单拆解几个关键参数restart: alwaysDocker启动或重启后容器自动拉起不用手动启动。MYSQL_ROOT_PASSWORD初始化时设定root密码。command里的参数指定MySQL服务端的字符集为utf8mb4排序规则为utf8mb4_unicode_ci这是为了能正常存储emoji和中文很重要。ports宿主机3306端口映射到容器3306这样Windows上的Navicat、DataGrip、DBeaver就能直接连localhost:3306。volumes把宿主机当前的data、conf、logs目录挂载进容器数据库文件不因容器删除而丢。5.2 启动MySQL在docker-compose.yml所在目录执行docker compose up -d-d表示后台运行。第一次会拉取mysql:8.0镜像耐心等一会儿。启动完成后docker compose ps看到STATUS为Uphealthy基本就成了。再验证一下端口ss -tlnp | grep 3306或者直接在Windows上用数据库客户端连localhost:3306。如果连接不上先排查Docker Desktop是否处于Running状态再排查Windows防火墙是否拦了3306入站。5.3 连接测试Ubuntu里可以直接用容器内的mysql客户端测试docker exec -it mysql8 mysql -uroot -proot123456进入MySQL后执行SHOW VARIABLES LIKE character%;看到collation_server是utf8mb4_unicode_ci就是配置生效了。5.4 更多可复用的场景还是这套compose玩法可以继续扩展Redisredis:7镜像加一个redis.conf挂载进去就可以玩主从或哨兵。Elasticsearchelasticsearch:8.x镜像需要额外配一些jvm.options和安全管理参数后面想单独写一篇。GitLabgitlab/gitlab-ce镜像配置比较多内存占用也大但用compose管起来最省心。端口、数据卷、密码、镜像版本都按需调整一套逻辑通吃。6. 常见问题与排查技巧6.1 WSL2无法启动提示“此计算机上未启用虚拟化”这个提示我在帮别人处理时遇到过好几次。按顺序检查任务管理器-性能-CPU确认“虚拟化已启用”。没有就去BIOS开VT-x或SVM。Windows功能里确认“虚拟机平台”已勾选。这个和Hyper-V是不同项容易漏。如果你装了VMware或VirtualBox可能跟Hyper-V/WSL2冲突。新版VMware已经优化了这个问题但老版本需要关闭Hyper-V或者反过来用Hyper-V模式跑。另外提醒一句Windows Sandbox、WSL2、Hyper-V都依赖于虚拟化层设备上同时用过其他虚拟化软件可能残留冲突。执行bcdedit /set hypervisorlaunchtype auto管理员权限下跑完重启能修复大多数“启动缓慢导致WSL无法启动”的问题。6.2 Docker Desktop一直卡在Starting有时候Docker Desktop图标一直在转就是起不来。常见原因和修复顺序确认WSL2发行版能正常启动先单独执行wsl如果能进去说明WSL没问题。关闭Docker Desktop然后在管理员PowerShell里执行wsl --shutdown再重新打开Docker Desktop。如果还是不行把 %LOCALAPPDATA%\Docker 下的日志翻出来看或者重置Docker Desktop的WSL数据Settings - Troubleshoot - Reset to factory defaults。多数情况下Docker Desktop卡死是WSL的虚拟磁盘出问题或者上次非正常关机导致的wsl --shutdown能解决大部分。6.3 Docker镜像下载慢前面说了配置registry-mirrors。除此之外还可以用代理方案但要注意有些代理工具会干扰localhost的访问导致Docker Desktop连不上引擎。我的经验是先开镜像加速不行再检查代理设置。6.4 WSL2内存占用高、积累的垃圾多WSL2的默认内存占用是总内存的50%左右而且虚拟磁盘只增不减。时间长了WSL的vhdx文件会变得超大。限制内存和CPU在你Windows用户目录下创建一个.wslconfig文件[wsl2] memory4GB processors4 swap2GB保存后执行wsl --shutdown再启动就能生效。如果发现磁盘占用异常大比如镜像和容器删了但空间没回来先清理Docker的资源docker system prune -a -f然后再压缩vhdx文件在PowerShell里执行wsl --shutdown然后用diskpart或者直接用Hyper-V的Optimize-VHD命令如果可用来压缩。最暴力的替代方案就是用wsl --export备份需要的环境后wsl --unregister重装。6.5 systemd与自启动服务的问题新版WSL2支持systemd但可能默认没开启。如果你的发行版里systemctl无法使用可以编辑/etc/wsl.conf[boot] systemdtrue然后在Windows侧wsl --shutdown重进WSL执行systemctl list-units验证。很多人在WSL里直接apt装Docker Engine后用systemctl enable docker来开机自启没有systemd的话会遇到一堆麻烦。6.6 端口访问不进容器Windows连不上WSL里容器的端口先检查映射是否正确然后看容器日志docker logs container-name如果端口被其他进程占了改一下宿主机的映射端口把3306:3306改成3307:3306这种。Windows的Hyper-V保留端口也可能导致绑定失败用netstat -ano | findstr 3306看一下占用情况。6.7 如何彻底卸载重装如果搞到最后实在不行卸载重来也是可以的。流程是卸载Docker Desktop控制面板或设置中卸载。删除残留目录%APPDATA%\Docker、%LOCALAPPDATA%\Docker。删除WSL发行版wsl --unregister Ubuntu-22.04。可选wsl --shutdown后删除 %LOCALAPPDATA%\Packages 下相关发行版的文件夹谨慎。重新走一遍安装流程通常一套下来就是干净环境了。我个人在实际操作中最后的体会就是Windows下用Docker别跟它拧着来。尽量用官方推荐的WSL2后端别折腾什么第三方虚拟化方案遇到问题先去确认WSL本身是否健康再查Docker Desktop配置。这套组合装好之后的收益非常直接——MySQL、Redis、ES、GitLab这些中间件都可以随用随开机器也保持清爽更是为以后接触K8s这些容器编排打好底子。另外如果你后面打算在Windows上跑Codex桌面版或者做AI相关的本地开发这套WSL2加Docker的环境大概率也是绕不开的底座。