Docker Registry 代理服务完整指南

1. 项目介绍

本项目实现了一个基于 Cloudflare Workers 的 Docker Registry 代理服务，可以用来加速 Docker 镜像的下载、提供访问控制等功能。通过部署这个服务，你可以：

加速 Docker 镜像下载
控制镜像访问权限
监控镜像使用情况
优化带宽使用

2. 功能特性

2.1 核心功能

Docker Registry API v2 支持
智能请求转发
响应内容处理
缓存支持

2.2 安全特性

IP 白名单/黑名单
地区访问控制
User Agent 过滤
请求路径控制

2.3 性能特性

响应缓存
超时控制
错误重试
流量优化

2.4 监控功能

详细日志记录
性能指标收集
异常监控
访问统计

3. 代码实现

3.1 完整代码

// 错误处理类
class ProxyError extends Error {
  constructor(message, statusCode, errorType) {
    super(message);
    this.name = 'ProxyError';
    this.statusCode = statusCode;
    this.errorType = errorType;
  }
}

// 指标收集类
class Metrics {
  constructor() {
    this.requests = 0;
    this.errors = 0;
    this.bytesTransferred = 0;
    this.requestTimings = new Map();
  }

  // ... metrics 相关方法 ...
}

// 主要代码实现
export default {
  async fetch(request, env, ctx) {
    // ... fetch 处理逻辑 ...
  }
};

// 完整代码见[Docker Registry Proxy](https://github.com/YYvanYang/docker-registry-proxy)

3.2 核心组件说明

错误处理

自定义错误类
详细错误信息
错误类型分类

指标收集

请求计数
错误统计
性能监控

请求处理

请求转发
头部处理
响应修改

4. 部署步骤

4.1 准备工作

域名准备

# 确保有可用域名
# 将域名添加到 Cloudflare

安装必要工具

# 安装 Wrangler CLI
npm install -g wrangler

# 登录 Cloudflare
wrangler login

4.2 项目设置

mkdir docker-registry-proxy
cd docker-registry-proxy

初始化项目

wrangler init

配置 wrangler.toml

name = "docker-registry-proxy"
main = "src/index.js"
compatibility_date = "2024-01-01"

[vars]
PROXY_HOSTNAME = "registry-1.docker.io"
PROXY_PROTOCOL = "https"
DEBUG = false
REQUEST_TIMEOUT = 30000

4.3 域名配置

DNS 设置

添加域名到 Cloudflare
配置 DNS 记录
等待 DNS 生效

4.4 部署服务

部署代码

wrangler deploy

验证部署

# 测试基本功能
curl -v https://your-domain.com/v2/

# 测试镜像拉取
docker pull your-domain.com/library/hello-world:latest

5. 配置说明

5.1 基础配置

[vars]
# 基本设置
PROXY_HOSTNAME = "registry-1.docker.io"
PROXY_PROTOCOL = "https"
DEBUG = false
REQUEST_TIMEOUT = 30000

# 访问控制
PATHNAME_REGEX = "^/v2/"
UA_WHITELIST_REGEX = ""
IP_WHITELIST_REGEX = ""
REGION_WHITELIST_REGEX = ""

5.2 安全配置

[vars]
# 黑名单设置
UA_BLACKLIST_REGEX = ""
IP_BLACKLIST_REGEX = ""
REGION_BLACKLIST_REGEX = ""

# 重定向设置
URL302 = ""

6. 使用指南

6.1 配置 Docker 客户端

编辑 Docker 配置

sudo vi /etc/docker/daemon.json

添加镜像加速配置

{
  "registry-mirrors": ["https://your-domain.com"]
}

重启 Docker

sudo systemctl restart docker

6.2 使用示例

# 拉取镜像
docker pull nginx

# 推送镜像
docker push your-domain.com/your-org/your-image:tag

# 登录
docker login your-domain.com

7. 监控和维护

7.1 日志查看

# 查看 Workers 日志
wrangler tail

7.2 性能监控

查看请求统计
监控错误率
检查响应时间

7.3 定期维护

检查配置更新
清理过期数据
更新安全规则

8. 常见问题

8.1 部署问题

404 错误

检查域名配置
验证 Workers 路由
确认代码部署状态

SSL 证书问题

确认 SSL/TLS 设置
检查证书状态
验证 HTTPS 配置

8.2 使用问题

认证错误

确认登录信息
检查认证配置
验证权限设置

性能问题

检查超时设置
优化缓存配置
监控网络状态

8.3 维护建议

定期检查

查看错误日志
监控性能指标
更新安全规则

优化建议

调整缓存策略
优化访问控制
更新配置参数

结语

这个 Docker Registry 代理服务提供了一个可靠、安全且高性能的解决方案。通过合理的配置和维护，可以显著提升 Docker 镜像的访问速度和可靠性。建议根据实际需求调整配置参数，并定期检查监控指标以确保服务的稳定运行。

参考资料