容器与云原生 / 系统课时

查看本地镜像

查看本地镜像

本课解决“本机到底有哪些 Docker 镜像,以及怎样快速缩小查询范围”的问题。完成后,你可以按仓库、标签、镜像 ID 和悬空状态定位目标镜像,并输出适合脚本处理的结果。

学习目标

  • 使用 docker image ls 查看本地镜像及关键字段
  • 按仓库、标签和镜像 ID 缩小查询结果
  • 识别悬空镜像,避免误删仍在使用的镜像

列出本地全部镜像

执行下面的命令可列出当前 Docker 守护进程保存的顶层镜像。docker images 是常见别名,但建议记住结构更清晰的 docker image ls。

bash
docker image ls

预期输出如下,实际镜像 ID、创建时间和大小会不同:

text
REPOSITORY   TAG       IMAGE ID       CREATED       SIZE
nginx        alpine    <IMAGE_ID>     <CREATED>     <SIZE>
redis        7-alpine  <IMAGE_ID>     <CREATED>     <SIZE>

REPOSITORY 表示仓库名,TAG 表示标签,IMAGE ID 是镜像内容标识的短形式。仓库名与标签组合后形成常用引用,例如 nginx:alpine。同一个镜像 ID 可能同时对应多个仓库名或标签。

默认结果不会展示中间层,也会截断镜像 ID。排查重复标签或需要完整标识时,可以增加 --no-trunc。

按仓库和标签筛选

命令末尾可以直接指定仓库,或指定完整的“仓库:标签”。下面只查看本地的 nginx:alpine:

bash
docker image ls nginx:alpine

预期输出如下;如果本地没有该镜像,则只显示表头:

text
REPOSITORY   TAG       IMAGE ID       CREATED       SIZE
nginx        alpine    <IMAGE_ID>     <CREATED>     <SIZE>

只写 nginx 会列出该仓库在本地的全部标签。需要匹配多个仓库命名规则时,可使用引用过滤器,例如 --filter reference='myapp:*',其中通配符由 Docker 处理,而不是由 Shell 展开。

bash
docker image ls --filter "reference=myapp:*"

预期输出为所有仓库名是 myapp 的本地标签;没有匹配项时仅保留表头:

text
REPOSITORY   TAG       IMAGE ID       CREATED       SIZE
myapp        dev       <IMAGE_ID>     <CREATED>     <SIZE>
myapp        test      <IMAGE_ID>     <CREATED>     <SIZE>

按镜像 ID 定位

docker image ls 没有专门的镜像 ID 过滤器。需要按 ID 查找时,可先输出完整 ID,再通过文本工具匹配。下面的示例适用于 Bash 或 Zsh,请把 <IMAGE_ID_PREFIX> 替换为实际前缀:

bash
docker image ls --no-trunc --format '{{.ID}}	{{.Repository}}	{{.Tag}}' | grep '<IMAGE_ID_PREFIX>'

预期输出包含完整 ID、仓库和标签;实际值可能不同:

text
sha256:<IMAGE_ID>	nginx	alpine

如果已知完整或唯一短 ID,也可以直接执行 docker image inspect <IMAGE_ID> 验证它是否存在。脚本中应尽量使用完整 ID,避免短 ID 在镜像较多时出现歧义。

查找悬空镜像

悬空镜像通常表现为仓库名和标签都是 <none>。它们多由重新构建或重新拉取标签产生,当前没有标签直接指向,但仍可能被其他镜像层复用。

bash
docker image ls --filter "dangling=true"

预期输出如下;没有悬空镜像时只显示表头:

text
REPOSITORY   TAG       IMAGE ID       CREATED       SIZE
<none>       <none>    <IMAGE_ID>     <CREATED>     <SIZE>

只需要 ID 时可以增加 -q,便于交给其他命令处理:

bash
docker image ls --filter "dangling=true" -q

预期输出为零行或多行短镜像 ID:

text
<IMAGE_ID>

查询本身不会删除数据。执行 docker image prune 前,应先确认没有构建缓存、停止状态容器或回滚流程依赖这些层。

自定义输出字段

--format 可以去掉固定表头并选择字段,适合脚本、审计或复制结果。下面输出仓库、标签、ID 和大小:

bash
docker image ls --format '{{.Repository}}:{{.Tag}}	{{.ID}}	{{.Size}}'

预期输出如下,具体镜像数量和数值取决于本机:

text
nginx:alpine	<IMAGE_ID>	<SIZE>
redis:7-alpine	<IMAGE_ID>	<SIZE>

常用字段包括 .Repository、.Tag、.ID、.CreatedSince 和 .Size。自动化脚本不要依赖默认表格的列间空格,应使用 --format 输出稳定结构。

本课总结

  • docker image ls 用于查看本地顶层镜像,仓库名与标签共同组成常用镜像引用。
  • 仓库、标签和 reference 过滤器适合常规筛选;按镜像 ID 查询时应输出完整 ID 后再匹配。
  • dangling=true 只负责识别悬空镜像,清理前仍需确认容器和构建流程是否依赖相关层。

下一课预告

下一课将使用 docker image inspect 和 docker image history 深入检查镜像配置、架构、启动命令、环境变量、文件系统层与构建历史。

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

目录与阅读设置

阅读设置

17

记录一个想法

查看本地镜像

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

登录哪都通