Win11 家用版安装 Docker:Docker Desktop + WSL2

前言

这里先说清楚一个现实限制:

Win11 家用版(Home)在安装 Docker 时,**Docker Desktop 基本必须使用 WSL2 作为后端**。

但你完全可以做到:

– 只用 **Windows 的设置 + PowerShell**
– 不打开、不使用 Ubuntu 终端
– Docker 运行依赖的 Linux 环境由 Docker Desktop 自动创建(`docker-desktop` / `docker-desktop-data`),你不需要会 Linux

本文就是这条路线。

## 准备工作

你需要:

1、Windows 11 家用版

2、电脑 CPU 支持虚拟化(Intel VT-x / AMD-V)并已开启

3、管理员权限(开启系统功能、安装软件)

4、网络能正常下载(winget、Docker Desktop、WSL 更新)

## 第一步:检查虚拟化是否开启(必须)

按 `Ctrl + Shift + Esc` 打开任务管理器 → 性能 → CPU。

看到“虚拟化:已启用”才继续。

如果是“已禁用”,需要重启进 BIOS/UEFI 打开 VT-x/AMD-V。

## 第二步:启用 WSL2(Win11 Home 必需,但不需要你用 Ubuntu)

### 1)管理员打开 PowerShell

开始菜单搜索 PowerShell → 右键 → 以管理员身份运行。

### 2)一键安装/启用 WSL(可复制)

POWERSHELL
wsl --install

执行完如果提示重启,按提示重启。

### 3)更新 WSL(推荐做一次)

POWERSHELL
wsl --update

### 4)确认 WSL 版本为 2(可复制)

POWERSHELL
wsl -l -v

如果你看到某个发行版 VERSION 是 1,把默认版本设置为 2:

POWERSHELL
wsl --set-default-version 2

说明:即使你不使用 Ubuntu,Docker Desktop 也会自己创建 `docker-desktop` / `docker-desktop-data` 两个 WSL 发行版。

## 第三步:安装 Docker Desktop(推荐 winget 一键安装)

### 1)确认 winget 可用

POWERSHELL
winget -v

### 2)安装 Docker Desktop(可复制)

POWERSHELL
winget install -e --id Docker.DockerDesktop

安装完成后,从开始菜单打开 Docker Desktop。

## 第四步:Docker Desktop 关键设置(小白最容易漏)

打开 Docker Desktop → Settings(设置)。

### 1)启用 WSL2 引擎

Settings → General

确保勾选:

– Use the WSL 2 based engine

### 2)WSL 集成(建议这样设置)

Settings → Resources → WSL Integration

建议:

– 打开 “Enable integration with my default WSL distro”
– 如果你装了 Ubuntu 但不想用它,可以把 Ubuntu 的集成开关关掉

然后点 Apply & Restart。

## 第五步:验证安装成功(全程只用 Windows PowerShell)

重新打开一个 PowerShell(普通权限也行),执行:

### 1)查看 Docker 版本

POWERSHELL
docker version

### 2)跑 hello-world(最关键)

POWERSHELL
docker run --rm hello-world

看到 “Hello from Docker!” 就说明 Docker 已经可以用了。

### 3)确认 Docker Desktop 创建的 WSL 发行版(可选)

POWERSHELL
wsl -l -v

正常会看到:

– docker-desktop
– docker-desktop-data

它们就是 Docker Desktop 用来跑容器的“底座”。你不需要进入它们。

## 第六步:资源占用优化(建议设置,避免电脑变卡)

Docker Desktop → Settings → Resources

建议家用电脑的一个参考值:

– CPU:2~4
– Memory:4~8 GB(如果你电脑 16GB 内存,给 6~8GB 比较舒服)
– Disk image size:按你用途给 30~60GB

Apply & Restart。

## 第七步:把 Docker 数据放到非系统盘(强烈建议)

很多人 C 盘不够用,Docker 镜像/容器会越来越大。

Docker Desktop 通常支持在设置里调整 “Disk image location”(不同版本位置可能略有差异):

Settings → Resources → Advanced(或 Disk)

把磁盘镜像位置改到 D 盘,例如:

– `D:DockerDesktopData`

改完后 Docker Desktop 会提示迁移/重启。

## 第八步:常用命令(Windows 侧,复制就能用)

查看镜像:

POWERSHELL
docker images

查看容器:

POWERSHELL
docker ps -a

运行一个 nginx(浏览器访问 http://localhost:8080):

POWERSHELL
docker run -d --name mynginx -p 8080:80 nginx:latest

停止/删除:

POWERSHELL
docker stop mynginx
docker rm mynginx

清理无用资源(谨慎):

POWERSHELL
docker system prune

## 避坑总结(FAQ)

### 1)Q:不是说“不用 WSL2”吗?为什么还要装?

A:Win11 家用版装 Docker Desktop 时,基本必须用 WSL2 作为后端。

但你可以做到:只在 Windows 操作、不用 Ubuntu、不写任何 Linux 命令。

### 2)Q:Docker Desktop 启动失败/一直转圈

A:优先检查:

– 虚拟化是否开启
– Windows 功能是否启用(WSL / Virtual Machine Platform)

重启通常能解决一半问题。

### 3)Q:`docker: command not found`

A:关掉当前 PowerShell,重新打开一个,再试:

POWERSHELL
docker version

还不行说明 PATH 没刷新或安装未完成。

### 4)Q:拉镜像太慢

A:可以在 Docker Desktop → Settings → Docker Engine 里配置 `registry-mirrors`(你有可用镜像地址的话)

发表评论