支持 Docker、K8s、Quay、Ghcr、Mcr、Elastic 等多种镜像仓库

一键部署 Docker 镜像加速服务

在魔法服务器中快速部署Docker镜像加速服务，搭配 Caddy2 + Cloudflare 自动配置 TLS。 为国内用户提供加速访问国外镜像仓库的解决方案。

立即开始 了解工作原理
$ chmod +x run.sh
$ ./run.sh \
  --domain your_domain.com \
  --reverse_proxy_server http://127.0.0.1 \
  --cf_token your_cloudflare_token

核心特性

简化 Docker 镜像加速部署流程，让容器化开发更加高效

一键部署

单个脚本完成所有配置，无需复杂的手动设置过程，大幅降低部署门槛。

自动 TLS 配置

集成 Caddy2 自动配置 HTTPS 证书，保障数据传输安全，无需手动申请证书。

多仓库支持

支持 Docker Hub、K8s、Quay、Ghcr、Mcr、Elastic 等多种镜像仓库加速。

显著加速

为国内用户提供快速的镜像下载体验，大幅缩短容器镜像拉取时间。

灵活配置

支持自定义配置目录、镜像仓库选择、代理参数等，满足不同使用场景需求。

安全验证

可选配置 htpasswd 验证，保护您的镜像代理服务不被未授权访问。

工作原理

通过简单的三个步骤，快速搭建属于你的 Docker 镜像加速服务

1

准备服务器

在魔法服务器上安装 Docker 和相关依赖工具

2

配置 Cloudflare

添加域名 DNS 记录，创建 API Token，配置 SSL/TLS

3

运行脚本

执行一键部署脚本，等待服务启动完成

部署示例

基础部署

$ chmod +x run.sh
$ ./run.sh \
  --domain your_domain.com \
  --reverse_proxy_server http://127.0.0.1 \
  --cf_token your_cloudflare_token

自定义镜像仓库

$ ./run.sh \
  --services hub,ui,caddy \
  --domain your_domain.com \
  --reverse_proxy_server http://127.0.0.1 \
  --cf_token your_cloudflare_token

高级配置

$ ./run.sh \
  --update_yml true \
  --proxy_ttl 168h \
  --health_enabled true \
  --health_interval 10s \
  --storage_upload_enabled true

常见问题

关于 DockerProxyOneKey 的常见疑问解答

这个项目解决了什么问题？

由于许多Docker镜像仓库位于国外，国内用户下载镜像时速度较慢。虽然有一些免费代理服务，但通常需要白名单审核，流程较为繁琐。本项目通过一键脚本在自己服务器上部署镜像加速服务，无需等待审核，即开即用。

需要什么样的服务器？

需要一台可以访问国外Docker镜像仓库的服务器（俗称"魔法服务器"），并已安装Docker。脚本会自动处理其他依赖的安装和配置。

如何获取 Cloudflare API Token？

登录 Cloudflare 后，访问 API Token 页面创建新令牌，选择 "Zone: DNS: Edit" 权限即可。同时需要在域名管理中配置DNS记录，将域名指向你的服务器IP地址。

支持哪些 Docker 镜像仓库？

支持多种主流镜像仓库，包括 Docker Hub、Kubernetes (K8s)、Quay、GitHub Container Registry (Ghcr)、Microsoft Container Registry (Mcr)、Elastic 等等。

如何配置安全验证？

如果需要htpasswd验证，可以创建 .cache/htpasswd 文件并配置用户密码。可以使用在线htpasswd生成器创建密码文件，脚本会自动加载验证配置。

准备开始加速您的 Docker 体验？

立即部署您的专属镜像加速服务，享受流畅的容器开发体验

查看 GitHub 仓库 阅读部署文档