容器与云原生 / 系统课时
在 Windows 上安装 Docker
在 Windows 上安装 Docker
本课完成 Windows 开发环境的 Docker Desktop 安装,并通过 WSL 2 后端运行 Linux 容器。最终验收标准不是“安装程序执行完成”,而是 Docker CLI 能连接服务端,且测试容器能够正常启动并退出。
学习目标
- 检查并启用 WSL 2 环境
- 完成 Docker Desktop 安装与后端配置
- 运行命令验证 Docker Engine 和容器
安装前检查
Docker Desktop 使用 WSL 2 后端时,需要系统已启用 WSL,并具有可用的 WSL 2 内核。先以管理员身份打开 PowerShell,执行以下命令:
wsl --install
wsl --update
wsl --statuswsl --install 在已安装 WSL 的机器上可能只显示帮助或当前状态;系统提示重启时,应先重启再继续。wsl --update 用于更新 WSL 组件。预期输出
Default Distribution: <DISTRIBUTION>
Default Version: 2
Kernel version: <WSL_KERNEL_VERSION>实际字段会随系统语言和 WSL 版本变化。关键检查项是默认版本为 2,并且能够读取内核版本。若命令提示虚拟化不可用,需要先在 BIOS 或 UEFI 中启用 CPU 虚拟化。
安装 Docker Desktop
从 Docker 官方页面下载 Windows 安装程序并运行。安装过程中保留 WSL 2 后端选项;完成后从开始菜单启动 Docker Desktop,接受必要协议并等待状态显示为可用。
进入 Docker Desktop 的设置页面,在 General 中确认使用 WSL 2 引擎。需要从某个 Linux 发行版直接执行 Docker 命令时,再到 Resources 的 WSL Integration 中启用对应发行版。
不要在已由 Docker Desktop 集成的 WSL 发行版中额外安装另一套 Docker Engine,否则可能连接到不同守护进程,造成镜像和容器彼此不可见。
验证客户端与服务端
在 PowerShell 中执行:
docker version
docker info --format '{{.OSType}}'预期输出
Client:
Version: <CLIENT_VERSION>
Server:
Engine:
Version: <SERVER_VERSION>
linux版本号和省略字段会因安装版本不同而变化。看到 Client、Server 和 linux,说明 Windows 上的 Docker CLI 已连接到运行 Linux 容器的服务端。
运行第一个容器
执行官方测试镜像。--rm 表示容器退出后自动删除,避免留下无用的停止状态容器。
docker run --rm hello-world预期输出
Hello from Docker!
This message shows that your installation appears to be working correctly.首次运行需要下载镜像,耗时取决于网络。输出中可能还有步骤说明,但必须出现 Hello from Docker!,且命令最终正常返回 PowerShell。
典型失败处理
如果出现无法连接 Daemon 的错误,先确认 Docker Desktop 已启动,而不是反复重装 CLI。随后执行 wsl --status,检查 WSL 2 是否可用。
如果镜像下载超时,先验证代理、DNS 和企业网络策略。Docker Desktop 中配置的代理应与当前网络一致,不要通过关闭安全软件长期绕过问题。
如果在 WSL 终端中找不到 docker 命令,检查该发行版是否已开启 WSL Integration,并确认当前进入的是正确发行版。
验收清单
安装完成后,应同时满足:Docker Desktop 状态正常;docker version 显示 Client 与 Server;服务端操作系统类型为 linux;hello-world 容器成功输出并退出。
只要其中一项失败,就说明环境尚未完成,不应直接进入后续镜像和容器命令练习。