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。如果只想预加载镜像（比如提前准备部署环境），拉完就可离线使用（前提是没更新远程镜像）。
