梯子Z 来自巴黎的稳定快速安全ShadowsocksR梯子返回首页

Docker 镜像是什么?从查找、拉取到运行的完整指南

更新于 2026-11-19 · zionladderq.shop

简答:Docker 镜像是创建容器所需的不可变分层软件包。第一次使用时,先核对仓库来源和 Supported tags,再执行 docker pull;部署或 CI/CD 则记录固定标签与 digest。遇到拉取失败,按标签、权限、429 限流、DNS/代理、架构和磁盘空间顺序排查。

定义:Docker 镜像是包含应用运行所需文件、二进制、依赖库和配置的不可变分层软件包,容器则是从镜像创建并运行的实例。

先看结论:Docker 镜像怎么查、怎么拉、怎么运行

如果你只是想先把一个镜像跑起来,可以按“查找—核对—拉取—检查—运行”五步操作。不要只看镜像名称或搜索结果,先打开仓库页面确认来源、Supported tags、支持架构和使用说明。

Docker 镜像入门五步速查
步骤操作示例
1. 查找搜索镜像仓库docker search nginx
2. 核对查看 Official Image、Verified Publisher 或项目维护者信息核对仓库页的徽标、Dockerfile 和 Supported tags
3. 拉取明确写出仓库和标签docker pull nginx:stable
4. 检查查看本地镜像和摘要docker image ls --digests
5. 运行映射端口并启动容器docker run --name web-demo -d -p 127.0.0.1:8080:80 nginx:stable

Docker 官方的 Docker Hub Quickstart同样采用查找、拉取、运行的基本流程。本文为独立整理,非 Docker 官方,引用页面仅作参考,与本站无合作关系。

Docker 镜像、容器、仓库和 Registry 的区别

四个容易混淆的 Docker 概念
概念定义示例
镜像 Image创建容器所需的不可变分层文件包nginx:stable
容器 Container从镜像创建并运行的实例,拥有进程、网络和可写层web-demo
仓库 Repository存放同一项目不同标签或摘要版本的位置library/nginx
Registry保存和分发仓库的服务端docker.io 或企业 Registry

镜像引用通常写成 [HOST[:PORT]/]NAMESPACE/REPOSITORY[:TAG]。省略 Registry 时,Docker 通常使用 Docker Hub;省略命名空间时,官方镜像常见写法是直接使用仓库名,例如 nginx;省略标签时,命令会使用 latest 标签。latest只是标签名称,不等于“最新、最稳定或最适合生产”。

镜像可以创建多个容器;删除容器也不会自动删除镜像。排查本地空间时,应同时查看镜像、容器、卷和构建缓存。Windows 或 macOS 用户如果尚未启动 Docker 引擎,可先查看站内的Docker Desktop 安装指南;macOS 用户也可以参考Docker Mac 安装与使用指南。

常用 Docker 镜像名称、拉取命令和适用场景

以下仓库页面当前都标记为 Docker Official Image。示例标签仅用于说明命令写法,具体标签、基础发行版和支持架构应以对应仓库当前的 Supported tags 为准。

常用 Docker 镜像速查
仓库拉取示例适用场景核对重点
nginxdocker pull nginx:stable静态文件、反向代理和 Web 服务入口核对 stable、alpine 或发行版代号标签
nodedocker pull node:ltsNode.js 应用构建与运行构建阶段和运行阶段可分别选择完整或 slim 标签
pythondocker pull python:slimPython 服务、脚本和任务容器确认系统库、编译工具和证书是否齐全
postgresdocker pull postgres:17关系型数据库开发和测试查看密码变量、数据目录和版本标签
redisdocker pull redis:alpine缓存、队列和临时数据服务确认应用与 alpine 基础环境兼容
mysqldocker pull mysql:8MySQL 数据库开发和测试核对版本、架构和初始化环境变量

这些页面都提供 Dockerfile 链接和 Supported tags。由于标签会随维护者发布和基础发行版变化,复制命令前应重新打开仓库页面确认标签仍然存在。当前页面中可以看到 node、python、postgres、redis、mysql 和 nginx 的官方镜像标识及标签列表。

不同场景怎么选标签:latest、固定版本、slim、alpine 和发行版代号

Docker 镜像标签选择对照
场景建议写法原因注意事项
本地快速体验stable、lts或仓库当前推荐标签命令短,适合先验证应用能否运行仍要确认仓库当前是否提供该标签
生产部署固定大版本或完整版本,必要时追加 digest便于复现、回滚和审计固定标签也要持续关注安全更新
CI/CD固定标签加 @sha256:...让构建使用确定的镜像内容digest 必须从实际 Registry 或构建记录复制
运行阶段减小体积slim或精简运行时标签可减少不必要的工具和文件编译原生依赖时可能仍需完整构建镜像
追求较小基础镜像alpine适合已确认兼容的应用其 musl libc 可能与部分依赖或预编译包存在差异
依赖特定系统包bookworm、trixie等发行版代号基础系统指向更明确代号和维护状态以仓库当前页面为准,不要凭记忆猜测

官方的Trusted Content 文档区分了 Official Images、Hardened Images、Verified Publisher 和 Sponsored Open Source Software 等内容类型。选择镜像时,来源、维护者、Dockerfile、更新记录、支持架构和应用兼容性应一起核对,而不是只比较镜像大小。

Dockerfile 的 FROM 指令决定基础镜像。Base images 文档说明,基础镜像可以来自 Docker Hub,也可以来自其他 Registry;使用 scratch 等极简基础镜像时,需要自行确认应用所需的证书、动态库和运行文件。

从拉取到持久化运行:端口、数据卷和环境变量

下面用 PostgreSQL 演示一个完整流程。密码通过 --env-file 传入,避免把密码直接写入命令历史。先创建本地文件 pg.env,内容如下:

POSTGRES_PASSWORD=change-this-password

  1. 拉取镜像:docker pull postgres:17

  2. 创建数据卷:docker volume create pgdata

  3. 启动容器:docker run --name pg-demo --env-file pg.env --mount source=pgdata,target=/var/lib/postgresql/data -p 127.0.0.1:5432:5432 -d postgres:17

  4. 检查状态:docker ps --filter name=pg-demo

  5. 查看启动日志:docker logs pg-demo

  6. 停止容器但保留数据卷:docker stop pg-demo

环境变量名称必须由具体镜像文档定义,不能把任意变量加到任意镜像上。端口发布也要注意监听范围:Docker 官方文档说明,省略主机 IP 的 -p 5432:5432通常会发布到所有主机网络接口;只做本机访问时,使用 -p 127.0.0.1:5432:5432更容易控制访问范围。端口发布的具体行为可参考Publishing and exposing ports。

镜像来源、安全和多架构怎么核验

  1. 核对发布者:打开 Docker Hub 仓库,确认 Official Image、Verified Publisher 或项目维护者信息,并阅读 Dockerfile 和使用说明。

  2. 核对平台:执行 docker buildx imagetools inspect nginx:stable,查看 Registry 中的摘要和平台清单。该命令可以帮助确认是否存在 linux/amd64、linux/arm64等目标平台;也可以使用官方文档中的 docker manifest inspect --verbose 镜像:标签。

  3. 固定摘要:确认实际 digest 后,使用类似 docker pull nginx@sha256:摘要值的引用。不要手写或猜测摘要值。

  4. 查看软件包和漏洞:docker scout sbom nginx:stable可用于查看软件包清单,docker scout cves nginx:stable可用于分析漏洞。Docker Scout CLI 插件预装于 Docker Desktop;只使用 Docker Engine 时,可能需要单独安装插件。

  5. 确认登录状态:Docker Scout 官方快速入门要求先登录 Docker 账号;本地分析、远程仓库分析和组织级功能的前置条件可能不同,不能把命令能执行等同于所有功能都已启用。

相关命令分别见imagetools inspect、docker manifest、Docker Scout quickstart和Docker Scout 安装文档。扫描结果会随镜像内容和漏洞数据库变化,不能把一次结果当作永久安全证明。

Docker Content Trust 正在退役,Docker 官方文档写明 Notary v1 服务计划于 2026 年 12 月 8 日关闭;如需签名和来源证明,应按具体发布方文档核对 Sigstore、Notation 或其他替代机制,而不要新建依赖旧 DCT 流程的部署方案。来源见Content trust in Docker。

Docker 镜像拉取失败:按报错文本排查

常见 pull 报错、原因与处理命令
报错或现象优先判断处理方法
manifest unknown仓库或标签不存在打开仓库页核对 Supported tags,再执行 docker pull 仓库:标签
no matching manifest for linux/arm64镜像没有当前平台清单执行 docker buildx imagetools inspect 镜像:标签,确认平台;必要时再评估 --platform
toomanyrequests 或 HTTP 429Docker Hub 拉取限流先执行 docker login,CI 使用认证凭据或企业镜像缓存,并减少重复拉取
i/o timeoutDocker daemon 到 Registry 的连接、DNS 或代理异常先检查 Docker daemon 代理和 DNS,再降低并发下载或更换可用的 Registry 路径
unauthorized: authentication required私有仓库或权限不足执行 docker login registry.example.com,确认账号有目标仓库读取权限
磁盘空间不足镜像层、容器、卷或构建缓存占满空间执行 docker system df,确认对象无用后再清理

Docker 官方的Docker Hub pull usage and limits说明,Docker Hub 会对未认证用户和部分个人账号进行按时间窗口计算的拉取限制,超过限制时可能返回 HTTP 429。具体限制会随账号类型和官方政策变化,遇到 toomanyrequests时,应优先登录、减少重复拉取或配置缓存,不要把错误误判为镜像标签不存在。

Docker daemon 默认会同时下载多个镜像层。docker image pull 文档说明,低带宽连接可能因此出现超时,可按 daemon 文档调整 --max-concurrent-downloads;当前默认值和配置方式见dockerd 参考。

Windows 主机可以执行 curl.exe -I https://registry-1.docker.io/v2/检查 HTTPS 是否能建立。对公开 Registry,返回 401 Unauthorized通常表示 Registry 已响应并要求认证,不一定代表网络失败。但主机上的 curl 只代表主机网络路径,不能完全代表 Docker Desktop 虚拟机或 Docker daemon 的网络路径,因此还要结合 Docker 日志和实际 docker pull结果判断。

Docker Hub、Registry 镜像、CI/CD 和多架构设备怎么安排

不同获取方式的使用边界
方式适合场景边界与注意事项
直接从 Docker Hub 拉取个人开发、公开镜像和小规模测试需要考虑认证、限流、网络路径和标签变化
企业私有 Registry内部镜像、权限控制和生产发布需要配置登录、证书、命名空间和访问策略
Registry mirror 或 pull-through cache多台 Docker 主机重复拉取 Docker Hub 镜像官方文档说明中心 Docker Hub 可被镜像,其他私有 Registry 不能按同样方式直接镜像
CI/CD 缓存减少重复下载和构建时间使用认证拉取、固定 digest,并记录缓存来源和失效策略
多架构镜像清单amd64、arm64 等设备共用同一镜像引用先用 imagetools inspect 检查平台,不要假定同一标签支持所有设备

Docker 官方的Mirror the Docker Hub library文档明确说明,镜像配置主要针对 Docker Hub 的中心仓库;如果使用企业内部 Registry,应按其认证、证书和缓存策略配置。对于 CI/CD,最稳妥的做法是把镜像引用、digest、登录方式和缓存策略写入构建配置,避免构建节点因匿名拉取或标签漂移产生不一致。

如果启用了 containerd image store,镜像列表和经典存储后端的可见对象可能不同。Docker 官方文档说明,切换镜像存储后,非当前存储后端中的镜像和容器可能暂时不可见,因此排查“镜像突然消失”时,先确认当前 Docker Desktop 或 Engine 使用的存储后端。

命令速查:查找、拉取、运行和推送

  • 搜索:docker search nginx

  • 拉取:docker pull nginx:stable

  • 查看镜像:docker image ls

  • 查看摘要:docker image ls --digests

  • 查看中间层和 dangling 镜像:docker image ls -a

  • 查看远程平台:docker buildx imagetools inspect nginx:stable

  • 本机运行 Web 服务:docker run --name web-demo -d -p 127.0.0.1:8080:80 nginx:stable

  • 登录 Registry:docker login registry.example.com

  • 重新标记:docker tag nginx:stable registry.example.com/team/nginx:stable

  • 推送镜像:docker push registry.example.com/team/nginx:stable

  • 查看本地空间:docker system df

Docker 官方 docker image ls文档说明,默认视图显示顶层镜像;中间层和 dangling 镜像默认隐藏,使用 -a可以显示它们。在启用不同镜像存储后端时,可见对象可能不同,因此不要只凭一条命令判断所有本地镜像都已丢失。

核验边界与更新时间

本文只对已检索到的 Docker 官方文档和官方镜像页面作确定性说明;镜像标签、支持架构、漏洞结果、Registry 限制和客户端界面都可能变化。标签和平台请在实际拉取前重新核对,命令中的摘要值必须来自真实 Registry 或构建记录。

本页资料核验日期:2026-11-19。来源包括 Docker Docs 和 Docker Hub 官方镜像页面。

常见问题

Docker pull 不写标签时会拉取什么?

不写标签时通常使用 latest,但 latest 只是标签名称,不保证是最新、最稳定或最适合生产。正式部署前应查看仓库当前的 Supported tags,并优先记录固定标签或 digest。

Docker 镜像拉取出现 429 toomanyrequests 怎么办?

这通常与 Docker Hub 的拉取限制有关。先执行 docker login,确认 CI 使用认证凭据;如果多个构建节点重复拉取,可以配置企业镜像缓存或 pull-through cache,并减少无必要的重复拉取。具体限制以 Docker Hub 当前政策为准。

为什么出现 no matching manifest for linux/arm64?

这表示当前标签的 Registry 清单中可能没有匹配 linux/arm64 的镜像。先执行 docker buildx imagetools inspect 镜像:标签查看平台,再选择支持当前设备的标签,或评估是否需要跨架构运行。

curl.exe 访问 Registry 返回 401 是不是网络失败?

对于公开 Registry,401 Unauthorized 通常表示 HTTPS 请求已经到达 Registry,但服务要求认证,因此不一定是网络失败。主机 curl 只测试主机网络路径,Docker Desktop 虚拟机或 Docker daemon 仍可能有独立的 DNS、代理或网络问题。

alpine 一定比 slim 更好吗?

不一定。alpine 可能更精简,但使用 musl libc,部分依赖和预编译包可能存在兼容差异。slim 也可能缺少编译工具。应根据应用依赖、构建方式和运行时要求测试后选择。

Docker Scout 命令不能执行怎么办?

先确认 Docker Scout CLI 插件是否已安装。Docker Desktop 通常预装该插件;只使用 Docker Engine 时可能需要单独安装。分析功能还可能要求登录 Docker 账号,远程仓库分析则需要按官方文档启用相应仓库设置。

docker image ls -a 为什么没有显示我以为存在的镜像?

docker image ls -a 会显示中间层和 dangling 镜像,但切换到不同镜像存储后端时,另一后端中的镜像和容器可能暂时不可见。先确认当前 Docker Desktop 或 Engine 使用的是哪个镜像存储后端,再检查 docker system df 和容器列表。

相关阅读

参考资料

  1. What is an image? | Docker Docs
  2. Docker Hub quickstart | Docker Docs
  3. Trusted content | Docker Docs
  4. Base images | Docker Docs
  5. nginx - Official Image | Docker Hub
  6. node - Official Image | Docker Hub
  7. Publishing and exposing ports | Docker Docs
  8. docker buildx imagetools inspect | Docker Docs
  9. docker manifest | Docker Docs
  10. Docker Scout quickstart | Docker Docs
  11. Install Docker Scout | Docker Docs
  12. Content trust in Docker | Docker Docs