容器与云原生 / 系统课时

验证 Docker 环境

验证 Docker 环境

本课通过 docker version、docker info 和测试容器逐层检查 Docker 环境,帮助你确认客户端、守护进程、镜像下载与容器运行链路都已正常工作,并快速定位常见失败。

学习目标

  • 检查 Docker 客户端与服务端是否能够正常通信
  • 使用系统信息确认运行时和基础配置
  • 通过测试容器完成最终验收并处理常见错误

先理解验证顺序

Docker 验证应按“命令是否存在、客户端能否连接服务端、容器能否实际运行”的顺序进行。只检查版本号不足以证明环境可用,因为客户端可能已经安装,但 Docker 守护进程尚未启动。

检查客户端与服务端版本

执行下面的命令查看客户端和服务端信息:

bash
docker version

正常情况下,输出中应同时出现 Client 和 Server 两部分,版本号会随实际安装版本变化:

text
Client: Docker Engine - Community
 Version:           <CLIENT_VERSION>
 ...

Server: Docker Engine - Community
 Engine:
  Version:          <SERVER_VERSION>
 ...

若只看到客户端信息,随后出现无法连接 Docker daemon 的错误,说明命令行工具已经存在,但守护进程未运行,或当前客户端连接到了错误的 Docker 上下文。

查看 Docker 系统信息

docker info 会读取服务端的容器数量、镜像数量、存储驱动、日志驱动和运行时等信息,比单纯查看版本更适合判断服务端是否真正可用。

bash
docker info

预期输出会包含类似字段,具体数值和驱动名称可能不同:

text
Server:
 Containers: <COUNT>
 Images: <COUNT>
 Storage Driver: <DRIVER>
 Logging Driver: <DRIVER>
 Cgroup Driver: <DRIVER>
 Docker Root Dir: <PATH>

重点确认命令没有连接错误,并且 Docker Root Dir、存储驱动等服务端字段能够正常返回。首次安装时容器和镜像数量为 0 属于正常现象。

运行测试容器

下面的命令会拉取官方测试镜像、启动容器、打印结果,并在容器退出后自动删除容器实例:

bash
docker run --rm hello-world

首次执行可能先显示镜像下载过程,最终应看到下面的关键内容:

text
Hello from Docker!
This message shows that your installation appears to be working correctly.

这一步同时验证了客户端请求、守护进程响应、镜像仓库访问、镜像解压、容器创建和标准输出。如果该命令成功,Docker 的基础运行链路已经打通。

处理常见失败

找不到 docker 命令

若终端提示 docker: command not found,通常是 Docker 尚未安装,或可执行文件不在 PATH 中。先重新打开终端;若仍然失败,应检查安装是否完成,而不是继续排查守护进程。

无法连接 Docker daemon

Linux 系统可以用 systemd 启动并检查 Docker 服务:

bash
sudo systemctl enable --now docker
systemctl is-active docker

预期输出:

text
active

若状态不是 active,继续执行 systemctl status docker 或 journalctl -u docker 查看启动日志。Windows 和 macOS 使用 Docker Desktop 时,应先确认应用已经启动并显示 Docker 正在运行。

当前用户没有权限

Linux 上出现访问 /var/run/docker.sock 被拒绝时,可以暂时使用 sudo docker ... 验证,也可以把当前用户加入 docker 组:

bash
sudo usermod -aG docker "$USER"
newgrp docker
docker info --format '{{.ServerVersion}}'

预期输出为当前服务端版本:

text
<SERVER_VERSION>

加入 docker 组后通常需要重新登录才能让所有终端会话生效。该组能够以接近 root 的权限控制主机,只有受信任用户才应加入。

镜像拉取失败

若 hello-world 在下载阶段失败,应检查 DNS、代理、防火墙和镜像仓库访问。此时 Docker 服务本身可能正常,可先运行下面的命令确认服务端仍能响应:

bash
docker ps

预期输出至少包含表头;没有正在运行的容器时,列表为空是正常的:

text
CONTAINER ID   IMAGE   COMMAND   CREATED   STATUS   PORTS   NAMES

最终验收标准

Docker 环境可以通过以下三个条件验收:docker version 同时返回客户端和服务端信息,docker info 能读取服务端配置,docker run --rm hello-world 能输出成功提示。三项都通过后,才说明环境不仅“安装过”,而且能够真正运行容器。

本课总结

  • docker version 用于确认客户端与服务端通信
  • docker info 用于检查 Docker 运行时和系统配置
  • 测试容器成功运行,才算完成镜像下载与容器执行的最终验收

下一课预告

下一课将进入容器操作,学习如何拉取镜像、启动容器,并观察容器从创建到退出的基本生命周期。

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

目录与阅读设置

阅读设置

17

记录一个想法

验证 Docker 环境

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

登录哪都通