Apq/Docker-Proxy: 🔥 🔥 🔥 自建Docker镜像加速服务，基于官方Docker Registry 一键部署Docker、K8s、Quay、Ghcr、Mcr等镜像加速\管理服务。支持部署到Render\Koyeb @ 42f500317b2e091026f65a755bfc66dac69aeb2e

自建Docker镜像加速服务，基于官方 registry 一键部署Docker、K8s、Quay、Ghcr、Mcr、elastic、nvcr等镜像加速\管理服务.

[![Auth](https://img.shields.io/badge/Auth-dqzboy-ff69b4)](https://github.com/dqzboy) [![GitHub contributors](https://img.shields.io/github/contributors/dqzboy/Docker-Proxy)](https://github.com/dqzboy/Docker-Proxy/graphs/contributors) [![GitHub Issues](https://img.shields.io/github/issues/dqzboy/Docker-Proxy.svg)](https://github.com/dqzboy/Docker-Proxy/issues) [![GitHub Pull Requests](https://img.shields.io/github/stars/dqzboy/Docker-Proxy)](https://github.com/dqzboy/Docker-Proxy) [![HitCount](https://views.whatilearened.today/views/github/dqzboy/Docker-Proxy.svg)](https://github.com/dqzboy/Docker-Proxy) [![GitHub license](https://img.shields.io/github/license/dqzboy/Docker-Proxy)](https://github.com/dqzboy/Docker-Proxy/blob/main/LICENSE) 📢 Docker Proxy-TG交流群｜ Docker Proxy-QQ交流群

📝 准备工作

⚠️ 重要：选择一台国外服务器，并且未被墙。对于域名，无需进行国内备案。你也可以通过一些平台申请免费域名。在一键部署过程中，如果选择安装Caddy，它将自动配置HTTPS。若选择部署Nginx服务，则需要自行申请一个免费的SSL证书，或者通过其他方式来实现SSL加密。

高性价比海外 VP 推荐：点击查看

免费域名证书申请

**方式一：** [Acme.sh自动生成和续订Lets Encrypt免费SSL证书](https://www.dqzboy.com/16437.html) **方式二：** 域名托管到[Cloudflare 开启免费SSL证书](https://www.cloudflare.com/zh-cn/application-services/products/ssl/) **方式三：** 可通过第三方平台，申请免费的域名证书(免费一般都为DV证书)，适用于个人网站、博客和小型项目

如果你没有上面提到的环境，那么你也可以尝试以下的几种方案

**方案一：** 🚀 如果你身边没有上面提到的这些东西，那么你也可以部署到 **[Render](Render/README.md)** **方案二：** 如果你只有一台服务器，不想搞域名也不想配置TLS，那么你可以修改Docker的配置文件`daemon.json`，指定`insecure-registries` 为你的镜像加速地址 **方案三：** 如果你是在国内的服务器部署，那么你可以在执行一键部署时配置代理，同时会帮你解决国内无法安装Docker的问题 **方案四：** 试试这个项目，基于[Cloudflare Workers](https://github.com/dqzboy/Workers-Proxy-Docker)搭建Docker镜像代理服务

部署过程中出现的问题或者疑问，请点击这里问题总结，查看是否有你遇到的情况！尝试先自己解决。

📦 部署

通过项目脚本部署

# CentOS && RHEL && Rocky
yum -y install curl
# ubuntu && debian
apt -y install curl

# 国外环境
bash -c "$(curl -fsSL https://raw.githubusercontent.com/dqzboy/Docker-Proxy/main/install/DockerProxy_Install.sh)"

# 国内环境
bash -c "$(curl -fsSL https://cdn.jsdelivr.net/gh/dqzboy/Docker-Proxy/install/DockerProxy_Install.sh)"

部署到第三方平台

部署到 Render

> Render 提供免费额度，绑卡后可以进一步提升额度使用Render快速部署: [点击查看教程](Render/README.md)

部署到 Koyeb

> Koyeb 分配的域名在国内地区访问不是很稳定，不是很推荐！使用Koyeb快速部署: [点击查看教程](Koyeb/README.md)

Docker Compose 部署

手动部署容器

**⚠️ 注意：** 你需要对哪个镜像仓库进行加速，就下载哪个配置。`docker-compose.yaml`文件默认是部署所有的国外镜像仓库的加速服务，同样也是你部署哪个就配置哪个，其余的删除掉即可！ **1.** 下载[config](https://github.com/dqzboy/Docker-Proxy/tree/main/config)目录下对应的`yml`文件到你本地机器上 **2.** 下载[docker-compose.yaml](https://github.com/dqzboy/Docker-Proxy/blob/main/docker-compose.yaml)文件到你本地机器上，并且与配置文件同级目录下 **3.** 执行 `docker compose` 或 `docker-compose` 命令启动容器服务 ```shell # 启动全部容器 docker compose up -d # 启动指定的容器,例如: Docker Hub Registry Proxy docker compose up -d dockerhub # 查看容器日志 docker logs -f [容器ID或名称] ``` **4.** 如果你对Nginx或Caddy不熟悉,那么你可以使用你熟悉的服务进行代理。也可以直接通过IP+端口的方式访问

🔨 功能

一键部署Docker镜像代理服务的功能，支持基于官方Docker Registry的镜像代理.
支持多个镜像仓库的代理，包括Docker Hub、GitHub Container Registry(ghcr.io)、Quay Container Registry(quay.io)、Kubernetes Container Registry(k8s.gcr.io)、Microsoft Container(mcr.microsoft.com)、Elastic Stack(docker.elastic.co)
自动检查并安装所需的依赖软件，如Docker\Compose、Nginx\Caddy等，并确保系统环境满足运行要求
根据你所选择部署的WEB反代服务，自动渲染对应的Nginx或Caddy服务配置
自动清理注册表上传目录中的那些不再被任何镜像或清单引用的文件
支持自定义配置代理缓存时间(PROXY_TTL)、支持配置IP黑白名单，防止恶意攻击行为
提供了服务管理、配置管理、服务卸载、认证授权等功能，方便用户进行日常管理和维护
支持一键配置本机Docker代理和容器服务代理(HTTP_PROXY)，仅支持http
支持国内服务器一键部署，解决国内环境无法安装Docker\Compose服务难题
支持主流Linux发行版操作系统,例如Centos、Ubuntu、Rocky、Debian、Rhel等
支持主流ARCH架构下部署，包括linux/amd64、linux/arm64
针对本项目开发Docker Registry管理面板，实现镜像搜索、广告展示、文档教程、容器管理、容器监控告警、网络测试等功能

✨ 教程

配置Nginx反向代理

注意：如果你选择部署的是Nginx，那么代理程序部署完成之后，需自行配置 Nginx

1.下载仓库下的nginx配置文件 registry-proxy.conf 到你的nginx服务下，并修改配置里的域名和证书部分
2.在你的DNS服务提供商将相应的访问域名解析到部署docker proxy服务的机器IP上
3.修改Docker的daemon.json配置，配置你自建的Registry地址。修改后重启docker

~]# vim /etc/docker/daemon.json
{
    "registry-mirrors": [ "https://hub.your_domain_name" ]
}

说明： 配置了daemon.json之后，现在拉取镜像无需指定你的加速地址，直接执行docker pull拉取你需要的镜像即可。下面的步骤是你在没有配置daemon.json的时候，拉取镜像需要加上你的加速地址才可以正常拉取。

1. 使用自建的 Registry 地址替换官方的 Registry 地址拉取镜像

# docker hub Registry
## 源：nginx:latest
## 替换
docker pull hub.your_domain_name/library/nginx:latest

# Google Registry
## 源：gcr.io/google-containers/pause:3.1
## 替换：
docker pull gcr.your_domain_name/google-containers/pause:3.1

2. 前缀替换的 Registry 的参考

源站	替换为	平台
docker.io	hub.your_domain_name	docker hub
gcr.io	gcr.your_domain_name	Google Container Registry
ghcr.io	ghcr.your_domain_name	GitHub Container Registry
k8s.gcr.io	k8s-gcr.your_domain_name	Kubernetes Container Registry
registry.k8s.io	k8s.your_domain_name	Kubernetes's container image registry
quay.io	quay.your_domain_name	Quay Container Registry
mcr.microsoft.com	mcr.your_domain_name	Microsoft Container Registry
docker.elastic.co	elastic.your_domain_name	Elastic Stack
nvcr.io	nvcr.your_domain_name	NVIDIA Container Registry

详细教程：
自建Docker镜像加速服务：加速与优化镜像管理
 自建Docker镜像加速，并把域名托管到CF加速镜像拉取

📚 展示

<tr>
  <td width="50%" align="center"><b>系统环境检查</b></td>
  <td width="50%" align="center"><b>服务部署安装</b></td>
</tr>
<tr>
    <td width="50%" align="center"><img src="https://github.com/dqzboy/Docker-Proxy/assets/42825450/55df7f6f-c788-4200-9bcd-631998dc53ef?raw=true"></td>
    <td width="50%" align="center"><img src="https://github.com/dqzboy/Docker-Proxy/assets/42825450/c544fb1e-ecd5-447c-9661-0c5913586118?raw=true"></td>
</tr>

💻 UI界面

HubCMD-UI 手动安装教程：点击查看教程

<tr>
  <td width="50%" align="center"><b>Docker Registry UI</b></td>
  <td width="50%" align="center"><b>Docker-Proxy CmdUI</b></td>
</tr>
<tr>
    <td width="50%" align="center"><img src="https://github.com/dqzboy/Docker-Proxy/assets/42825450/0ddb041b-64f6-4d93-b5bf-85ad3b53d0e0?raw=true"></td>
    <td width="50%" align="center"><img src="https://github.com/user-attachments/assets/c7e368ca-7f1a-4311-9a10-a5f4f06d86d8?raw=true"></td>
</tr>
<tr>
  <td width="50%" align="center"><b>Docker官方镜像搜索</b></td>
  <td width="50%" align="center"><b>Docker容器服务管理</b></td>
</tr>
<tr>
    <td width="50%" align="center"><img src="https://github.com/user-attachments/assets/8569c5c4-4ce6-4cd4-8547-fa9816019049?raw=true"></td>
    <td width="50%" align="center"><img src="https://github.com/user-attachments/assets/fb30f747-a2af-4fc8-b3cc-05c71a044da0?raw=true"></td>
</tr>