跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / Bash

Docker Desktop 启动报错 WSL 版本过旧解决方案

解决 Docker Desktop 启动时提示 WSL 版本过旧的问题。提供了两种方案:一是尝试 wsl --update 命令,若失败则使用离线安装包或检查网络;二是手动启用 WSL 和虚拟机平台功能,下载内核更新包并设为默认版本。最后通过 docker --version 和 wsl --version 验证修复结果。

云朵棉花糖发布于 2026/3/22更新于 2026/8/2372 浏览

问题描述

WSL needs updating Your version of Windows Subsystem for Linux (WSL) is too old. Run the command below to update or for more information, visit .the Microsoft WSL documentation wsl --update 

解决方案

方法一:如果 wsl --update 连接被重置(推荐)

如果执行 wsl --update 时遇到'连接被重置'错误,可以尝试:

  1. 使用离线安装包:
    • 直接下载 WSL 更新包:https://github.com/microsoft/WSL/releases
    • 下载最新版本的.msi 安装包进行安装
  2. 检查网络设置:
    • 暂时关闭防火墙和杀毒软件
    • 使用 VPN 或更改 DNS 服务器(如 8.8.8.8)
  3. 手动下载内核更新:
    • 从上述 GitHub releases 页面下载 wsl_update_x64.msi
    • 以管理员身份运行安装

方法二:手动更新 WSL(推荐)

  1. 以管理员身份打开 PowerShell 或命令提示符

启用 WSL 功能:

dism.exe /online /enable-feature/featurename:Microsoft-Windows-Subsystem-Linux /all /norestart 

启用虚拟机平台功能:

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart 
  1. 重启计算机使更改生效
  2. 下载并安装 WSL 2 Linux 内核更新包:
    • 访问微软官方下载页面:https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi
    • 下载并运行安装程序

设置 WSL 2 为默认版本:

wsl --set-default-version 2 

验证步骤

更新完成后,验证是否成功:

  1. 重启 Docker Desktop

在 WSL 中测试 Docker:

docker --version 

检查 WSL 版本:

wsl --version 

建议先尝试方法一,大多数情况下,手动下载并安装 WSL 更新包可以解决这个问题。

目录

  1. 问题描述
  2. 解决方案
  3. 方法一:如果 wsl --update 连接被重置(推荐)
  4. 方法二:手动更新 WSL(推荐)
  5. 验证步骤
  • 免费图片AI生成工具免费生成了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 免费图片视频在线生成30秒,将你的创意变成现实开始设计
  • X/Twitter免费视频下载器免登陆无限额度免费视频解析下载了解详情
  • 100+免费在线小游戏爽一把
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • C++ 基础:引用、inline 与 nullptr 用法解析
  • LangChain 与大语言模型应用开发指南
  • LeetCode 替换所有问号与提莫攻击解题思路
  • Dify 本地部署安装教程(Windows + Docker)
  • Python 环境安装与配置 Gurobi 求解器指南
  • OpenClaw 101:从零部署与实战指南
  • Python 入门教程:从基础语法到面向对象编程详解
  • 网络安全领域主流认证体系解析与选择指南
  • Python RabbitMQ 核心原理、模式与实战场景解析
  • PHP 全链路追踪实践:trace_id 生成与透传
  • 基于 Go 的电子病历智能助手与 HIS 对接实战
  • Java 9 至 Java 25:语言演进与技术革新深度解析
  • TradingView 图表库 Web 集成实战:从环境搭建到自定义扩展
  • jQuery 从入门到实战全解:前端高效开发核心
  • Ubuntu 24.04 使用 Docker Compose 本地部署 Whisper 语音识别服务
  • 二分查找算法详解与经典例题实战
  • Python 环境配置及 pip 安装指南
  • PX4 开源飞控系统详解:架构、功能与入门指南
  • Python 环境搭建与 pip 包管理完整指南
  • SmolRTSP:嵌入式系统高效 RTSP 流媒体服务实践

相关免费在线工具

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online

  • JSON美化和格式化

    将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online