首页/云/云与容器速查/镜像仓库与镜像地址命名
容器与 Docker106 条

镜像仓库与镜像地址命名

镜像地址是 [仓库地址/]命名空间/仓库名:标签(或 @摘要)三段结构:不带地址默认 Docker Hub,私有镜像必须写全地址,否则登录与推送全部对不上。

云与容器速查云更新于 2026-10-12
三段式[registry[:port]/]namespace/repository[:tag|@digest]
默认仓库docker.io;官方镜像位于 library/ 命名空间
Harbor 术语命名空间叫『项目』,权限按项目授予
摘要拉取image@sha256:… 内容寻址,完全可复现
本地查看docker image ls 的 REPOSITORY 列即地址前缀

推送流程

推送流程
docker tag myapp:1.2.3 registry.example.com/team/myapp:1.2.3
docker push registry.example.com/team/myapp:1.2.3
docker pull registry.example.com/team/myapp@sha256:<摘要>
镜像名 <仓库>/<项目>/<应用>:<版本> 便于权限控制:项目对应团队,最小权限即可覆盖。

易错点

  • 私有镜像没写仓库地址:docker push 到 Docker Hub,白推还可能泄露
  • 不同仓库同名镜像混用:本地 tag 覆盖后推送对象出错,发错版本

数据来源与参考

  • Docker Docs:Registry
  • Harbor 文档:镜像地址模型

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌