docker pull 是获取远程镜像的唯一标准命令，用于从仓库下载镜像到本地，支持省略仓库地址（默认 Docker Hub）、指定标签、平台（--platform）或内容摘要（@sha256），并需配合 docker login 访问私有仓库。docker pull 是获取远程镜像的唯一标准命令，不涉及推送操作（推送用 docker push）。它直接从仓库下载镜像到本地，后续才能运行或构建容器。
明确镜像地址与标签
镜像名格式为 [仓库地址/][命名空间/]镜像名[:标签]，省略部分会自动补全：
- 不写仓库地址 → 默认走 Docker Hub：
docker pull nginx等价于docker pull docker.io/library/nginx:latest - 指定版本更安全：如
docker pull redis:7.2-alpine，避免 latest 指向意外更新 - 拉取私有或国内加速镜像需写全地址：如
docker pull registry.cn-hangzhou.aliyuncs.com/library/memcached:1.6
支持按平台或摘要精准拉取
某些场景下标签不够唯一，可用更确定的方式：
- 跨架构拉取：在 ARM 设备上跑 x86 镜像需声明平台，如
docker pull --platform linux/amd64 node:18 - 基于内容寻址：用 digest（sha256 值）确保镜像完全一致，例如
docker pull nginx@sha256:abc123...，适合合规或审计要求高的环境
验证与常见问题处理
拉取完成后立即检查是否成功：
- 执行
docker images，确认输出中包含对应 REPOSITORY、TAG 和 IMAGE ID - 国内用户若遇到慢或超时，应提前配置镜像加速器（如阿里云、中科大地址），该设置在
/etc/docker/daemon.json中生效 - 私有仓库拉取前必须先
docker login registry.example.com，否则提示 “unauthorized”
批量与静默操作
自动化脚本中常用简化输出或拉取全部变体：
- 只输出镜像 ID（便于管道处理）：
docker pull -q python:3.11 - 拉取某镜像所有已发布标签：
docker pull -a ubuntu（注意：耗时长、占磁盘，慎用） - 拉取中断后可重试，Docker 自动续传已下载的镜像层
