关于
搭建个人 Docker Registry 代理与客户端配置指南

好的,我帮你整理一篇完整文章,内容涵盖从服务器部署、代理配置、缓存管理,到客户端配置和应用示例的全流程,并尽量详细、条理清晰,便于存档在你的知识库。


搭建个人 Docker Registry 代理与客户端配置指南

适用场景:国内网络环境,官方 Docker Hub 镜像受限,想通过国外服务器自建代理 Registry 或做临时缓存。


1️⃣ 服务端部署

1.1 创建数据目录

选择服务器上一个适合存放 Registry 数据的目录(如 /opt/registry/data),并创建:

sudo mkdir -p /opt/registry/data

1.2 启动 Docker Registry 容器

使用官方 registry:2 镜像,搭建一个代理模式的 Registry:

sudo docker run -d \
  -p 5000:5000 \
  --restart=always \
  --name registry \
  -v /opt/registry/data:/var/lib/registry \
  -e REGISTRY_PROXY_REMOTEURL=https://registry-1.docker.io \
  registry:2

说明:

  • -p 5000:5000:容器端口 5000 映射到宿主机。
  • REGISTRY_PROXY_REMOTEURL:开启代理模式,将请求转发到 Docker Hub。
  • --restart=always:服务器重启自动启动。

💡 如果你不希望缓存,可在客户端 pull 之后直接清理 /opt/registry/data,或者直接忽略缓存(详见清理策略)。