docker engine 安装成功需验证三方面:命令可用(docker --version 输出版本号)、服务运行(systemctl status docker 显示 active 或桌面端图标正常)、容器可启动(docker run hello-world 输出 hello from docker!)。
验证 docker engine 是否安装成功,核心是确认三件事:命令可执行、服务在运行、容器能启动。不需要全部步骤都做,但建议逐层检查,快速定位问题。
检查 Docker 命令是否可用
打开终端(Linux/macOS)或 PowerShell(Windows),直接运行:
-
docker --version 或 docker -v:输出类似
Docker version 24.0.7, build afdd...表示二进制已正确安装并加入系统 PATH; - 如果提示
command not found或'docker' is not recognized,说明安装未完成、PATH 未配置,或安装包未实际写入系统。
确认 Docker 服务是否正在运行
Engine 不只是命令行工具,它依赖后台守护进程(daemon)工作:
MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境(极空间等),支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件,不暴露在代码中。
- Linux(systemd 系统):运行 sudo systemctl status docker,看到
Active: active (running)即通过; - macOS(Docker Desktop):检查菜单栏是否有鲸鱼图标,且状态为“Running”;
- Windows(Docker Desktop):任务栏右下角有 Docker 图标,鼠标悬停显示 “Docker Desktop is running”;
- 若服务未启动,Linux 可用 sudo systemctl start docker 启动,并用 sudo systemctl enable docker 设置开机自启。
运行一个测试容器验证功能完整
前两步只说明“装上了”,这一步才真正检验 Engine 能否拉取镜像、创建并运行容器:
- 执行 sudo docker run hello-world(Linux/macOS)或 docker run hello-world(Windows Docker Desktop 用户通常无需 sudo);
- 首次运行会自动下载
hello-world镜像,然后打印欢迎信息,结尾出现Hello from Docker!字样即表示 Engine 功能正常; - 如果卡在 “Unable to find image” 或报错 “connection refused”,大概率是 daemon 没运行,或网络/代理设置干扰了镜像拉取。
额外建议:查看引擎详细信息
运行 docker info 可一次性获取 Engine 版本、存储驱动、容器数量、镜像数量、运行时等关键状态,适合快速概览整体健康度。输出中 Server Version: 和 Status: running(在 Plugins > containerd 部分)是最值得关注的两行。










