windows 10 上部署 docker engine 的本质是在 wsl2 中安装原生 linux 版 dockerd:先启用 wsl2 并安装 ubuntu,再通过官方仓库安装 docker-ce、配置镜像加速、加入 docker 用户组,最终运行 docker run hello-world 验证纯 linux 容器环境。
在 windows 10 上部署 docker engine(即原生 linux 容器运行时)与安装 docker desktop 是两回事。docker engine 本身是 linux 服务进程(dockerd),不能直接在 win10 原生运行;它必须依托于 linux 内核环境。因此,在 win10 中“部署 docker engine”,实际是指:
✅ 通过 WSL2 运行一个 Linux 发行版(如 Ubuntu),再在该发行版中安装并运行原生 Docker Engine
(这是最接近“真 Docker Engine”的方式,也是生产级调试、CI/CD 本地复现、或避免 Docker Desktop 闭源组件的推荐路径)
一、确认前提条件(必须满足)
- Windows 10 版本 ≥ 2004(Build 19041+),专业版 / 企业版 / 教育版(家庭版需手动启用 WSL2,见后文说明)
- 已开启硬件虚拟化(BIOS 中开启 Intel VT-x / AMD-V)
- 启用 WSL2 支持(系统自动或手动完成)
- 至少 4GB 内存、10GB 可用磁盘空间
? 提示:Docker Desktop 内部也依赖 WSL2,但它封装了
dockerd并提供 GUI 和 Windows 集成;而本方案是「裸装」Engine,更轻量、更可控、更贴近服务器环境。
二、安装 WSL2 并配置 Ubuntu(推荐 Ubuntu 22.04 或 24.04)
以管理员身份打开 PowerShell,执行:
wsl --install
该命令会自动:
- 启用 WSL 功能和虚拟机平台
- 下载并安装 WSL2 内核更新包
- 设置 WSL2 为默认版本
- 安装默认发行版(通常是 Ubuntu)
安装完成后重启电脑。启动 Ubuntu,设置用户名密码。
验证:
wsl -l -v # 应显示类似:Ubuntu 24.04 Running WSL2
三、在 Ubuntu 中安装 Docker Engine(官方方式,非 apt install docker.io)
⚠️ 注意:sudo apt install docker.io 安装的是旧版(Docker 20.10.x 或更早),且非上游维护,不推荐。
正确步骤如下:
1. 卸载旧版(如有)
sudo apt remove docker docker-engine docker.io containerd runc sudo rm -rf /var/lib/docker /var/lib/containerd
2. 安装依赖
sudo apt update sudo apt install -y ca-certificates curl gnupg lsb-release
3. 添加 Docker 官方 GPG 密钥和仓库
sudo mkdir -p /etc/apt/keyrings curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg echo \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \ $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
4. 安装 Docker Engine
sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
5. 启动并设为开机自启
sudo systemctl enable docker sudo systemctl start docker
6. 验证(无需 root 权限运行容器)
sudo usermod -aG docker $USER # 退出终端,重新登录 Ubuntu 或运行:newgrp docker docker run hello-world
✅ 成功输出 “Hello from Docker!” 即表示 Docker Engine 已就绪。
四、可选但强烈建议的优化项
▪ 配置国内镜像加速(加快 pull)
编辑 /etc/docker/daemon.json(若不存在则新建):
{
"registry-mirrors": [
"https://docker.m.daocloud.io",
"https://docker.mirrors.ustc.edu.cn",
"https://dockerproxy.com"
]
}
然后重启服务:
sudo systemctl restart docker
▪ 检查是否使用 WSL2 后端(关键!)
确保 docker info 中显示:
Server Version: 26.x.x Kernel Version: 5.15.x (or higher) Operating System: Ubuntu 24.04 LTS OSType: linux Architecture: x86_64
且无 Windows 字样 —— 这说明你运行的是纯 Linux Engine,不是 Windows 容器模式。
五、家庭版用户特别说明
Win10 家庭版默认无 Hyper-V,但 WSL2 不依赖 Hyper-V(它基于轻量虚拟机管理程序)。只要系统版本 ≥ 2004,执行 wsl --install 即可,无需改注册表、无需手动装 Hyper-V。
若提示错误,可手动启用:
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart # 重启后运行:wsl --update
不复杂但容易忽略:Docker Engine 在 Win10 的本质,是“跑在 WSL2 里的 Linux 服务”。你操作的 docker 命令,实际是调用 Ubuntu 中的 dockerd,所有镜像、容器、网络都存在于 WSL2 虚拟文件系统中。这正是它稳定、高效、兼容服务器部署的关键。











