Docker CLI 助手

本技能介绍如何使用 Docker 命令行工具 完成常见的容器工作流。

适用场景

在以下情况下使用本技能：

• 用户希望构建或重新构建 Docker 镜像。
• 用户希望运行容器（一次性任务或长期运行服务）。
• 用户希望查看当前存在的容器 / 镜像 / 卷。
• 用户希望停止或删除容器 / 镜像。
• 用户希望查看日志、进入容器执行命令，或检查资源使用情况。

前提条件

• Docker 已安装并正在运行。
• 用户 Shell 中可正常执行 docker version 或 docker info 命令。

如不确定是否已就绪，建议用户运行以下命令确认 Docker 是否可用：

docker version

安全准则

• 优先使用 只读 或非破坏性命令：
  • docker ps、docker ps -a
  • docker images
  • docker logs
  • docker inspect
• 谨慎使用具有破坏性的命令：
  • docker rm、docker rmi
  • docker system prune
  • docker volume rm
• 仅当用户明确表示需要释放资源，并清楚了解将被删除的内容时，才推荐执行破坏性清理操作。

常见工作流

1. 列出并检查容器

列出正在运行的容器：

docker ps

列出所有容器（包括已停止的）：

docker ps -a

详细检查某个容器：

docker inspect 

2. 列出并检查镜像

列出本地镜像：

docker images

检查某个镜像：

docker inspect 

3. 构建镜像

从当前目录下的 Dockerfile 构建镜像：

docker build -t : .

示例：

docker build -t my-app:latest .

若 Dockerfile 位于其他目录中：

docker build -t my-app:latest path/to/context

4. 运行容器

以前台模式运行容器：

docker run --rm -it :

以分离模式（后台服务）运行：

docker run -d --name  :

将容器端口映射到宿主机端口：

docker run -d --name  -p 8080:80 :

将宿主机目录挂载到容器中：

docker run -d --name  -v /host/path:/container/path :

5. 停止与删除容器

停止正在运行的容器：

docker stop 

删除已停止的容器：

docker rm 

一次性完成停止并删除（需执行两条命令）：

docker stop 
docker rm 

6. 删除镜像

按 ID 或名称删除镜像：

docker rmi 

仅当用户确认该镜像不再需要时，才建议执行此操作。

7. 查看日志与执行命令

查看容器日志：

docker logs 

实时流式输出日志（持续跟踪）：

docker logs -f 

进入正在运行的容器启动交互式 shell（前提是容器中存在 /bin/bash）：

docker exec -it  /bin/bash

或使用 /bin/sh：

docker exec -it  /bin/sh

8. 清理资源

仅当用户明确要求清理时，才建议执行以下操作：

• 删除所有已停止的容器：

docker container prune

• 删除未被使用的镜像：

docker image prune

• 删除所有未被使用的资源（包括容器、网络、镜像，以及可选的卷）：

docker system prune

如需更彻底的清理，但仅限用户明确确认后执行：

docker system prune -a

故障排查提示

• 若无法拉取镜像，请检查：
  • 网络连接是否正常。
  • 是否已完成镜像仓库认证（如使用私有仓库）。
• 若端口已被占用，建议：
  • 修改 -p host:container 中的宿主机端口号。
  • 或终止当前占用该端口的进程。
• 若容器启动后立即退出，请建议：
  • 通过 docker logs 检查错误日志。
  • 检查容器的 entrypoint 和 command 配置。