Docker Desktop 4.55.0 我装完了前前后后折腾了小半天从下载安装到容器跑起来中间踩了几个不大不小的坑。这篇就把整个安装过程、关键配置和踩坑记录一次性讲清楚正在装这个版本的同学可以直接照抄。先说结论这版本整体装起来不算难但成败往往不在安装本身而在安装前的环境准备。老手翻车也多半翻在 WSL2 状态和镜像拉取这两关。为了不浪费大家时间我按“装前自查—安装配置—装后验证—问题排查”的顺序写最后附几条我这几年用 Docker Desktop 养成的省心习惯。1. 安装前自查版本、硬件与系统环境1.1 4.55.0 到底更新了什么值不值得升级说实话Docker Desktop 这个版本更迭已经不像前几年那么激进了很多用户还停在一个自己用熟的版本上懒得动。4.55.0 从更新说明来看并没有那种让人眼前一亮的革命性功能它主要解决的是几个老版本里比较闹心的问题一是提升了 WSL2 后端在 Windows 11 新系统上的兼容性二是修了若干容器网络偶发断连的问题三是对 UI 做了些细节调整把一些入口藏得更顺手了。对新装机器来说直接上 4.55.0 是省心的选择。但如果你当前版本用得很稳工作流也正常其实不用急着追新。我见过有人为了尝鲜升级结果把一堆正在跑的容器环境搞挂最后又降级回去。Docker Desktop 这种基础设施类工具稳妥比新鲜重要得多。升级前如果机器上跑着重要容器建议先备份 compose 项目目录和数据卷再动手。1.2 硬件与系统检查清单装 Docker Desktop 有点像给电脑请一位管家管家来之前你得先把水电通气都弄好。我总结了一套安装前的硬性条件满足以后成功率几乎是百分之百操作系统Windows 10 64 位 2004 版及以上或者 Windows 11。老系统先把系统更新装完再装 Docker不然容易触发一堆兼容问题。CPU 虚拟化任务管理器 → 性能 → CPU确认右下角“虚拟化”显示“已启用”。如果显示“已禁用”需要进 BIOS 打开 VT-x 或 AMD-V这一步不搞定后面啥都白搭。内存建议 8GB 起步。Docker Desktop 加 WSL2 默认分配内存比较大方4GB 内存的机器要么先升级内存要么装完马上按后面第三节的方法把内存限制住。磁盘预留 20GB 以上。镜像、容器、数据卷都堆在磁盘里C 盘空间太紧后面拉几个大镜像就哭。WSL2 内核Windows 10 需要手动安装 WSL2 Linux 内核更新包Windows 11 一般自带或可以通过 wsl --update 更新。还有一个容易忽略的点Windows 功能里要开启“虚拟机平台”和“适用于 Linux 的 Windows 子系统”这两个可选功能。没开的话安装时 Docker Desktop 也会提示你但提前开好能省一次重启。检查方式是在 PowerShell 里执行wsl --status能正常返回就说明基础环境没问题。1.3 老版本要不要先卸载干净如果你机器上装过旧版 Docker Desktop或者当年手动装过 Docker Toolbox不要直接覆盖安装。最简单稳妥的做法是先去 Windows 设置的“应用”里卸载 Docker Desktop然后重启再检查几个常见位置有没有残留。常见残留位置包括C:\Program Files\Docker%APPDATA%\DockerDocker Desktop 的配置目录%LOCALAPPDATA%\DockerWSL 相关数据和更新缓存系统环境变量里的 Docker 相关路径如果只想轻量清理删掉 %APPDATA%\Docker 里面的 settings.json 就能把配置重置成默认状态比整个删除温柔很多。这个技巧在排查奇奇怪怪的启动问题时特别管用后面第 4 节还会再提到。2. 下载安装与初始化一步步装到能跑2.1 下载渠道与安装包类型下载渠道我只推荐一条Docker 官网的 Docker Desktop 页面。不要从各种软件站、下载站搞什么“绿色版”“汉化版”这些来路不明的安装包轻则装完一堆捆绑重则被人塞了私货。Docker Desktop 安装时会落很多文件还是需要提权的软件安全上别偷懒。下载时注意区分稳定版和预览版。日常开发或办公环境认准 StablePreview 版本适合爱折腾的朋友但别指望它有多稳定今天能用明天可能就崩。4.55.0 属于稳定版序列下载时看文件名里带不带 beta 或 preview 字样就行。安装包体积不算小下载时耐心等。如果反复下载失败多半是你的网络到官方下载服务器不稳定换个时间段再试别从第三方镜像站搞安装包。2.2 安装向导里的选项怎么选双击安装包以后安装向导会问两个问题这里分别说Use WSL 2 instead of Hyper-V这一项在 4.55.0 里基本是默认推荐项。除非你有老项目强制要求 Hyper-V 后端否则保持勾选。WSL2 的启动速度、内存弹性和兼容性都比老 Hyper-V 模式好不少。打个比方Hyper-V 后端像一个自带餐厅的酒店什么都有但开销大WSL2 更像一个可以随时叫外卖的公寓灵活还省资源。Add shortcut to desktop按个人习惯勾选不影响使用。安装向导还可能让你勾选安装 Windows 组件比如 WSL 相关组件。按提示勾上就好。安装完成后如果提示重启别偷懒先重启再继续。这一步很多人跳过结果启动 Docker 时各种报错回头还得回来补重启。安装过程中最好保持网络畅通。安装器在需要时可能会拉取 WSL 相关的组件或内核更新断网容易导致静默失败装完了才发现少东西。2.3 首次启动与引擎初始化安装完后第一次启动 Docker Desktop会经历两个阶段。第一阶段是接受服务条款。公司商业用途要注意许可协议类型个人学习用没什么限制直接 Accept 即可。第二阶段是引擎初始化。任务栏会多出一个鲸鱼图标图标转圈就表示 Docker Engine 正在启动。首次启动可能耗时几十秒到一两分钟因为它要创建 WSL2 的发行版、生成 docker-desktop 分发包再把 Docker daemon 拉起来。这个过程不用一直盯着正常状态下它会自己完成。如果在初始化阶段弹出和 WSL2 相关的错误先不要慌。多数情况是系统缺 WSL2 Linux 内核更新包Windows 10 用户去下载安装内核更新包Windows 11 用户在管理员 PowerShell 里执行wsl --update然后重启 Docker Desktop 再试。我遇到过一次启动后一直停在“Docker Engine starting”的情况这个在第 4 节有专门排查思路。3. 安装后的验证与配置让 Docker 真正好用3.1 三条命令验证安装成功打开终端PowerShell 或 CMD 都行依次执行下面三组命令就能判断安装是否真的成功。docker --version这条命令确认 Docker CLI 客户端版本能输出版本号就说明基础安装没跑偏。docker info这条命令会输出 Docker 引擎的详细信息重点看 Server Version、Operating System 和 Docker Root Dir。如果这里能正常输出说明 Docker daemon 已经在跑WSL2 后端工作正常。docker run hello-world这是最直观的冒烟测试。它会先从镜像源拉取一个 hello-world 小镜像然后在容器里运行并打印一段欢迎信息。看到“Hello from Docker!”就说明 CLU、daemon、WSL2、镜像拉取、容器运行这一整条链路全部通畅。如果你的网络环境不太理想第三步可能会卡在拉镜像那一步。这其实正好引出下面的内容——多数情况下不是 Docker 坏了而是镜像拉得太慢或者干脆拉不动。3.2 配置镜像源从“拉不动”到“秒拉”Docker Desktop 默认从 Docker Hub 拉镜像但 Docker Hub 的服务节点不在国内网络高峰期拉个大镜像确实煎熬。解决办法是给 Docker Engine 配置镜像源这是正规做法不会影响 Docker 本身的稳定性。操作位置在 Docker Desktop 右上角设置齿轮图标 → Docker Engine右侧会显示一份 daemon.json在里面增加或修改 registry-mirrors 字段。一份带镜像源配置的 daemon.json 长这样{ registry-mirrors: [ https://docker.mirrors.example.cn ] }配置完成后点击 Apply RestartDocker 会用新配置重启引擎然后拉镜像的速度会有肉眼可见的改善。这里要强调一句镜像源地址建议去国内主流云服务商的容器镜像服务控制台申请每个账号能拿到专属地址比公共地址稳定。不要随便在网上找来路不明的第三方镜像源一是速度不一定快二是有数据安全风险。还有一个容易误解的点镜像源只影响 Docker Hub 官方镜像的拉取速度。如果你要拉公司内网私有镜像仓库的内容那是另一回事要在 daemon.json 里配置 insecure-registries 之类的参数和镜像源互不干扰。别指望配了镜像源就能拉私有仓库那是两码事。3.3 资源占用与 WSL2 内存限制Docker Desktop 默认的资源占用策略是“能用多少用多少”这在开发机上很容易翻车。尤其是 WSL2 后端内存分配压力大的时候能吃掉大半个物理内存电脑直接卡成 PPT。打开 Docker Desktop 设置里的 Resources 页面有 CPU、内存、Swap 和 Disk image size 四个滑块。我的建议是内存设成物理内存的一半到三分之二比如 16GB 内存的机器给 8GB 到 10GB。不要给太少Java 应用或者前端构建工具在容器里跑起来很吃内存给少了容器会频繁 OOM。想更进一步控制 WSL2 本身的资源可以在用户目录下新建一个.wslconfig文件内容类似[wsl2] memory8GB processors4 swap2GB保存后用wsl --shutdown重启 WSL 使配置生效。这里面的逻辑是Docker Desktop 跑在 WSL2 里WSL2 能不能限制内存靠的是 .wslconfig而 Docker Desktop 设置页里的 Resources则作用于它自己生成的 WSL 发行版。优先看 Docker Desktop 设置如果发现不生效再检查 .wslconfig 是不是写错了。4. 高频问题排查与避坑建议4.1 WSL2 相关报错速查安装和启动阶段遇到 WSL2 相关报错是最常见的我把典型情况整理成一张速查表。现象原因解决方式首次启动提示 WSL 2 installation is incomplete系统缺少 WSL2 Linux 内核更新包或内核版本太老下载安装内核更新包或在管理员 PowerShell 执行 wsl --update重启 Docker Desktopwsl --status 显示默认版本是 1WSL 默认版本没设成 2管理员 PowerShell 执行 wsl --set-default-version 2启动后引擎一直未运行docker info 报错Docker Desktop 没有完成引擎初始化右键托盘鲸鱼图标退出任务管理器结束所有 com.docker 开头进程再重启 Docker Desktop执行 wsl 命令提示找不到文件WSL 服务或系统组件异常重启电脑或以管理员身份重新执行 wsl --install 修复这些问题的共同点是Docker Desktop 本身并没有坏而是它底下依赖的 WSL2 环境不完整。先解决 WSL2再解决 Docker顺序别搞反。4.2 镜像拉取失败与 DNS 问题镜像拉不下来我按出现频率排个序方便你自己定位第一种拉取超时、握手失败。十有八九是网络问题。先把 Docker Desktop 刚配的镜像源检查一遍确认 daemon.json 里 registry-mirrors 写的是 HTTPS 地址且没写错然后重启引擎。还不行试着直接访问一下镜像源地址能通就是 Docker 配置问题不能通就是网络或 DNS 问题。第二种DNS 解析异常。在 PowerShell 里执行nslookup registry-1.docker.io看看能不能解析出 IP 地址。解析失败的话把 Windows 的 DNS 临时改成公共 DNS 再试。改完 DNS 记得刷新缓存命令是ipconfig /flushdns。第三种磁盘空间不足。镜像拉取是流式写入磁盘的磁盘满了会报各种奇怪的写入错误。用docker system df看下磁盘占用分布该清理就清理。这种情况在开发机 C 盘只剩几个 GB 的时候特别常见。4.3 Docker 虚拟磁盘越来越大的清理方案Docker Desktop 用久了C 盘空间会莫名其妙地减少基本就是 Docker 的 WSL2 虚拟磁盘在膨胀。镜像是分层存储的反复构建、删除操作会让虚拟磁盘越来越大即使你删了镜像已分配的磁盘空间也不会自动回收。我的建议分三步走第一步日常清理。执行docker system prune -a --volumes会清掉悬空镜像、停止的容器、无主数据卷和构建缓存。这个命令比较激进跑之前确认没有需要保留的数据。只想温和一点就别带 -a 和 --volumes。第二步重置 Docker Desktop。如果日常清理不顶事可以在设置里的 Troubleshoot 页面用 Clean / Purge data 把整个 Docker 数据清掉重来。这个方法适合开发环境但如果有重要数据卷动手前一定先备份。第三步压缩虚拟磁盘。先用wsl --shutdown停掉 WSL然后用磁盘工具把 C 盘下 Docker 的 docker_data.vhdx 文件挂载为只读执行压缩操作再分离。这个操作有点底层新手不建议碰暴力的替代方案是调整 Docker Desktop 的 Disk image size 设置让它重新整理一次虚拟磁盘。4.4 启动时一直卡在 Docker Engine startingDocker Desktop 4.55.0 有时候会卡在“Docker Engine starting”这个界面一直转圈常见原因是上一次退出不干净。我的排查顺序是这样的先看右下角鲸鱼图标还在不在在的话右键 Quit 彻底退出。打开任务管理器把所有 com.docker.backend、com.docker.build 这类进程全部结束掉。确认 Windows 功能里的“虚拟机平台”和“适用于 Linux 的 Windows 子系统”是开启状态。重新启动 Docker Desktop。如果每次启动都必卡多半是引擎配置坏了。把 %APPDATA%\Docker 下的 settings.json 备份一份然后删除让 Docker Desktop 用默认配置重新初始化。这个方法绝大多数情况下都能救回来代价只是之前的配置需要重新设置一遍。4.5 杀毒软件与权限拦截的独家避坑再说一个不少人都栽过的坑系统里装了第三方杀毒软件或者安全卫士类工具Docker Desktop 装完以后启动直接报错或者启动到一半莫名退出。原因是这类软件把 Docker 相关的虚拟化组件给拦了。遇到这种情况先把 Docker Desktop 的安装目录和配置目录加进白名单再重新启动。具体目录就是前面提到的那几个位置C:\Program Files\Docker、%APPDATA%\Docker、%LOCALAPPDATA%\Docker 这些。如果实在搞不定安装前或运行前先暂时停掉第三方防护软件等 Docker 正常工作以后再恢复防护。这招我在好几台同事的机器上都验证过见效最快属于那种排查半天最后发现是“自己人”拦路的典型场景。5. 写在最后省心使用的小习惯最后分享几条我这几年用 Docker Desktop 养成的习惯不保证最优但踩过坑之后回头看都挺值。第一关机前先退出 Docker Desktop。直接关机不退出WSL2 的虚拟磁盘有时候会变臃肿下次启动也慢。右键鲸鱼 Quit 也就是一秒的事长期下来能省不少折腾。第二定期执行docker system prune。这个命令清掉的是悬空镜像、停止容器和构建缓存对保持磁盘清爽很有用。构建频繁的朋友建议至少一个月清一次清理完看看docker system df会有种莫名的舒爽。第三给数据卷做好备份。Docker 的容器删了可以重建镜像丢了可以再拉但数据卷里的东西没了就真没了。凡是跑数据库类容器的建议把数据目录挂载到宿主机或者定期导出备份别等到数据丢了才想起来。第四升级 Docker Desktop 不要太积极也不要太保守。新版本提示更新的时候先去官网看一眼更新说明再说。如果项目里跑着一堆老容器升级前最好先确认兼容性别拿生产环境当小白鼠。Docker Desktop 4.55.0 的安装教程到这儿就全部写完了。按这套流程走从零到跑通 hello-world 基本半小时能搞定。把前面几个配置项花几分钟设置好后面用起来会顺手很多。