异常教程

docker compose ps 命令（建议收藏）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

在现代软件开发中，容器化技术已成为构建、部署和运行应用程序的标准工具。Docker Compose 作为 Docker 官方提供的编排工具，能够帮助开发者高效管理多容器应用的生命周期。而 docker compose ps 命令则是这一流程中的重要工具，它以简洁直观的方式展示了项目中所有服务的运行状态。无论是调试问题、监控性能还是验证配置，这一命令都是开发者日常工作的核心助手。本文将深入解析 docker compose ps 的功能、参数及实际应用场景，并通过案例演示帮助读者快速掌握其实用性。

一、Docker Compose 的核心概念与工作流程

在讲解 docker compose ps 之前，我们需要先理解 Docker Compose 的基本原理。Docker Compose 是通过 docker-compose.yml 文件定义多容器应用的编排工具。它允许开发者将多个服务（如 Web 服务器、数据库、缓存等）整合到一个配置文件中，通过简单的命令启动、停止或管理所有相关容器。

1.1 Docker Compose 的类比：交响乐团的指挥

可以将 Docker Compose 想象为一个交响乐团的指挥家：

  • 乐谱对应 docker-compose.yml 文件，定义了每个服务（乐器）的配置、依赖关系和启动顺序。
  • 乐手对应各个容器（如 Nginx、MySQL 容器），每个容器负责独立的功能。
  • 指挥家对应 Docker Compose 自身，通过 docker compose up 或 docker compose down 等命令协调所有容器的运行。

而 docker compose ps 则是指挥家用来查看当前乐团成员状态的工具，例如哪些乐手（容器）正在演奏（运行）、是否准备好（状态是否正常）等。

二、docker compose ps 命令的基础用法

2.1 基础语法与输出解析

docker compose ps 命令用于列出当前项目中所有服务及其容器的状态。其基础语法如下：

docker compose ps [选项]

示例 1：查看所有服务状态

docker compose ps

执行后，命令会输出一个表格，包含以下字段：

  • Name：容器的名称（默认格式为 <项目名称>_<服务名称>_<序号>）。
  • Command：容器启动时运行的命令。
  • State：容器的当前状态（如 running、exited 等）。
  • Ports：容器暴露的端口及映射到主机的端口。
  • Health：容器的健康状态（仅当配置了健康检查时显示）。

输出示例：

NAME                  COMMAND               STATE          PORTS                  HEALTH  
webapp_web_1   "nginx -g 'daemon of…"   running      0.0.0.0:80->80/tcp          healthy  
webapp_db_1    "docker-entrypoint.s…"   running      3306/tcp, 33060/tcp         healthy

示例 2：筛选特定服务

若需查看某一个服务的容器状态，可以结合 --filter 参数：

docker compose ps web

这将仅显示 web 服务对应的容器信息。

三、命令参数详解与高级用法

3.1 参数扩展：增强命令的灵活性

docker compose ps 支持多个参数，可进一步细化查询条件或调整输出格式。

3.1.1 --all：显示所有服务，包括未运行的容器

默认情况下，docker compose ps 仅显示处于运行中的容器。若需查看所有服务（包括已停止的容器），可以添加 --all 参数：

docker compose ps --all

3.1.2 --quiet：仅输出容器名称或 ID

当需要将容器名称或 ID 作为后续命令的输入时，可以使用 --quiet 参数简化输出：

docker compose ps --quiet  
webapp_web_1  
webapp_db_1

3.1.3 --services：仅列出服务名称

若只需了解项目中定义的服务列表，而非具体容器状态，可用 --services 参数：

docker compose ps --services  
web  
db

四、实际案例：通过 docker compose ps 监控服务状态

4.1 案例场景：部署一个简单的 Web 应用

假设我们有一个包含 Nginx 和 MySQL 的 Web 应用，其 docker-compose.yml 文件如下：

version: '3'  
services:  
  web:  
    image: nginx:latest  
    ports:  
      - "80:80"  
    depends_on:  
      - db  
  db:  
    image: mysql:8.0  
    environment:  
      MYSQL_ROOT_PASSWORD: example

步骤 1：启动服务并查看状态

docker compose up -d  
docker compose ps

执行后，输出将显示两个服务的状态为 running，且端口映射正确。

步骤 2：模拟故障并排查

假设 MySQL 容器因配置错误而停止，执行 docker compose ps 后，输出可能如下：

NAME                  COMMAND               STATE          PORTS                  HEALTH  
webapp_web_1   "nginx -g 'daemon of…"   running      0.0.0.0:80->80/tcp          healthy  
webapp_db_1    "docker-entrypoint.s…"   exited       3306/tcp, 33060/tcp         unhealthy

此时，开发者可通过 docker compose logs db 进一步查看 MySQL 容器的日志，定位问题。

五、常见问题与解决方案

5.1 问题 1：命令执行后无输出或提示“没有服务”

原因：当前目录未找到有效的 docker-compose.yml 文件，或项目名称被重定义。
解决方案：

  • 确认当前路径下存在 docker-compose.yml 文件。
  • 若项目名称被修改过，需通过 --project-name 参数指定名称： 
    docker compose --project-name myapp ps

5.2 问题 2：服务状态显示为 exited

原因：容器因错误退出，可能由于配置错误、资源不足或依赖服务未启动。
解决方案：

  • 使用 docker compose logs <服务名> 查看容器日志。
  • 检查 docker-compose.yml 中的依赖关系和环境变量配置。

六、与 docker ps 的区别与协作

6.1 docker compose ps vs docker ps

  • docker compose ps：专为 Docker Compose 项目设计，仅显示与当前项目相关的容器。
  • docker ps：显示系统中所有容器，需通过 --filter 参数过滤（如 --filter label=com.docker.compose.project）。

6.2 协作场景示例

若需查看所有 Docker Compose 项目中的容器，可以结合 docker ps 和过滤器：

docker ps --filter "label=com.docker.compose.project"

结论

docker compose ps 是开发者日常工作中不可或缺的工具，它简化了多容器应用的监控和调试流程。通过掌握其基础语法、参数扩展及实际案例，开发者能够快速定位问题、优化服务配置，并提升开发效率。随着容器化技术的普及，熟练使用此类命令将成为现代开发者的核心技能之一。建议读者通过实际项目反复练习，逐步深入理解 Docker Compose 的工作原理与最佳实践。

附录：

  • 关键词布局：docker compose ps 命令 在文中自然融入于标题、场景描述及代码示例中，确保 SEO 优化的同时不影响阅读流畅性。
  • 扩展学习：进一步了解 docker compose exec、docker compose down 等命令，可构建完整的容器化开发工作流。

最新发布

查看更多文章