Docker 运行时提示 WSL 2 is not installed

本文介绍了当遇到WSL2未安装或安装不完整的问题时的解决步骤。首先通过PowerShell脚本启用必要的Windows功能,然后检查并启用Hyper-V。如果问题仍然存在,建议下载并安装微软提供的wsl_update_x64.msi来更新Linux内核。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

问题描述

WSL 2 is not installed

Install WSL using this PowerShell script (in an administrative PowerShell) and restart your computer before using Docker Desktop:

Enable-WindowsOptionalFeature -Online -FeatureName $("VirtualMachinePlatform", "Microsoft-Windows-Subsystem-Linux")

尝试解决方法

  • cmd 中运行 systeminfo 查看是否启用 Hyper-V

  • 【控制面板】–【程序】–【启用或关闭 Windows 功能】,勾选添加 Hyper-V 全部选项,确定

继续报错

  • WSL 2 installation is incomplete.

解决方法

  • 点击弹出窗口提示的地址,下载并安装微软官方提供的 wsl_update_x64.msi
  • 重启

参考

  • https://docs.microsoft.com/en-us/windows/wsl/install-win10#step-4—download-the-linux-kernel-update-package
### 解决方案 为了使 Docker 正常工作,在 Windows 上通常推荐使用 WSL2 (Windows Subsystem for Linux 2),因为这能提供更好的性能和支持。如果当前环境中缺失 WSL2,则需要先完成其安装。 当尝试在未配置好 WSL2 的 Ubuntu 中运行 `docker` 命令,会遇到命令找不到的情况[^1]: ```bash root@afeicomputer:~# docker -v Command 'docker' not found, but can be installed with: apt install docker.io ``` 要解决这个问题并成功部署 Docker,需按照以下说明操作来确保环境准备就绪。 #### 安装和启用WSL2 由于 Docker 需要在支持的虚拟化平台上运行,因此首先要确认操作系统版本满足最低需求——即至少为 Windows 10 或更新版本,并且已启用了 Hyper-V 和 WSL 功能[^2]。 接着通过 PowerShell 执行如下指令以安装最新版 WSL 及默认分发版(通常是 Ubuntu): ```powershell wsl --install ``` 此命令将会自动下载最新的 Linux 发行版并将其设为默认值,同也将 WSL 版本升级到 WSL2。 #### 更新至WSL2 对于已经拥有旧版 WSL 的情况,可以通过下面这条命令强制转换现有发行版到 WSL2 : ```powershell wsl --set-version <DistributionName> 2 ``` 其中 `<DistributionName>` 应替换为你实际使用的 Linux 发行版名称,比如 "Ubuntu"。 #### 设置Docker Desktop 一旦有了合适的 WSL2 环境之后,就可以继续安装 Docker Desktop 来管理容器服务了。从官方网站获取适用于 Windows 的安装包,并遵循向导提示完成整个过程。 需要注意的是,虽然可以直接在 WSL 终端里用 APT 包管理器安装 Docker Engine (`apt install docker.io`) ,但这并不是官方建议的方式;相反应该优先考虑利用 Docker Desktop 进行集成化的管理和维护。
评论 3
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

csdn-WJW

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值