docker pull命令用于从镜像仓库下载镜像到本地，核心是正确指定镜像名、标签（如nginx:1.23.4）或摘要（@sha256），并可选加--platform、-a、-q等参数控制行为；生产环境应避免使用latest，优先指定版本号或digest以确保一致性。

直接用 docker pull 就能下载镜像，核心是写对镜像名和标签，再根据需要加参数控制行为。

基础拉取：指定镜像名和版本

不写标签默认拉 latest，但生产环境建议明确版本号，避免意外更新。

• docker pull nginx → 拉取官方 nginx 的 latest 版本
• docker pull ubuntu:22.04 → 拉取 Ubuntu 22.04 精确版本
• docker pull python:3.11-slim → 拉取轻量版 Python 镜像

从私有或非默认仓库拉取

镜像名可带完整地址，适用于企业内网 registry 或第三方源。

OpenClaw Docker Setup

在 Linux 上通过 Docker 运行 OpenClaw，并使用 Tailscale 实现远程访问。⚠️ 涉及 sudo、Docker、Tailscale和凭证挂载——请先查阅安全章节...

下载

• docker pull harbor.example.com/project/app:1.2.0
• docker pull registry.cn-hangzhou.aliyuncs.com/my-ns/my-image:v2.1

按平台架构拉取（多架构支持）

跨 CPU 架构部署时，用 --platform 明确目标环境，比如 ARM 设备上跑 x86 镜像会失败。

• docker pull --platform linux/arm64 redis:7.2
• docker pull --platform linux/amd64 nginx:alpine

实用技巧与常见注意点

拉取后可用 docker images 查看是否成功；遇到慢或失败，优先检查网络和镜像源配置。

• 国内用户建议配置镜像加速器（如阿里云、中科大），大幅提速
• 想一次性拉完某镜像所有标签，加 -a 参数：docker pull -a alpine
• 只想要镜像 ID 不看进度，用 -q：docker pull -q nginx
• 用 @digest 替代 :tag 可确保内容完全一致，适合安全敏感场景