容器与云原生 / 系统课时
查看本地镜像
查看本地镜像
本课解决“本机到底有哪些 Docker 镜像,以及怎样快速缩小查询范围”的问题。完成后,你可以按仓库、标签、镜像 ID 和悬空状态定位目标镜像,并输出适合脚本处理的结果。
学习目标
- 使用
docker image ls查看本地镜像及关键字段 - 按仓库、标签和镜像 ID 缩小查询结果
- 识别悬空镜像,避免误删仍在使用的镜像
列出本地全部镜像
执行下面的命令可列出当前 Docker 守护进程保存的顶层镜像。docker images 是常见别名,但建议记住结构更清晰的 docker image ls。
docker image ls预期输出如下,实际镜像 ID、创建时间和大小会不同:
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:
docker image ls nginx:alpine预期输出如下;如果本地没有该镜像,则只显示表头:
REPOSITORY TAG IMAGE ID CREATED SIZE
nginx alpine <IMAGE_ID> <CREATED> <SIZE>只写 nginx 会列出该仓库在本地的全部标签。需要匹配多个仓库命名规则时,可使用引用过滤器,例如 --filter reference='myapp:*',其中通配符由 Docker 处理,而不是由 Shell 展开。
docker image ls --filter "reference=myapp:*"预期输出为所有仓库名是 myapp 的本地标签;没有匹配项时仅保留表头:
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> 替换为实际前缀:
docker image ls --no-trunc --format '{{.ID}} {{.Repository}} {{.Tag}}' | grep '<IMAGE_ID_PREFIX>'预期输出包含完整 ID、仓库和标签;实际值可能不同:
sha256:<IMAGE_ID> nginx alpine如果已知完整或唯一短 ID,也可以直接执行 docker image inspect <IMAGE_ID> 验证它是否存在。脚本中应尽量使用完整 ID,避免短 ID 在镜像较多时出现歧义。
查找悬空镜像
悬空镜像通常表现为仓库名和标签都是 <none>。它们多由重新构建或重新拉取标签产生,当前没有标签直接指向,但仍可能被其他镜像层复用。
docker image ls --filter "dangling=true"预期输出如下;没有悬空镜像时只显示表头:
REPOSITORY TAG IMAGE ID CREATED SIZE
<none> <none> <IMAGE_ID> <CREATED> <SIZE>只需要 ID 时可以增加 -q,便于交给其他命令处理:
docker image ls --filter "dangling=true" -q预期输出为零行或多行短镜像 ID:
<IMAGE_ID>查询本身不会删除数据。执行 docker image prune 前,应先确认没有构建缓存、停止状态容器或回滚流程依赖这些层。
自定义输出字段
--format 可以去掉固定表头并选择字段,适合脚本、审计或复制结果。下面输出仓库、标签、ID 和大小:
docker image ls --format '{{.Repository}}:{{.Tag}} {{.ID}} {{.Size}}'预期输出如下,具体镜像数量和数值取决于本机:
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 深入检查镜像配置、架构、启动命令、环境变量、文件系统层与构建历史。