docker pull 是从镜像仓库下载镜像到本地的基础命令，语法为 docker pull [options] name[:tag|@digest]，支持指定版本、私有仓库、多架构及镜像摘要等用法，并需注意网络、权限和标签准确性问题。

使用 docker pull 命令下载镜像是 docker 最基础的操作之一，只需一条命令就能从镜像仓库（默认是 docker hub）获取指定镜像到本地。

基本语法和常用写法

最简形式如下：

• docker pull 镜像名 —— 下载最新版（:latest 标签）镜像，例如：docker pull nginx
• docker pull 镜像名:标签 —— 指定版本，例如：docker pull ubuntu:22.04 或 docker pull redis:7.2-alpine
• docker pull 仓库地址/用户名/镜像名:标签 —— 拉取非官方或私有仓库镜像，例如：docker pull registry.example.com/myapp:v1.0

查看是否拉取成功

执行完 docker pull 后，可用以下命令确认镜像已存在本地：

OpenClaw Docker Setup

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

下载

• docker images —— 列出所有本地镜像，检查目标镜像是否在列表中
• docker images | grep 镜像名 —— 快速过滤（如 docker images | grep nginx）

常见注意事项

拉取过程中可能遇到的问题和应对方式：

• 网络慢或超时：可配置国内镜像加速器（如阿里云、中科大源），修改 /etc/docker/daemon.json 并重启 Docker 服务
• 权限错误（如拉取私有仓库）：需先运行 docker login 登录对应仓库
• 镜像名拼写错误或标签不存在：Docker 会提示 manifest unknown，建议去对应仓库网页（如 hub.docker.com）确认准确名称和可用标签
• 不加标签时默认拉取 :latest，但该标签不总代表“最新稳定版”，生产环境建议显式指定语义化版本

小技巧：只拉取不运行

docker pull 本身只负责下载镜像，不会创建或启动容器。后续要用它运行容器，才需 docker run。如果只想预加载镜像（比如提前准备部署环境），拉完就可离线使用（前提是没更新远程镜像）。