docker images 命令怎么用?查看、筛选、格式化与安全清理镜像
简答: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 | 按仓库和标签精确筛选,标签仅作示例 |
| 只输出镜像 ID | docker images -q | 适合脚本或后续批量处理 |
| 显示完整 ID | docker 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.21docker 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 alpdocker 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 失败:按连接层次排查
- 先确认当前 Docker 引擎。 执行
docker images和docker ps -a,确认不是在不同引擎或不同存储后端之间切换后查看。 - 确认仓库和标签。 先执行
docker images alpine;本地没有结果时,再用明确的仓库和标签执行docker pull alpine:3.21。 - 区分认证与网络。 私有仓库先执行
docker login registry.example.com;如果出现超时、解析失败或连接被重置,再检查 DNS、代理和链路。 - 测试 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 IMAGE | docker 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 的具体报错判断。
相关阅读
参考资料
- docker image ls | Docker Docs
- containerd image store with Docker Engine | Docker Docs
- Filter commands | Docker Docs
- docker image pull | Docker Docs
- docker login | Docker Docs
- Registry authentication | Docker Docs
- Change your Docker Desktop settings | Docker Docs
- Daemon proxy configuration | Docker Docs
- Troubleshooting the Docker daemon | Docker Docs
- docker image rm | Docker Docs
- docker image prune | Docker Docs