梯子Z 来自巴黎的稳定快速安全ShadowsocksR梯子返回首页

docker images 命令怎么用?查看、筛选、格式化与安全清理镜像

更新于 2026-11-19 · zionladderq.shop

简答:docker images 是 docker image ls 的别名,用来查看本机镜像。先运行 docker images;看不到中间层或 dangling 镜像时使用 docker images -a,出现 <none>、拉取失败或删不掉镜像,可跳到下方对应小节排查。

定义:docker images 是 Docker CLI 中用于列出本机镜像的命令别名,标准写法是 docker image ls。

先试这组命令:查看、筛选、完整 ID 与清理

本文为独立整理,非 Docker 官方,引用页面仅作参考,与本站无合作关系。Docker 官方文档将 docker images、docker image list 和 docker image ls列为别名。刚开始排查时,可以先复制下面的命令。

任务命令说明
查看本机镜像docker images列出默认可见的顶层镜像
显示全部镜像docker images -a显示中间层和 dangling 镜像
按仓库查看docker images alpine按仓库名精确筛选
按仓库与标签查看docker images alpine:3.21按仓库和标签精确筛选,标签仅作示例
只输出镜像 IDdocker images -q适合脚本或后续批量处理
显示完整 IDdocker images --no-trunc显示完整的 sha256 镜像 ID
显示摘要docker images --digests增加 digest 列
筛选 dangling 镜像docker images --filter "dangling=true"只显示未关联当前标签的镜像

当前 Docker CLI 参考文档说明,默认列表隐藏中间层和 dangling 镜像,-a用于显示全部镜像;如果你的本机输出不同,应继续核对 Docker Engine 版本、镜像存储后端和实际命令结果。参考:docker image ls 官方文档。

输出列怎么看?先用真实样例分清镜像与标签

下面的输出展示了同一镜像拥有多个标签,以及一个 <none>:<none> 条目。实际创建时间、ID 和大小会因本机内容不同而变化。

$ docker images

REPOSITORY   TAG       IMAGE ID       CREATED        SIZE
alpine       latest    4bcff63911     2 days ago     8.67MB
alpine       3.21      4bcff63911     2 days ago     8.67MB
<none>       <none>   91f3c2b1a4     3 days ago     8.67MB
ubuntu       24.04     35a8880255     5 days ago     78.1MB
列含义排查重点
REPOSITORY镜像仓库名称确认仓库名是否写对
TAG标签,例如 latest、3.21同一仓库可能同时存在多个标签
IMAGE ID本地镜像 ID 的缩写多个标签出现相同 ID,通常表示它们指向同一镜像
CREATED镜像创建时间不是本机下载时间
SIZE镜像及父层的累计大小多个标签显示相同大小,不代表磁盘保存了多份完整内容

<none>:<none>通常表示没有当前仓库和标签引用的 dangling 镜像。当前官方文档将 dangling 镜像列为默认隐藏对象,因此可用 docker images -a或 docker images --filter "dangling=true"检查;如果切换过镜像存储后端,还要注意另一后端创建的镜像可能暂时不可见。Docker containerd image store 文档说明,切换后端会隐藏另一后端中的既有镜像和容器。

docker images、docker image ls 与 docker ps 的区别

命令查看对象典型用途
docker images本机镜像查看可用于创建容器的镜像
docker image ls本机镜像标准子命令写法,便于与其他 image 命令统一
docker ps运行中的容器查看当前正在运行的容器
docker ps -a全部容器包含已停止容器,排查删除冲突时必须检查

镜像是创建容器的基础文件,容器是镜像启动后的实例。常见操作链路如下:

docker pull alpine:3.21
docker images alpine
docker run --name demo-alpine alpine:3.21
docker ps -a
docker image inspect alpine:3.21

docker pull从镜像仓库下载镜像,docker run创建并启动容器,docker image inspect查看镜像元数据。若仓库需要认证,应先执行 docker login registry.example.com,再运行拉取命令。参考:docker image pull 官方文档和docker login 官方文档。

按仓库、标签和 filter 筛选镜像

直接写仓库名或仓库加标签时,参数是精确匹配,不是普通的部分字符串搜索:

docker images alpine
docker images alpine:3.21
docker images alpine:does-not-exist
docker images alp

docker images alp不会因为包含 alp就自动匹配 alpine;不存在的标签或仓库返回空列表属于正常结果。需要模式匹配时,使用 --filter reference:

docker images --filter "reference=alpine"
docker images --filter "reference=alpine:*3*"
docker images --filter "reference=busy*:uclibc" --filter "reference=busy*:glibc"
docker images --filter "dangling=true"

Docker 的过滤器使用键值形式。对同一筛选键传入多个值时,官方示例按 OR 处理,例如上面的两个 reference条件会匹配 uclibc 或 glibc;不同命令支持的字段和组合规则可能不同,应以对应命令文档为准。参考:Docker Filter commands和docker image ls 的过滤示例。

用 --format 输出表格、JSON 和可复制清单

默认表格适合人工阅读;排查或脚本处理时,可以用 --format只保留需要的字段:

docker images --format "table {{.Repository}}\t{{.Tag}}\t{{.ID}}\t{{.Size}}"
docker images --format "{{.ID}} {{.Repository}}:{{.Tag}}"
docker images --format "{{json .}}"
docker images --no-trunc --format "table {{.Repository}}\t{{.Tag}}\t{{.ID}}"

常用模板字段包括 .ID、.Repository、.Tag、.Digest、.CreatedSince、.CreatedAt和 .Size。只需要镜像 ID 时使用:

docker images -q
docker images --filter "reference=alpine" -q

需要核对镜像摘要时使用 --digests;需要区分多个相似短 ID 时,再组合 --no-trunc。

镜像列表为空或 docker pull 失败:按连接层次排查

  1. 先确认当前 Docker 引擎。 执行 docker images和 docker ps -a,确认不是在不同引擎或不同存储后端之间切换后查看。
  2. 确认仓库和标签。 先执行 docker images alpine;本地没有结果时,再用明确的仓库和标签执行 docker pull alpine:3.21。
  3. 区分认证与网络。 私有仓库先执行 docker login registry.example.com;如果出现超时、解析失败或连接被重置,再检查 DNS、代理和链路。
  4. 测试 Registry 的 HTTPS 建连。 Windows 使用 curl.exe:
curl.exe -I https://registry-1.docker.io/v2/

如果返回 401 Unauthorized,并不一定表示连接失败。Registry 在需要认证时本来就可能先返回 401 和 WWW-Authenticate认证挑战,说明请求已经到达认证流程。参考:Registry authentication 官方文档。

如果使用 Docker Desktop,应在 Docker Desktop 的代理设置中核对代理模式和地址;官方文档说明,Docker Desktop 的代理设置会用于镜像拉取,且 Docker Desktop 不使用 daemon.json中的 daemon 代理配置。Linux Engine 则可根据 daemon 排障文档检查 DNS 配置和 daemon 配置文件。参考:Docker Desktop settings、Daemon proxy configuration和Troubleshooting the Docker daemon。

若 HTTPS 已建连但拉取仍超时,再把问题拆成 DNS 解析、代理转发、Registry 认证和镜像层下载四段分别测试,不要只依据浏览器能否打开网页判断 Docker 引擎链路。

rm、rmi、prune 和 prune -a 怎么选?

命令影响范围使用前检查
docker image rm IMAGE删除指定镜像或移除指定标签检查标签、镜像 ID 和容器引用
docker rmi IMAGEdocker image rm的别名多个标签可能需要分别移除
docker image prune清理 dangling 镜像确认未关联标签的镜像不再需要
docker image prune -a清理未被任何容器引用的镜像确认后续不需要快速复用这些镜像

删除前先检查运行中和已停止的容器:

docker ps -a
docker images --no-trunc
docker image inspect alpine:3.21
docker image rm alpine:3.21

如果镜像有多个标签,按标签删除可能只移除一个标签;如果镜像仍被容器引用,删除可能失败。不要一开始就使用 -f强制删除。官方 docker image rm文档还展示了按镜像 ID 删除时,多个仓库标签可能触发冲突;这与容器引用导致的冲突不是同一种情况。参考:docker image rm 官方文档。

只清理 dangling 镜像时运行:

docker images --filter "dangling=true"
docker image prune

需要扩大到所有未被容器引用的镜像时运行:

docker image prune -a
docker image prune -a --filter "until=240h"

prune -a的范围明显大于普通 prune,共享开发机或生产环境中应先确认镜像是否仍由脚本、构建流程或已停止容器使用。参考:docker image prune 官方文档。

常见问题

docker images 和 docker image ls 是同一个命令吗?

是。Docker 官方文档将 docker images、docker image list和 docker image ls列为别名,作用都是列出本机镜像。

为什么 docker images 看不到某些镜像?

当前 Docker CLI 文档说明,默认列表隐藏中间层和 dangling 镜像;先运行 docker images -a查看全部,再用 docker images --filter "dangling=true"单独检查 dangling 镜像。如果切换过镜像存储后端,还要检查另一后端中的镜像是否因此暂时不可见。

为什么出现 <none>:<none>?

这通常表示本地镜像没有当前仓库和标签引用。它不一定代表损坏,可以先用 docker image inspect IMAGE_ID查看,再决定是否使用 docker image prune清理。

为什么 docker images alpine:does-not-exist 没有输出?

仓库和标签参数要求精确匹配。该示例标签不存在时返回空列表属于正常结果;先运行 docker images alpine查看本地已有标签,再选择正确标签或执行 docker pull。

为什么镜像删除时报冲突?

先运行 docker ps -a检查运行中和已停止的容器,再检查镜像是否有多个标签。容器引用冲突与多个标签导致的镜像 ID 冲突处理方式不同,不建议未经确认直接使用 docker image rm -f。

为什么 curl.exe 返回 401 仍可能是正常的?

Registry 需要认证时会先返回 401 Unauthorized以及 WWW-Authenticate头,客户端随后再获取令牌。判断连接是否成功时,应结合是否收到 HTTP 响应、是否能解析域名和 Docker CLI 的具体错误一起看。

常见问题

docker images 和 docker image ls 是同一个命令吗?

是。docker images、docker image list 和 docker image ls 都是列出本机镜像的命令别名。

如何查看中间层和 dangling 镜像?

运行 docker images -a 查看全部镜像;需要单独筛选 dangling 镜像时,运行 docker images --filter "dangling=true"。当前 Docker CLI 文档将两者都列为默认隐藏对象。

如何只查看某个仓库或标签?

使用 docker images 仓库名查看仓库,例如 docker images alpine;使用 docker images alpine:3.21 时,仓库和标签必须精确匹配。

删除镜像前需要检查什么?

先运行 docker ps -a 检查运行中和已停止的容器,再检查镜像是否有多个标签或仍被容器引用。确认前不要直接使用 docker image rm -f。

docker pull 失败但 curl 返回 401,说明网络不通吗?

不一定。Registry 需要认证时会正常返回 401 和 WWW-Authenticate 认证挑战,说明请求已到达认证流程;还要结合 DNS、代理和 Docker CLI 的具体报错判断。

相关阅读

参考资料

  1. docker image ls | Docker Docs
  2. containerd image store with Docker Engine | Docker Docs
  3. Filter commands | Docker Docs
  4. docker image pull | Docker Docs
  5. docker login | Docker Docs
  6. Registry authentication | Docker Docs
  7. Change your Docker Desktop settings | Docker Docs
  8. Daemon proxy configuration | Docker Docs
  9. Troubleshooting the Docker daemon | Docker Docs
  10. docker image rm | Docker Docs
  11. docker image prune | Docker Docs