当前位置：首页 > news >正文

配置镜像仓库镜像（Registry Mirror）的指南

news 2025/11/3 8:25:53

https://docs.docker.com/registry/recipes/mirror/

您提供的链接是 Docker 官方文档中关于配置镜像仓库镜像（Registry Mirror）的指南，主要用于优化 Docker 镜像拉取性能，尤其是在企业或内网环境中减少对公共 Docker Hub 的依赖。以下是关键内容总结和实用配置建议：

定义
Registry Mirror 是一个本地缓存代理，当 Docker 守护进程（Daemon）请求镜像时，优先从镜像仓库检查并返回缓存的镜像，若未命中则从上游仓库（如 Docker Hub）拉取并缓存。
典型场景
- 减少带宽消耗：多台主机重复拉取相同镜像时，仅需从上游拉取一次。
- 提升拉取速度：内网环境通过本地镜像仓库加速访问。
- 规避访问限制：绕过对 Docker Hub 的直接访问限制（需配合 Registry Access Management）。

使用官方 registry 镜像启动一个带缓存功能的镜像仓库：

docker run -d \-p 5000:5000 \--restart always \--name registry-mirror \-e REGISTRY_PROXY_REMOTEURL=https://registry-1.docker.io \  # 上游仓库地址registry:2

修改 /etc/docker/daemon.json（Linux）或 Docker Desktop 设置（Windows/macOS）：

{"registry-mirrors": ["http://<镜像仓库IP>:5000"]  # 替换为实际IP和端口
}

重启 Docker 服务生效：

sudo systemctl restart docker

拉取一个测试镜像（如 alpine），检查镜像仓库日志：

docker pull alpine
docker logs registry-mirror | grep "alpine"  # 应看到缓存命中或拉取日志

若需缓存私有镜像，需在镜像仓库配置中添加认证信息：

# /etc/docker/registry/config.yml
proxy:remoteurl: https://registry-1.docker.iousername: <你的DockerHub用户名>password: <你的DockerHub密码或Token>

⚠️ 安全警告：

镜像仓库默认会定期清理未使用的缓存（基于 LRU 算法）。可通过配置调整：

# /etc/docker/registry/config.yml
storage:cache:blobdescriptor: inmemorydelete:enabled: true  # 必须启用删除功能才能清理缓存

架构示例：

边缘节点 → 本地镜像仓库 → 上游镜像仓库（Docker Hub）

检查项：
1. 确认 daemon.json 中的 registry-mirrors 地址正确且可访问。
2. 检查镜像仓库日志是否有错误（如认证失败、网络不通）。
3. 使用 docker info | grep Registry 查看当前生效的镜像仓库列表。

临时绕过镜像仓库：
在拉取命令中显式指定上游仓库：
```
docker pull registry-1.docker.io/library/alpine:latest
```
重启镜像仓库服务：
```
docker restart registry-mirror
```

解决方案：

手动清理旧缓存：

# 进入镜像仓库容器
docker exec -it registry-mirror sh
# 删除特定镜像缓存（需知道blob ID）
rm /var/lib/registry/docker/registry/v2/blobs/<digest>/data