[虚拟化/Docker/WSL] Docker Desktop 安装与使用

0 序:DeepSeek 等AI大模型在Windows的私有化部署

  • DeepSeek 等AI大模型在Windows的私有化部署,最流行的开源AI终端应用————Dify,依赖于 Docker 环境。由此,广大的Windows朋友们,必然离不开:Docker Desktop

1 概述:Docker Desktop

  • docker desktop 是一款Docker容器运行管理工具,用于在本地机器上运行 docker 容器。其使用方式包括:
    1. 安装 docker desktop;
    1. 启动 docker desktop;
    1. 创建 docker 镜像(可基于 dockerfile);
    1. 构建 docker 镜像(使用 docker build);
    1. 运行 docker 容器(使用 docker run)。
  • ...

2 安装步骤

安装 on Windows

Step0. 升级到 Docker Desktop 兼容的 Win 10/11版本 (可选步骤)

  • 最新版本的 Docker Desktop 对老旧版本的操作系统,可能不会支持,导致无法成功安装。如果遇到了需解决。

image

  • Win10

image
image

Step1. 安装 WSL 引擎 + Linux 发行版

  • 推荐文献

安装 WSL 引擎 + Linux发行版

  • 检查 WSL2 运行状态:
C:\Users\xxx> wsl --version
WSL 版本: 3.0.5.0
内核版本: 6.18.58.1-1
WSLg 版本: 1.0.79
MSRDC 版本: 1.2.7391
Direct3D 版本: 1.611.1-81528511
DXCore 版本: 10.0.26100.1-240331-1435.ge-release
Windows 版本: 10.0.26200.9711

PS C:\WINDOWS\system32> wsl -l -v
  NAME              STATE           VERSION
  Ubuntu-24.04      Running         2
  • 或者 启动一个已安装的 WSL 发行版(如 Ubuntu),并运行以下命令查看内核版本:
uname -r

如果输出类似于 4.x.x-wsl2,说明 WSL2 已成功启用。

image

image

Step2. 安装 Docker Desktop(勾选 WSL)

  • Step2.1 下载安装包。

访问 Docker 官网,选择与您的操作系统匹配的安装包。按照安装说明进行操作。

选择合适的安装包,并点击下载

https://desktop.docker.com/win/main/amd64/Docker Desktop Installer.exe

  • step2.2 点击安装包(Docker Desktop Installer.exe),开始安装

4.87.0 (236836)

或: 管理员方式打开 Powershell 窗口,并执行安装命令:

此举可指定安装目录到系统盘(C盘)以外的位置,避免C盘因存放大量Docker、WSL的大文件而磁盘占满问题。

Start-Process ".\Docker Desktop Installer.exe" -Wait -ArgumentList "install","--accept-license","--installation-dir=D:\Program\Docker-Desktop\","--wsl-default-data-root=E:\Program-Data\Docker-Data"

image

image

  • 勾选 WSL2 (默认勾选)

如果前面步骤中没有提前安装 WSL2 + 基于WSL的Linux发行版,则:此步骤中勾选了 WSL2 后,Docker Desktop 会提醒你安装WSL2(但实际上只是按照了 WSL2 引擎/内核,Linux发行版还需要你安装。不然可能后面启动 Docker Desktop / 运行docker images等命令时会报错)。

image

默认的安装目录:

C:\Program Files\Docker\ (修改安装目录后: D:\Program\Docker-Desktop\)
    frontend\
        Docker Desktop.exe
        ...
    resources\
        bin\
            docker.exe
            docker-compose.exe
            extension-admin.exe
            kubectl.exe
            ...
        cli-plugins\
            docker-agent.exe
            docker-ai.exe
            docker-buildx.exe
            docker-compose.exe
            docker-debug.exe
            docker-desktop.exe
            docker-dhi.exe
            docker-extension.exe
            docker-init.exe
            docker-mcp.exe
            docker-model.exe
            docker-offload.exe
            docker-pass.exe
            docker-sandbox.exe
            docker-scout.exe
        wsl\
            docker-wsl-cli.iso
            docker-wsl-cli.iso.sha256
            ext4.vhdx
            wsl-data.tar
        docker-desktop.iso
        Docker desktop.exe
        dockerd.exe
        com.docker.admin.exe
        com.docker.backend.exe
        com.docker.build.exe
        com.docker.diagnose.exe
        containerd.exe
        buildkitd.exe
        linux-daemon-options.json
        windows-daemon-options.json
        ... 
    app.json
    com.docker.service
    com.docker.service.config
    Docker Desktop.exe
    Docker Desktop Installer.exe
    DockerCli.exe
    InstallerCli.exe
    7zr.exe
    ...


C:\ProgramData\DockerDesktop\
    tmp-d4w\
        host.docker.internal (文件内容: 192.xxx.xxx.235)
    install-cli-log-admin.txt
    install-log-admin.txt

Step3. 配置环境变量

此步骤是为了解决git-bash环境下,无法识别到 docker-compose / docker compose 命令的问题,但 CMD / Powershell 环境下可以正常识别。

Docker Desktop 在 Windows 上把 Compose V2 实现为 Docker CLI 的插件,默认命令是 docker compose(空格),插件路径通常在 C:\Program Files\Docker\cli-plugins\docker-compose.exe。旧式的 docker-compose(横杠)是 V1 独立二进制,已经停止维护。

  • 为 docker 等程序,配置系统环境变量: Path

确保追加了如下2行配置:

C:\Program Files\Docker\Docker\resources\bin
    注:此路径在 DockerDesktop 安装完成时,一般已默认追加了。
    注:修改安装目录后为:  D:\Program\Docker-Desktop\resources\bin
C:\Program Files\Docker\cli-plugins\
    注:此路径即 docker-compose.exe 所在的文件夹
    注:修改安装目录后为:  D:\Program\Docker-Desktop\resources\cli-plugins\

可查看指定目录下的可执行程序有哪些(git-bash环境下为例):

$ ls "/C/Program Files/Docker/cli-plugins/"
docker-agent.exe*  docker-buildx.exe*   docker-debug.exe*    docker-dhi.exe*        docker-init.exe*  docker-model.exe*    docker-pass.exe*     docker-scout.exe*
docker-ai.exe*     docker-compose.exe*  docker-desktop.exe*  docker-extension.exe*  docker-mcp.exe*   docker-offload.exe*  docker-sandbox.exe*
  • 重启电脑(最新的 docker desktop 版本已无需重启)

重启后:

Accept

Finish

Step4. 启动 Docker Desktop

安装后,从启动 Docker Desktop 应用程序。它将在您的托盘或菜单栏中运行。

进入Docker Desktop主页,欢迎来到桌面版的Docker

image

可以选择登录 Docker 账号,也可以选择不登录(我先选择不登陆)

Step5. 配置 Docker Engine/镜像站 (可选步骤)

  • 为避免国内网络异常、访问 官方 dockerhub 不稳定等问题,可选择配置 第三方 Docker 镜像站。
  • 操作路径: Docker Desktop - Settings - Docker Engine
{
  "builder": {
    "gc": {
      "defaultKeepStorage": "20GB",
      "enabled": true
    }
  },
  "experimental": false,
  "registry-mirrors": [
    "https://docker.1ms.run",
    "https://docker.xuanyuan.me",
    "https://docker.m.daocloud.io"
  ]
}

配置完成后,选择: Apply and Restart

image

  • 可通过命令行查看 Docker Desktop/Docker Engine 运行状态
$ wsl --list --verbose

$ docker desktop status

image

image

Step6. 使用/管理 Docker 镜像、容器

  • 打开 Docker Desktop 桌面 运行。

  • 打开命令行窗口,验证 docker / docker-compose 版本

命令行窗口: CMD / Powershell / Git bash 均可

$ docker version
Client:
 Version:           29.7.2
 API version:       1.55
 Go version:        go1.26.5
 Git commit:        a7dcaa6
 Built:             Wed Aug  5 18:31:33 2026
 OS/Arch:           windows/amd64
 Context:           desktop-linux

Server: Docker Desktop 4.87.0 (236836)
 Engine:
  Version:          29.7.2
  API version:      1.55 (minimum version 1.40)
  Go version:       go1.26.5
  Git commit:       6a43e3d
  Built:            Wed Aug  5 18:28:36 2026
  OS/Arch:          linux/amd64
  Experimental:     false
 containerd:
  Version:          v2.2.5
  GitCommit:        e53c7c1516c3b2bff98eb76f1f4117477e6f4e66
 runc:
  Version:          1.3.6
  GitCommit:        v1.3.6-0-g491b69ba
 docker-init:
  Version:          0.19.0
  GitCommit:        de40ad0


$ docker compose version
Docker Compose version v5.4.0

$ docker-compose version
Docker Compose version v5.4.0
  • 推荐文献

提示

  • 使用 docker run 命令运行容器
  • -it:交互式终端
  • --rm:容器退出后删除
  • --name:为容器分配一个名称(可选)
  • 使用 docker ps 查看正在运行的容器。
C:\Users\xxx>docker ps
CONTAINER ID   IMAGE     COMMAND   CREATED   STATUS    PORTS     NAMES
  • 使用 docker image list 查看已构建的镜像。
C:\Users\xxx>docker image list
REPOSITORY                  TAG        IMAGE ID       CREATED         SIZE
redis                       6-alpine   8d7a968b2baf   5 weeks ago     30.2MB
semitechnologies/weaviate   1.19.0     8ec9f084ab23   21 months ago   52.5MB
  • docker info
C:\Users\xxx> docker info
Client:
 Version:    25.0.3
 Context:    default
 Debug Mode: false
 Plugins:
  buildx: Docker Buildx (Docker Inc.)
    Version:  v0.12.1-desktop.4
    Path:     C:\Program Files\Docker\cli-plugins\docker-buildx.exe
  compose: Docker Compose (Docker Inc.)
    Version:  v2.24.6-desktop.1
    Path:     C:\Program Files\Docker\cli-plugins\docker-compose.exe
  debug: Get a shell into any image or container. (Docker Inc.)
    Version:  0.0.24
    Path:     C:\Program Files\Docker\cli-plugins\docker-debug.exe
  dev: Docker Dev Environments (Docker Inc.)
    Version:  v0.1.0
    Path:     C:\Program Files\Docker\cli-plugins\docker-dev.exe
  extension: Manages Docker extensions (Docker Inc.)
    Version:  v0.2.22
    Path:     C:\Program Files\Docker\cli-plugins\docker-extension.exe
  feedback: Provide feedback, right in your terminal! (Docker Inc.)
    Version:  v1.0.4
    Path:     C:\Program Files\Docker\cli-plugins\docker-feedback.exe
  init: Creates Docker-related starter files for your project (Docker Inc.)
    Version:  v1.0.1
    Path:     C:\Program Files\Docker\cli-plugins\docker-init.exe
  sbom: View the packaged-based Software Bill Of Materials (SBOM) for an image (Anchore Inc.)
    Version:  0.6.0
    Path:     C:\Program Files\Docker\cli-plugins\docker-sbom.exe
  scout: Docker Scout (Docker Inc.)
    Version:  v1.5.0
    Path:     C:\Program Files\Docker\cli-plugins\docker-scout.exe

Server:
 Containers: 0
  Running: 0
  Paused: 0
  Stopped: 0
 Images: 2
 Server Version: 25.0.3
 Storage Driver: overlay2
  Backing Filesystem: extfs
  Supports d_type: true
  Using metacopy: false
  Native Overlay Diff: true
  userxattr: false
 Logging Driver: json-file
 Cgroup Driver: cgroupfs
 Cgroup Version: 1
 Plugins:
  Volume: local
  Network: bridge host ipvlan macvlan null overlay
  Log: awslogs fluentd gcplogs gelf journald json-file local splunk syslog
 Swarm: inactive
 Runtimes: io.containerd.runc.v2 runc
 Default Runtime: runc
 Init Binary: docker-init
 containerd version: ae07eda36dd25f8a1b98dfbf587313b99c0190bb
 runc version: v1.1.12-0-g51d5e94
 init version: de40ad0
 Security Options:
  • 使用 docker stop 停止容器。
  • 使用 docker rm 删除容器。
  • 使用 docker image rm 删除镜像。

F 附件

F.1 注册/登录 Docker 账号 (可选步骤)

  • 登录Docker账号,可创建和管理自己的镜像仓库Hub

http://app.docker.com

Z FAQ: 安装 Docker Desktop

Q: WSL 引擎/内核 与 Linux 发行版、Docker 三者的关系 ?(必读)

整体关系

  • WSL 提供 Linux 内核运行环境,Linux 发行版提供用户空间,Docker 在发行版之上运行容器。

WSL 是什么?让 Linux 二进制程序直接在 Windows 上原生运行,无需虚拟机或双系统

  • 推荐文献
  • WSL = Windows Subsystem for Linux

让 Linux 二进制程序直接在 Windows 上原生运行,无需虚拟机或双系统。
WSL = 把 Linux 塞进 Windows 的“兼容层 + 轻量内核”

词 含义
Windows 跑在 Windows 上
Subsystem 不是虚拟机,是系统级子系统
for Linux 兼容 Linux ABI(应用二进制接口)
  • ✅ 不用装虚拟机 —— 启动秒级,资源占用极低
  • ✅ Linux 工具链 —— bash、grep、awk、ssh、包管理器全可用
  • ✅ 开发环境统一 —— 本地跑 Linux 服务,部署到生产无差异
  • ✅ Windows + Linux 共存 —— 文件互通、端口互通、剪贴板互通

架构图

flowchart TB Windows["Windows 操作系统<br/>(宿主机)"] subgraph WSL["WSL 引擎 (WSL 2)"] WSLKernel["Linux 内核<br/>(Microsoft 维护)"] WSLInit["初始化与虚拟化层<br/>(Hyper-V / VM)"] subgraph Distros["Linux 发行版 (用户空间)"] Ubuntu["Ubuntu / Debian / CentOS 等"] Filesystem["RootFS + 包管理器"] Shell["Shell / systemd / 服务"] end subgraph Docker["Docker 生态"] DockerCLI["docker CLI"] Dockerd["dockerd (守护进程)"] Containers["容器 (隔离进程)"] end end Windows --> WSL WSLKernel --> Distros Distros --> Docker DockerCLI --> Dockerd Dockerd --> Containers

三者关系对比表

维度 WSL 引擎 / 内核 Linux 发行版 Docker
本质 Linux 内核 + 轻量虚拟机 用户空间(GNU 工具链) 容器运行时
作用 提供 Linux 内核能力 提供 shell、包管理、系统工具 运行隔离的应用容器
是否操作系统 ❌ 不是完整 OS ✅ 是 Linux 发行版 ❌ 不是 OS
是否可运行多个 只有一个内核 ✅ 可运行多个发行版 ✅ 多个容器
是否依赖对方 不依赖发行版 ✅ 依赖 WSL 内核 ✅ 依赖发行版
典型路径 /usr/lib/wsl/ / /var/lib/docker
启动方式 wsl --start wsl -d Ubuntu docker run
类比 发动机 车身 + 内饰 车厢里的货物

典型协作流程(很重要)

Windows
  └─ WSL 2
       ├─ Linux 内核
       │     ↓
       ├─ Ubuntu(发行版)
       │     ↓
       ├─ Docker Engine
       │     ↓
       └─ 容器(nginx / mysql / app)

实际执行示例

# 1️⃣ 启动 WSL
wsl --start

# 2️⃣ 进入 Linux 发行版
wsl -d Ubuntu

# 3️⃣ 启动 Docker
sudo service docker start

# 4️⃣ 运行容器
docker run -d -p 80:80 nginx

Docker Desktop vs WSL Docker Engine 架构图

  • 开发环境推荐组合: Windows + WSL + Docker(Desktop)

Docker Desktop 与 WSL Docker Engine 的2种并列架构对比:

flowchart LR %% ===== 公共宿主层 ===== Win(["Windows 宿主机"]) %% ===== 左侧:Docker Desktop ===== subgraph DD["Docker Desktop"] direction TB DDCli["docker CLI / GUI"] DDHyper["Hyper-V / WSL 2 VM"] DDLinux["Docker Desktop Linux VM"] DDContainer["Docker 容器"] DDd["dockerd 守护进程"] DDCli --> DDHyper DDHyper --> DDLinux DDLinux --> DDd DDd --> DDContainer end Win --> DD %% ===== 右侧:WSL Docker Engine ===== subgraph WSL2["WSL 2"] direction TB Distro["Ubuntu / Debian 等发行版"] d["dockerd 守护进程"] Container["Docker 容器"] Distro --> d d --> Container end Win --> WSL2 %% ===== 底部对比注释 ===== Note1["Docker Desktop:容器运行在独立 Linux VM 中"] Note2["WSL Docker Engine:容器直接运行在WSL的Linux发行版环境中"]
  • 核心差异
对比项 Docker Desktop WSL Docker Engine
运行位置 独立的 Docker Linux VM Ubuntu 等 WSL 发行版内
管理方式 图形界面 + 自动管理 VM 手动安装、配置 dockerd
资源占用 通常更高 更轻量
与 Windows 集成 很强,开箱即用 需要额外配置
适合人群 普通开发者、团队协作 熟悉 Linux/WSL 的开发者
镜像存储 默认位于 Docker VM 位于当前 WSL 发行版或绑定磁盘

小结: Docker Desktop 是“自带 Linux VM 的完整套装”;WSL Docker Engine 是“把 Docker 直接装进 WSL 发行版”。

Docker Desktop + WSL2 后端 的架构(本文采用的架构 / 必读)

  • 安装Docker Desktop 时,让我们选 WSL2,是否就是 采用 WSL Docker Engine 这种架构?

结论:不是。​
安装 Docker Desktop 时勾选 “Use WSL 2”,用的是 Docker Desktop 的 WSL2 托管后端,不是“在 Ubuntu 里手装 Docker Engine”那种原生架构。

架构对比

  • 对比:
  • 架构1: Docker Desktop + WSL2 后端​ → Docker 自己建一个隐藏发行版 docker-desktop,dockerd 跑在里面
  • 架构2: WSL Docker Engine​ → 你在 Ubuntu 里 apt install docker-ce,dockerd 跑在你自己的发行版里
  • 架构1
flowchart TB Win["Windows 宿主机"] subgraph DD["Docker Desktop(WSL2 后端)"] DDCli["Docker Desktop GUI + CLI"] HiddenDistro["docker-desktop(隐藏发行版)"] DDd["dockerd"] C1["容器"] DDCli --> HiddenDistro HiddenDistro --> DDd --> C1 end subgraph WSL["WSL2 普通发行版(如 Ubuntu)"] UDistro["Ubuntu 用户空间"] UShell["bash / systemd"] note["仅注入 docker CLI + 连 hidden distro 的 socket"] UDistro --> UShell --> note end Win --> DD Win --> WSL WSL -.->|docker CLI 连 socket| DD
  • 架构2
flowchart TB Win["Windows 宿主机"] subgraph WSL2["WSL2"] Ubuntu["Ubuntu 发行版"] dockerd["dockerd(直接装在这里)"] C["容器"] Ubuntu --> dockerd --> C end Win --> WSL2

关键差异表

维度 Docker Desktop(WSL2 后端) WSL 原生 Docker Engine
谁创建 dockerd Docker Desktop 自动创建 你手动安装
dockerd 位置 docker-desktop 隐藏发行版 你的 Ubuntu/Debian 内
数据存储 docker-desktop-data 发行版 当前发行版 /var/lib/docker
CLI 在哪 Windows + WSL 里都能用 只在 WSL 里
图形界面 有(Desktop GUI) 无
Kubernetes 一键开启 要自己搭
升级方式 Desktop 统一管 自己 apt upgrade
适合场景 开发开箱即用 接近生产、轻量、可控

Docker Desktop 勾选 WSL2 后发生了什么

  1. Windows 装 Docker Desktop
  2. 启用 WSL2
  3. Docker Desktop 创建两个特殊 WSL 发行版:
    • docker-desktop → 跑 dockerd / containerd
    • docker-desktop-data → 存镜像、容器、卷
  4. 你的 Ubuntu 里:
    • 只注入 docker CLI
    • docker ps 实际连的是 docker-desktop 里的 socket

所以:
你的 Ubuntu 不是“Docker 主机”,只是“客户端”
真正的引擎在 docker-desktop


怎么验证你现在是哪种

# 看有没有 Docker 隐藏发行版
wsl -l -v

你会看到:

  NAME                   STATE           VERSION
  Ubuntu                 Running         2
  docker-desktop         Running         2
  docker-desktop-data    Running         2

有后两个 → Docker Desktop WSL2 后端

如果只有:

  Ubuntu   Running   2

且在 Ubuntu 里 ps aux | grep dockerd 能看到进程 → WSL 原生 Engine

小结

勾选 WSL2 ≠ 用 WSL Docker Engine
而是:Docker Desktop 借 WSL2 后端 跑它自己的托管 Engine


常见误区澄清

误区 正确理解
Docker 直接跑在 WSL 上 ❌ Docker 跑在 Linux 发行版里
WSL 就是 Linux ❌ WSL 是“内核 + 运行环境”
一个 WSL 只能装一个发行版 ❌ 可装多个
Docker Desktop 必须装 ❌ 可纯用 WSL + Docker Engine
WSL 1 和 WSL 2 一样 ❌ WSL 2 有真实 Linux 内核

核心小结

WSL = 发动机
Linux 发行版 = 汽车
Docker = 车厢里的集装箱

Q: 查验 Docker Desktop Backennd 的类型?WSL 2(默认)、Hyper-V、Docker VMM(Beta) *

  • 在 Windows 上查验 Docker Desktop 后端类型,最直接的是看 Docker Desktop 设置,再用命令行辅助确认。

Docker Desktop 目前支持三种后端:WSL 2(默认推荐)、Hyper-V、Docker VMM(Beta)。

  • Docker Desktop 的 GUI 菜单路径: Setttings-Gerneral-"Choose how to run Docker containers"

Docker VMM​ / Hype-V / WSL 2

image

  • 命令行方式查验:
  • 检查 WSL 发行版版本
PS C:\Users\Johnny> wsl --list --verbose
  NAME              STATE           VERSION
* Ubuntu            Stopped         2
  docker-desktop    Running         2

能看到 docker-desktop 和 docker-desktop-data,且 VERSION 列为 2​ → Docker 正在使用 WSL 2 后端
如果均不存在这两个条目,可能使用的是 Hyper-V 后端

  • 进一步确认 WSL 2 内核
PS C:\Users\Johnny> wsl -d docker-desktop cat /proc/version
Linux version 5.15.167.4-microsoft-standard-WSL2 (root@f9c826d3017f) (gcc (GCC) 11.2.0, GNU ld (GNU Binutils) 2.37) #1 SMP Tue Nov 5 00:21:55 UTC 2024

输出含 Microsoft 字样(如 Linux version 5.x.x-microsoft-standard-WSL2)→ 确认为 WSL 2 内核

  • 查看 Docker 服务端信息
docker info

结合 wsl -l -v 的输出综合判断后端类型

Q:安装 Docker Desktop 时,报:"此访问控制列表格式不规范,因此无法修改"

  • 问题描述

点击 Docker Desktop 安装程序进行安装时,报:"此访问控制列表格式不规范,因此无法修改"

  • 解决方法
  • step1 使用管理员权限,打开cmd命令提示符窗口。
  • step2 修复文件目录权限
icacls "C:\Program Files\Docker" /reset /t /c /q
icacls "C:\ProgramData\DockerDesktop" /reset /t /c /q

参数解释

  • /reset:重置权限为默认值。
  • /t:递归地应用到所有子文件和子目录。
  • /c:继续执行,即使出现错误。
  • /q:静默模式,不显示成功消息。

执行完成执行,再次安装即可解决该问题。

  • 参考文献

Q: Docker Desktop 启动后,面板显示"Docker Engine Stopped"

  • 问题描述

Docker Desktop 启动后,面板显示"Docker Engine Stopped"

如果你解决了访问docker.com的网络问题,打开Docker Desktop时,还会附带报:"Docker Desktop - WSL update failed"

Docker Desktop - WSL update failed

An error occurred while updating WSL.

You can manually update using wsl --update.

If the issue persists, collect diagnostics and submit an issue

--------------------------------------

wsl update failed: update failed: updating wsl: exit code: 4294967295: running WSL command wsl.exe C:\Windows\System32\wsl.exe --update --web-download: �]�ybk(403)0

: exit status 0xffffffff
  • 解决方法

此处针对"Docker Engine Stopped"问题(不单单针对"Docker Desktop - WSL update failed"错误)的整个解决方法

  • 参考文献

Q: 解决Win10家庭版找不到Hyper-V的问题

  • 问题描述

Windows 10家庭版在默认的“启用或关闭Windows功能”中不直接包含Hyper-V选项,但可以通过手动步骤来启用它。

control -> 控制面板\程序\程序和功能 -> 启用或关闭Windows功能 -> Hyper-V (此选项,在 Windows 10 家庭版 中默认没有)
  • Step1 检查电脑是否支持Hyper-V

首先,确认电脑硬件是否支持Hyper-V功能。
打开Windows PowerShell 或 CMD(以管理员身份运行)。

输入 systeminfo 命令并回车。

情况1:可能显示 "Hyper-V 要求: 已检测到虚拟机监控程序。将不显示 Hyper-V 所需的功能" (说明电脑支持Hyper-V)

情况2: 如果所有四个要求均显示为“是” (说明电脑支持Hyper-V)

  • Step2 准备启用Hyper-V的脚本

如果电脑支持Hyper-V,接下来需要准备一个脚本来启用它。

新建一个文本文件,命名为enable-hyperv.cmd(或任何其他.cmd后缀的名称)。将以下代码复制并粘贴到该文件中:

pushd "%~dp0"
 
dir /b %SystemRoot%\servicing\Packages\*Hyper-V*.mum >hyper-v.txt
 
for /f %%i in ('findstr /i . hyper-v.txt 2^>nul') do dism /online /norestart /add-package:"%SystemRoot%\servicing\Packages\%%i"
 
del hyper-v.txt
 
Dism /online /enable-feature /featurename:Microsoft-Hyper-V-All /LimitAccess /ALL

保存文件

  • Step3 运行脚本以启用Hyper-V。找到enable-hyperv.cmd文件,右键点击该文件,选择“以管理员身份运行”。

等待脚本执行完成。脚本执行结束后,会提示重启计算机以使更改生效

运行日志
C:\Windows\system32>pushd "C:\Users\XXX\Desktop\"

C:\Users\XXX\Desktop>dir /b C:\Windows\servicing\Packages\*Hyper-V*.mum  1>hyper-v.txt

C:\Users\XXX\Desktop>for /F %i in ('findstr /i . hyper-v.txt 2>nul') do dism /online /norestart /add-package:"C:\Windows\servicing\Packages\%i"

C:\Users\XXX\Desktop>dism /online /norestart /add-package:"C:\Windows\servicing\Packages\Microsoft-Hyper-V-ClientEdition-Package~31bf3856ad364e35~amd64~zh-CN~10.0.19041.3758.mum"

部署映像服务和管理工具
版本: 10.0.19041.3636

映像版本: 10.0.19045.4170

正在处理 1 (共 1) - 正在添加程序包 Microsoft-Hyper-V-ClientEdition-Package~31bf3856ad364e35~amd64~zh-CN~10.0.19041.3758
[==========================100.0%==========================]
操作成功完成。

C:\Users\XXX\Desktop>dism /online /norestart /add-package:"C:\Windows\servicing\Packages\Microsoft-Hyper-V-ClientEdition-Package~31bf3856ad364e35~amd64~~10.0.19041.4170.mum"

部署映像服务和管理工具
版本: 10.0.19041.3636

映像版本: 10.0.19045.4170

正在处理 1 (共 1) - 正在添加程序包 Microsoft-Hyper-V-ClientEdition-Package~31bf3856ad364e35~amd64~~10.0.19041.4170
[==========================100.0%==========================]
操作成功完成。

C:\Users\XXX\Desktop>dism /online /norestart /add-package:"C:\Windows\servicing\Packages\Microsoft-Hyper-V-ClientEdition-WOW64-Package~31bf3856ad364e35~amd64~zh-CN~10.0.19041.1.mum"

部署映像服务和管理工具
版本: 10.0.19041.3636

映像版本: 10.0.19045.4170

正在处理 1 (共 1) - 正在添加程序包 Microsoft-Hyper-V-ClientEdition-WOW64-Package~31bf3856ad364e35~amd64~zh-CN~10.0.19041.1
[==========================100.0%==========================]
操作成功完成。

C:\Users\XXX\Desktop>dism /online /norestart /add-package:"C:\Windows\servicing\Packages\Microsoft-Hyper-V-ClientEdition-WOW64-Package~31bf3856ad364e35~amd64~~10.0.19041.1.mum"

部署映像服务和管理工具
版本: 10.0.19041.3636

映像版本: 10.0.19045.4170

正在处理 1 (共 1) - 正在添加程序包 Microsoft-Hyper-V-ClientEdition-WOW64-Package~31bf3856ad364e35~amd64~~10.0.19041.1
[==========================100.0%==========================]
操作成功完成。

C:\Users\XXX\Desktop>dism /online /norestart /add-package:"C:\Windows\servicing\Packages\Microsoft-Hyper-V-Hypervisor-merged-Package~31bf3856ad364e35~amd64~zh-CN~10.0.19041.1.mum"

部署映像服务和管理工具
版本: 10.0.19041.3636

映像版本: 10.0.19045.4170

正在处理 1 (共 1) - 正在添加程序包 Microsoft-Hyper-V-Hypervisor-merged-Package~31bf3856ad364e35~amd64~zh-CN~10.0.19041.1
[==========================100.0%==========================]
操作成功完成。

C:\Users\XXX\Desktop>dism /online /norestart /add-package:"C:\Windows\servicing\Packages\Microsoft-Hyper-V-Hypervisor-merged-Package~31bf3856ad364e35~amd64~~10.0.19041.1.mum"

部署映像服务和管理工具
版本: 10.0.19041.3636

映像版本: 10.0.19045.4170

正在处理 1 (共 1) - 正在添加程序包 Microsoft-Hyper-V-Hypervisor-merged-Package~31bf3856ad364e35~amd64~~10.0.19041.1
[==========================100.0%==========================]
操作成功完成。

C:\Users\XXX\Desktop>dism /online /norestart /add-package:"C:\Windows\servicing\Packages\Microsoft-Hyper-V-Hypervisor-Package~31bf3856ad364e35~amd64~zh-CN~10.0.19041.1.mum"

部署映像服务和管理工具
版本: 10.0.19041.3636

映像版本: 10.0.19045.4170

正在处理 1 (共 1) - 正在添加程序包 Microsoft-Hyper-V-Hypervisor-Package~31bf3856ad364e35~amd64~zh-CN~10.0.19041.1
[==========================100.0%==========================]
操作成功完成。

C:\Users\XXX\Desktop>dism /online /norestart /add-package:"C:\Windows\servicing\Packages\Microsoft-Hyper-V-Hypervisor-Package~31bf3856ad364e35~amd64~~10.0.19041.4170.mum"

部署映像服务和管理工具
版本: 10.0.19041.3636

映像版本: 10.0.19045.4170

正在处理 1 (共 1) - 正在添加程序包 Microsoft-Hyper-V-Hypervisor-Package~31bf3856ad364e35~amd64~~10.0.19041.4170
[==========================100.0%==========================]
操作成功完成。

C:\Users\XXX\Desktop>dism /online /norestart /add-package:"C:\Windows\servicing\Packages\Microsoft-Hyper-V-Offline-Common-merged-Package~31bf3856ad364e35~amd64~zh-CN~10.0.19041.1.mum"

部署映像服务和管理工具
版本: 10.0.19041.3636

映像版本: 10.0.19045.4170

正在处理 1 (共 1) - 正在添加程序包 Microsoft-Hyper-V-Offline-Common-merged-Package~31bf3856ad364e35~amd64~zh-CN~10.0.19041.1
[==========================100.0%==========================]
操作成功完成。

C:\Users\XXX\Desktop>dism /online /norestart /add-package:"C:\Windows\servicing\Packages\Microsoft-Hyper-V-Offline-Common-merged-Package~31bf3856ad364e35~amd64~~10.0.19041.4046.mum"

部署映像服务和管理工具
版本: 10.0.19041.3636

映像版本: 10.0.19045.4170

正在处理 1 (共 1) - 正在添加程序包 Microsoft-Hyper-V-Offline-Common-merged-Package~31bf3856ad364e35~amd64~~10.0.19041.4046
[==========================100.0%==========================]
操作成功完成。

C:\Users\XXX\Desktop>dism /online /norestart /add-package:"C:\Windows\servicing\Packages\Microsoft-Hyper-V-Offline-Common-Package~31bf3856ad364e35~amd64~zh-CN~10.0.19041.3636.mum"

部署映像服务和管理工具
版本: 10.0.19041.3636

映像版本: 10.0.19045.4170

正在处理 1 (共 1) - 正在添加程序包 Microsoft-Hyper-V-Offline-Common-Package~31bf3856ad364e35~amd64~zh-CN~10.0.19041.3636
[==========================100.0%==========================]
操作成功完成。

C:\Users\XXX\Desktop>dism /online /norestart /add-package:"C:\Windows\servicing\Packages\Microsoft-Hyper-V-Offline-Common-Package~31bf3856ad364e35~amd64~~10.0.19041.4170.mum"

部署映像服务和管理工具
版本: 10.0.19041.3636

映像版本: 10.0.19045.4170

正在处理 1 (共 1) - 正在添加程序包 Microsoft-Hyper-V-Offline-Common-Package~31bf3856ad364e35~amd64~~10.0.19041.4170
[==========================100.0%==========================]
操作成功完成。

C:\Users\XXX\Desktop>dism /online /norestart /add-package:"C:\Windows\servicing\Packages\Microsoft-Hyper-V-Offline-Core-Group-merged-Package~31bf3856ad364e35~amd64~zh-CN~10.0.19041.3636.mum"

部署映像服务和管理工具
版本: 10.0.19041.3636

映像版本: 10.0.19045.4170

正在处理 1 (共 1) - 正在添加程序包 Microsoft-Hyper-V-Offline-Core-Group-merged-Package~31bf3856ad364e35~amd64~zh-CN~10.0.19041.3636
[==========================100.0%==========================]
操作成功完成。

C:\Users\XXX\Desktop>dism /online /norestart /add-package:"C:\Windows\servicing\Packages\Microsoft-Hyper-V-Offline-Core-Group-merged-Package~31bf3856ad364e35~amd64~~10.0.19041.3930.mum"

部署映像服务和管理工具
版本: 10.0.19041.3636

映像版本: 10.0.19045.4170

正在处理 1 (共 1) - 正在添加程序包 Microsoft-Hyper-V-Offline-Core-Group-merged-Package~31bf3856ad364e35~amd64~~10.0.19041.3930
[==========================100.0%==========================]
操作成功完成。

C:\Users\XXX\Desktop>dism /online /norestart /add-package:"C:\Windows\servicing\Packages\Microsoft-Hyper-V-Offline-Core-Group-Package~31bf3856ad364e35~amd64~zh-CN~10.0.19041.3636.mum"

部署映像服务和管理工具
版本: 10.0.19041.3636

映像版本: 10.0.19045.4170

正在处理 1 (共 1) - 正在添加程序包 Microsoft-Hyper-V-Offline-Core-Group-Package~31bf3856ad364e35~amd64~zh-CN~10.0.19041.3636
[==========================100.0%==========================]
操作成功完成。

C:\Users\XXX\Desktop>dism /online /norestart /add-package:"C:\Windows\servicing\Packages\Microsoft-Hyper-V-Offline-Core-Group-Package~31bf3856ad364e35~amd64~~10.0.19041.4170.mum"

部署映像服务和管理工具
版本: 10.0.19041.3636

映像版本: 10.0.19045.4170

正在处理 1 (共 1) - 正在添加程序包 Microsoft-Hyper-V-Offline-Core-Group-Package~31bf3856ad364e35~amd64~~10.0.19041.4170
[==========================100.0%==========================]
操作成功完成。

C:\Users\XXX\Desktop>dism /online /norestart /add-package:"C:\Windows\servicing\Packages\Microsoft-Hyper-V-Online-Services-merged-Package~31bf3856ad364e35~amd64~zh-CN~10.0.19041.1.mum"

部署映像服务和管理工具
版本: 10.0.19041.3636

映像版本: 10.0.19045.4170

正在处理 1 (共 1) - 正在添加程序包 Microsoft-Hyper-V-Online-Services-merged-Package~31bf3856ad364e35~amd64~zh-CN~10.0.19041.1
[==========================100.0%==========================]
操作成功完成。

C:\Users\XXX\Desktop>dism /online /norestart /add-package:"C:\Windows\servicing\Packages\Microsoft-Hyper-V-Online-Services-merged-Package~31bf3856ad364e35~amd64~~10.0.19041.3636.mum"

部署映像服务和管理工具
版本: 10.0.19041.3636

映像版本: 10.0.19045.4170

正在处理 1 (共 1) - 正在添加程序包 Microsoft-Hyper-V-Online-Services-merged-Package~31bf3856ad364e35~amd64~~10.0.19041.3636
[==========================100.0%==========================]
操作成功完成。

C:\Users\XXX\Desktop>dism /online /norestart /add-package:"C:\Windows\servicing\Packages\Microsoft-Hyper-V-Online-Services-Package~31bf3856ad364e35~amd64~zh-CN~10.0.19041.3636.mum"

部署映像服务和管理工具
版本: 10.0.19041.3636

映像版本: 10.0.19045.4170

正在处理 1 (共 1) - 正在添加程序包 Microsoft-Hyper-V-Online-Services-Package~31bf3856ad364e35~amd64~zh-CN~10.0.19041.3636
[==========================100.0%==========================]
操作成功完成。

C:\Users\XXX\Desktop>dism /online /norestart /add-package:"C:\Windows\servicing\Packages\Microsoft-Hyper-V-Online-Services-Package~31bf3856ad364e35~amd64~~10.0.19041.4170.mum"

部署映像服务和管理工具
版本: 10.0.19041.3636

映像版本: 10.0.19045.4170

正在处理 1 (共 1) - 正在添加程序包 Microsoft-Hyper-V-Online-Services-Package~31bf3856ad364e35~amd64~~10.0.19041.4170
[==========================100.0%==========================]
操作成功完成。

C:\Users\XXX\Desktop>dism /online /norestart /add-package:"C:\Windows\servicing\Packages\Microsoft-Hyper-V-Package-base-merged-Package~31bf3856ad364e35~amd64~zh-CN~10.0.19041.1.mum"

部署映像服务和管理工具
版本: 10.0.19041.3636

映像版本: 10.0.19045.4170

正在处理 1 (共 1) - 正在添加程序包 Microsoft-Hyper-V-Package-base-merged-Package~31bf3856ad364e35~amd64~zh-CN~10.0.19041.1
[==========================100.0%==========================]
操作成功完成。

C:\Users\XXX\Desktop>dism /online /norestart /add-package:"C:\Windows\servicing\Packages\Microsoft-Hyper-V-Package-base-merged-Package~31bf3856ad364e35~amd64~~10.0.19041.3636.mum"

部署映像服务和管理工具
版本: 10.0.19041.3636

映像版本: 10.0.19045.4170

正在处理 1 (共 1) - 正在添加程序包 Microsoft-Hyper-V-Package-base-merged-Package~31bf3856ad364e35~amd64~~10.0.19041.3636
[==========================100.0%==========================]
操作成功完成。

C:\Users\XXX\Desktop>dism /online /norestart /add-package:"C:\Windows\servicing\Packages\Microsoft-Hyper-V-Package-base-Package~31bf3856ad364e35~amd64~zh-CN~10.0.19041.1.mum"

部署映像服务和管理工具
版本: 10.0.19041.3636

映像版本: 10.0.19045.4170

正在处理 1 (共 1) - 正在添加程序包 Microsoft-Hyper-V-Package-base-Package~31bf3856ad364e35~amd64~zh-CN~10.0.19041.1
[==========================100.0%==========================]
操作成功完成。

C:\Users\XXX\Desktop>dism /online /norestart /add-package:"C:\Windows\servicing\Packages\Microsoft-Hyper-V-Package-base-Package~31bf3856ad364e35~amd64~~10.0.19041.4170.mum"

部署映像服务和管理工具
版本: 10.0.19041.3636

映像版本: 10.0.19045.4170

正在处理 1 (共 1) - 正在添加程序包 Microsoft-Hyper-V-Package-base-Package~31bf3856ad364e35~amd64~~10.0.19041.4170
[==========================100.0%==========================]
操作成功完成。

C:\Users\XXX\Desktop>dism /online /norestart /add-package:"C:\Windows\servicing\Packages\Microsoft-Hyper-V-Services-Package~31bf3856ad364e35~amd64~zh-CN~10.0.19041.3636.mum"

部署映像服务和管理工具
版本: 10.0.19041.3636

映像版本: 10.0.19045.4170

正在处理 1 (共 1) - 正在添加程序包 Microsoft-Hyper-V-Services-Package~31bf3856ad364e35~amd64~zh-CN~10.0.19041.3636
[==========================100.0%==========================]
操作成功完成。

C:\Users\XXX\Desktop>dism /online /norestart /add-package:"C:\Windows\servicing\Packages\Microsoft-Hyper-V-Services-Package~31bf3856ad364e35~amd64~~10.0.19041.4170.mum"

部署映像服务和管理工具
版本: 10.0.19041.3636

映像版本: 10.0.19045.4170

正在处理 1 (共 1) - 正在添加程序包 Microsoft-Hyper-V-Services-Package~31bf3856ad364e35~amd64~~10.0.19041.4170
[==========================100.0%==========================]
操作成功完成。

C:\Users\XXX\Desktop>del hyper-v.txt

C:\Users\XXX\Desktop>Dism /online /enable-feature /featurename:Microsoft-Hyper-V-All /LimitAccess /ALL

部署映像服务和管理工具
版本: 10.0.19041.3636

映像版本: 10.0.19045.4170

启用一个或多个功能
[==========================100.0%==========================]
操作成功完成。
重新启动 Windows 以完成该操作。
是否立即重新启动计算机? (Y/N)Y
  • Step4 重启计算机后,再次查看,即出现了Hyper-V选项
control(控制面板) -> 控制面板\程序\程序和功能 -> 启用或关闭Windows功能 -> Hyper-V (选项出现)

  • 参考文献

Q: 启动 DockerDesktop 服务的方式

  • 方式1: 从 services.msc 手动启动Docker Desktop Service

Q: Docker Desktop 为 Docker Engine 配置 Docker 镜像源

  • 推荐文献

Docker Hub 镜像加速器列表

  • Docker Desktop 中配置 Docker 镜像源,本质 = 修改 json 配置文件

  • 应用并重启

  • 测试是否配置成功
  • Windows PowerShell
docker info

在输出中寻找 Registry Mirrors,看到刚刚输入的镜像地址即配置成功

Y 推荐文献

X 参考文献

  • 第三方网站 :
posted @ 2025-02-13 02:40  千千寰宇  阅读(2597)  评论(0)    收藏  举报