windows装docker核心是配对wsl2引擎、打通网络、配置国内镜像源：必须执行wsl --install启用并设为默认版本，安装时勾选wsl2组件，手动开启ubuntu集成，禁用自动生成resolv.conf并设dns，最后配置registry-mirrors加速镜像拉取。
Windows 系统装 Docker，核心不是“装完就完事”，而是配对底层引擎、打通 WSL2、调通网络、换好国内镜像源——四步缺一不可。直接双击安装包走完向导，大概率会卡在拉镜像失败或 docker run hello-world 报错。
以下按真实使用场景拆解关键配置环节，不讲虚的，只说必须做的动作：
必须启用 WSL2 并设为默认
Docker Desktop 在 Windows 上默认依赖 WSL2（不是 Hyper-V），尤其家庭版只能走这条路。 - 以管理员身份打开 PowerShell，一次性执行：wsl --install
这条命令会自动启用子系统、安装 Ubuntu、更新内核、设为默认版本。 - 安装完务必重启电脑。 - 重启后验证：在 PowerShell 输入 wsl --status，看到 “Default Version: 2” 和 “Kernel version: 5.15.x” 或更高，才算到位。 - 若已装过旧版 WSL，补一句：wsl --set-default-version 2安装 Docker Desktop 时勾选 WSL2 组件
- 下载官方最新版（[desktop.docker.com](https://desktop.docker.com) 或国内镜像源如 GitHub release 页面）。 - 运行安装程序时，**必须勾选**：✅ Install required Windows components for WSL 2
✅ Add shortcut to desktop（可选）
- 不要跳过这一步——它会自动安装 WSL2 内核更新包、注册发行版支持，否则后续集成会断。手动开启 Ubuntu 的 WSL 集成
Docker Desktop 默认不自动启用任意 Linux 发行版，得你主动授权： - 启动 Docker Desktop（首次启动可跳过登录）； - 点右上角⚙️ → Settings → Resources → WSL Integration； - 找到你装的发行版（比如 Ubuntu-22.04），**打开开关**； - 点 Apply & Restart。 - 验证：在 Ubuntu 终端里执行 docker --version 和 docker info，能正常返回，说明容器引擎已透传进 WSL。国内网络必须配 DNS + 镜像源
不配这两项，90% 的人会遇到 “lookup registry-1.docker.io: no such host” 或拉镜像超时。 - 先禁用 WSL 自动重写 DNS：在 Ubuntu 中运行：sudo nano /etc/wsl.conf
[network]
generateResolvConf = false
sudo nano /etc/resolv.conf
清空内容，只留两行：nameserver 114.114.114.114
nameserver 8.8.8.8
{"registry-mirrors": ["https://u6zjyq7n.mirror.aliyuncs.com"]}
（替换为当前有效地址，如 https://hub-mirror.c.163.com 或 https://docker.mirrors.ustc.edu.cn）装完验证只需两行命令：
docker --version → 看输出版本号
docker run hello-world → 看到 “Hello from Docker!” 就算真正跑通。
