容器与云原生 / 系统课时

在 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,执行以下命令:

powershell
wsl --install
wsl --update
wsl --status

wsl --install 在已安装 WSL 的机器上可能只显示帮助或当前状态;系统提示重启时,应先重启再继续。wsl --update 用于更新 WSL 组件。预期输出

text
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 中执行:

powershell
docker version
docker info --format '{{.OSType}}'

预期输出

text
Client:
 Version: <CLIENT_VERSION>

Server:
 Engine:
  Version: <SERVER_VERSION>

linux

版本号和省略字段会因安装版本不同而变化。看到 Client、Server 和 linux,说明 Windows 上的 Docker CLI 已连接到运行 Linux 容器的服务端。

运行第一个容器

执行官方测试镜像。--rm 表示容器退出后自动删除,避免留下无用的停止状态容器。

powershell
docker run --rm hello-world

预期输出

text
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 容器成功输出并退出。

只要其中一项失败,就说明环境尚未完成,不应直接进入后续镜像和容器命令练习。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

在 Windows 上安装 Docker

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通