首页/云/Docker 容器速查/docker run --pull 拉取策略
基础命令50 条

docker run --pull 拉取策略

控制 run 之前是否联网拉取镜像:missing 用本地优先,always 强制更新 tag,never 只允许使用本地已有镜像(离线环境)。

Docker 容器速查云更新于 2026-10-12
用途控制镜像拉取时机
语法--pull=always|missing|never
默认missing(本地有就不拉)

示例

示例
docker run --rm --pull=always nginx:1.27-alpine nginx -v
docker run --rm --pull=never alpine:3.20 /bin/true

生产建议

生产建议
部署固定版本用 tag + --pull=always
对可重现性要求高时直接按 digest 拉取:nginx@sha256:...
--pull=always 每次都会访问仓库,内网无出口的环境会直接报网络错误,应改用 missing 或预拉取。

易错点

  • always 会覆盖本地同名 tag 的镜像引用,回滚时不要指望本地旧版本还在
  • CI 里用 latest + missing 容易误用缓存旧镜像,固定 tag 或 digest 才能保证每次构建一致

数据来源与参考

  • Docker 官方 CLI 参考:docker run --pull(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌