【AI 总结】docker image ls

docker image ls | AI 总结

基本描述

1. 功能：用于列出本地的 Docker 镜像，默认显示所有顶层镜像的仓库、标签及大小。
2. 镜像层特性：Docker 镜像存在中间层，可提升复用性、减少磁盘占用并加快 docker build 速度，但默认不显示；未标记（悬挂）的镜像也默认隐藏，使用 -a（--all）选项可显示中间层和悬挂镜像。
3. 尺寸说明：显示的 SIZE 是镜像及其所有父镜像占用的累计空间，也是 docker save 命令创建镜像 Tar 文件时的磁盘占用量；若一个镜像有多个仓库名或标签，会多次列出，但仅占用一次所列 SIZE（可通过匹配 IMAGE ID 识别同一镜像）。

命令格式与别名

1. 用法：docker image ls [OPTIONS] [REPOSITORY[:TAG]]
2. 别名：docker image list、docker images

主要选项

选项	默认值	描述
-a, --all	无	显示所有镜像（默认隐藏中间层和悬挂镜像）
--digests	无	显示镜像摘要
-f, --filter	无	根据指定条件过滤输出结果
--format	无	使用自定义模板格式化输出，支持 table（默认带列标题的表格格式）、table TEMPLATE（自定义表格模板）、json（JSON 格式）、TEMPLATE（自定义模板），可参考 https://docs.docker.com/go/formatting/ 了解更多模板相关信息
--no-trunc	无	不截断输出内容
-q, --quiet	无	仅显示镜像 ID
--tree	无	API 1.47+ 实验性选项（命令行界面），以树形结构列出多平台镜像（实验性）

使用示例

1. 列出最新创建的镜像：执行 docker images，默认展示仓库、标签、镜像 ID、创建时间和大小，示例中包含多个不同仓库（如 committ、docker、postgres）及未标记（<none>）的镜像。
2. 按名称和标签列出镜像：
   • 仅指定仓库名（如 java）：docker images java，列出该仓库下所有标签的镜像。
   • 同时指定仓库名和标签（如 java:8）：docker images java:8，仅列出匹配该仓库和标签的镜像；若无匹配项，输出为空（如 docker images java:0）。
   • 注意：[REPOSITORY[:TAG]] 需精确匹配，如 docker images jav 无法匹配 java 镜像。
3. 列出完整长度的镜像 ID：执行 docker images --no-trunc，展示完整的镜像 ID（非截断形式），便于精确识别镜像。
4. 列出镜像摘要：执行 docker images --digests，显示使用 v2 及以上格式镜像的内容可寻址标识符（摘要），该摘要在镜像输入不变时可预测；推送 / 拉取到 2.0 版本仓库时，命令输出包含摘要，且摘要可用于 pull、create、run、rmi 命令及 Dockerfile 中 FROM 镜像引用。
5. 过滤镜像（–filter）：
   • 悬挂镜像（dangling）：

     docker images --filter "dangling=true"

     显示未标记的叶子节点镜像（非中间层），可结合 docker rmi 批量清理（如 docker rmi $(docker images -f "dangling=true" -q)），清理时若有容器使用这些镜像，Docker 会发出警告。
   • 标签（label）：
     • 匹配指定标签（无论值）：

       docker images --filter "label=com.example.version"

     • 匹配指定标签及值：

       docker images --filter "label=com.example.version=1.0"

       若值不匹配（如 0.1），输出为空。
   • 时间（before/since）：
     • before：

       docker images --filter "before=image1"

       显示在指定镜像（如 image1，可通过镜像名、ID 或摘要指定）创建之前的镜像。
     • since：

       docker images --filter "since=image3"

       显示在指定镜像（如 image3）创建之后的镜像。
   • 引用（reference）：按镜像引用模式过滤，如

     docker images --filter=reference='busy*:*libc'

     匹配仓库名以 busy 开头、标签包含 libc 的镜像；支持多个引用过滤（如同时匹配 busy*:uclibc 和 busy*:glibc）。
6. 格式化输出（–format）：使用 Go 模板自定义输出格式，支持的占位符及描述如下：

   占位符	描述
   .ID	镜像 ID
   .Repository	镜像仓库
   .Tag	镜像标签
   .Digest	镜像摘要
   .CreatedSince	镜像创建至今的时间间隔
   .CreatedAt	镜像创建时间
   .Size	镜像磁盘大小

   • 无表头输出示例：

     docker images --format "{{.ID}}: {{.Repository}}"

     以 “镜像 ID: 仓库名” 格式展示。
   • 表格格式输出示例：

     docker images --format "table {{.ID}}\t{{.Repository}}\t{{.Tag}}"

     自定义表格列（镜像 ID、仓库名、标签）。
   • JSON 格式输出示例：

     docker images --format json

     以 JSON 格式展示镜像详细信息。