拉取与查看镜像

约 684 字大约 2 分钟

布欧-Lewyon

2026-05-15

镜像是容器的基础。本节介绍如何从仓库拉取镜像、列出本地镜像、查看详细信息以及搜索镜像。

docker pull 拉取镜像

# 拉取最新标签
docker pull nginx

# 拉取指定标签
docker pull nginx:alpine
docker pull node:20-slim

# 从第三方仓库拉取
docker pull quay.io/prometheus/node-exporter
docker pull ghcr.io/org/myapp:latest

镜像完整命名格式：[registry/][user/]image[:tag]

部分	示例	缺省值
Registry	`docker.io`、`quay.io`、`ghcr.io`	`docker.io`
User/Org	`library`、`nginx`、`node`	`library`（官方镜像）
Tag	`latest`、`alpine`、`1.25`	`latest`

拉取过程

# 拉取时显示各层下载进度
docker pull nginx:alpine

# alpine: Pulling from library/nginx
# a1dce8f103a6: Already exists   # 已有缓存层
# 2c2e7f9eac0b: Pull complete    # 新下载层
# 2e7f9eac0b1a: Pull complete
# Digest: sha256:abc123...       # 镜像摘要
# Status: Downloaded newer image for nginx:alpine

docker images 查看本地镜像

# 列出所有镜像
docker images

# 输出示例
# REPOSITORY   TAG       IMAGE ID       CREATED       SIZE
# nginx        alpine    0e901e68141f   2 weeks ago   42.6MB
# node         20-slim   7f5c3efdc06f   3 weeks ago   238MB
# ubuntu       22.04     a0b6b1d27f5d   4 weeks ago   77.8MB

# 查看镜像大小
docker images --format "table {{.Repository}}\t{{.Tag}}\t{{.Size}}"

# 查看所有镜像（包括中间层）
docker images -a

# 按名称过滤
docker images nginx
docker images --filter=reference='node*'

docker search 搜索镜像

# 搜索 Docker Hub 上的镜像
docker search nginx

# 限制返回条数
docker search --limit 5 redis

# 只显示官方镜像
docker search --filter=is-official=true nginx

docker inspect 查看镜像详细信息

# 查看镜像的完整元数据（JSON 格式）
docker inspect nginx:alpine

输出包含：

Id：镜像 SHA256 摘要
Created：创建时间
ContainerConfig：构建时配置（CMD、ENV、EXPOSE 等）
RootFS：镜像层信息
Architecture：CPU 架构（amd64 / arm64）

# 只取部分信息
docker inspect nginx:alpine --format '{{.Size}}'
docker inspect nginx:alpine --format '{{.RootFS.Layers}}'

查看镜像分层

# 查看镜像的历史层
docker history nginx:alpine

# IMAGE          CREATED       CREATED BY                                      SIZE
# 0e901e68141f   2 weeks ago   /bin/sh -c #(nop)  CMD ["nginx" "-g" "daemon…   0B
# <missing>      2 weeks ago   /bin/sh -c #(nop)  STOPSIGNAL SIGQUIT           0B
# <missing>      2 weeks ago   /bin/sh -c #(nop)  EXPOSE 80                    0B
# <missing>      2 weeks ago   /bin/sh -c set -x     && addgroup -g 101 -S …   7.8MB
# ...

每行对应 Dockerfile 中的一条指令。<missing> 不代表缺失，而是表示该层 ID 在不同系统上可能不同。

管理镜像空间

# 删除镜像
docker rmi nginx:alpine

# 删除所有未使用的镜像（悬空镜像）
docker image prune

# 删除所有未使用的镜像、容器、网络、构建缓存
docker system prune -a

小结

docker pull 拉取镜像，命名格式 [registry/]name[:tag]。
docker images 列出本地镜像，docker search 搜索 Hub。
docker inspect 查看镜像 JSON 详情，docker history 查看分层历史。
定期 docker system prune 清理未使用的镜像和构建缓存。

上一节：Hello World 与第一个容器下一节：镜像命名与标签