首页/云/Docker 容器速查/docker compose images 列出服务镜像
Compose 编排55 条

docker compose images 列出服务镜像

列出项目各服务容器实际使用的镜像与大小:核对版本是否与预期一致、排查镜像错用与体积异常时很方便。

Docker 容器速查云更新于 2026-10-13

核对服务在跑哪个镜像

docker compose images 列出项目里各服务容器实际使用的镜像、标签、镜像 ID 与大小。它回答的是「现在跑着的到底是哪一份」,适合发布后核对版本、排查镜像被错误替换,以及观察体积异常。要注意标签可以被覆盖指向别的内容,因此版本核对的最终依据是镜像 ID 或摘要,而不是标签文字。

基本信息

语法docker compose images [服务…]
输出列容器、仓库、标签、镜像 ID、大小
前提对应服务的容器已经创建
延伸核对docker image inspect 看摘要与构建标签

典型使用场景

  • 发布后核对:确认服务用的是本次发布构建出来的那份镜像
  • 排查错用镜像:多个环境共用一台机器时,确认项目拉的仓库地址正确
  • 体积异常:某个服务镜像突然变大,提示基础镜像或依赖发生变化
  • 回滚核对:回滚后确认服务确实换回了目标版本
  • 写发布记录:把镜像 ID 与摘要记进变更单,便于日后追溯

查询与深挖

查询与深挖
# 列出项目的全部服务镜像
docker compose images

# 只看指定服务
docker compose images web db

# 深入核对镜像摘要与标签
docker image inspect app/web:1.4.2 --format '{{json .RepoDigests}} {{json .Config.Labels}}'

# 与仓库里的版本对照
docker pull app/web:1.4.2 && docker images app/web

输出逐列读法

列含义正常/异常
CONTAINER容器名应与项目服务一一对应
REPOSITORY镜像仓库名与预期的仓库地址一致
TAG镜像标签与本次发布的版本号一致
IMAGE ID镜像 ID版本核对的最终依据
SIZE镜像大小异常增大提示基础镜像或依赖变化
本地同名标签被覆盖后显示的名称不会变化,核对时以镜像 ID 与摘要为准,别只看标签。
服务还没创建容器时查不到记录,先 up 或 start,再核对镜像版本。
多个服务共用同一个镜像时,输出里会出现多行,逐行核对能发现「某个服务漏升级」这类不对称问题。

易错点

  • 只比标签文字:标签可被覆盖,同标签不同内容的情况很常见,核对要落到 ID 与摘要
  • 容器没建就查:输出为空容易误判为项目没在跑,先确认容器状态
  • 忽略镜像体积变化:体积异常增大往往是基础镜像被换掉的早期信号
  • 发布记录只写标签:回滚时无法确认当时的具体内容,把 ID 或摘要一起记下

数据来源与参考

  • Docker 官方 CLI 参考:docker compose images(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌