首页/云/Docker 容器速查/用 registry:2 搭建私有镜像仓库
本包目录(366 条)
基础命令50 条
镜像与构建107 条
网络与存储52 条Compose 编排55 条资源与安全50 条容器排障52 条

用 registry:2 搭建私有镜像仓库

用官方 registry 镜像在服务器上运行轻量私有仓库:打标签、推送、验证目录接口,适合内网镜像分发与缓存。

Docker 容器速查云更新于 2026-10-12
用途自建私有镜像仓库
镜像registry:2
端口5000(容器内服务端口)

示例

示例
docker run -d -p 5000:5000 --name registry -v registry-data:/var/lib/registry registry:2
docker tag app/web:1.0 127.0.0.1:5000/app/web:1.0
docker push 127.0.0.1:5000/app/web:1.0
curl -s http://127.0.0.1:5000/v2/_catalog
仓库数据默认放在容器内 /var/lib/registry,生产使用应挂载卷持久化,并规划 TLS 与访问认证。

易错点

  • 官方 registry 镜像默认无认证无加密,直接暴露公网等于公开镜像库,仅限内网或本机验证
  • 从其他主机用 HTTP 访问该仓库需在客户端配置 insecure-registries,否则报 HTTPS 握手失败

数据来源与参考

  • Docker 官方文档:registry 镜像与 Distribution 项目(docs.docker.com/registry)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌