docker pull
从镜像仓库拉取镜像到本地
语法
docker pull [OPTIONS] NAME[:TAG|@DIGEST]
参数
| 参数 | 说明 | 示例 | 级别 |
|---|---|---|---|
--all-tags |
拉取所有标签版本 | docker pull --all-tags ubuntu |
进阶 |
--platform |
指定平台架构 | docker pull --platform linux/arm64 nginx |
进阶 |
--quiet |
静默模式，只输出镜像 ID | docker pull --quiet nginx |
常用 |
示例
拉取最新版本
docker pull nginx
等价于 docker pull nginx:latest
拉取指定版本
docker pull node:18-alpine
alpine 版本体积更小
拉取指定平台镜像
docker pull --platform linux/amd64 python:3.11
在 ARM Mac 上拉取 x86 镜像
从私有仓库拉取
docker pull registry.example.com/myapp:1.0
需要先 docker login 登录私有仓库
常见错误
Error response from daemon: manifest for xxx not found
镜像名或标签不存在，检查拼写或到 Docker Hub 确认可用标签
Error response from daemon: pull access denied
没有权限，需要 docker login 登录或检查镜像是否为私有
error pulling image: network timeout
网络问题，检查网络连接或配置镜像加速器
技巧
- 生产环境避免用 latest 标签，指定具体版本号确保可复现
- 用 alpine 基础镜像可以大幅减小体积
- 国内用户可配置镜像加速器提升下载速度