1. 为什么需要Cloudflare Workers加速服务作为开发者相信大家都遇到过GitHub加载缓慢、Docker镜像拉取超时的问题。特别是在某些网络环境下一个简单的docker pull操作可能要等待数分钟严重影响开发效率。这时候Cloudflare Workers就能派上大用场了。Cloudflare Workers本质上是一个全球分布的serverless执行环境它允许我们在全球200多个数据中心的边缘节点上运行JavaScript代码。这意味着我们可以把流量代理、内容改写等操作放在离用户最近的节点处理从而显著降低延迟。相比自建代理服务器Workers有三大优势零运维成本无需维护服务器全球加速自动选择最优节点免费额度每天10万次请求完全够个人使用我去年开始将团队的所有GitHub访问和Docker镜像拉取都通过Workers加速实测下载速度提升3-5倍。下面我就分享具体实现方法包含完整代码和避坑指南。2. 快速搭建GitHub加速服务2.1 创建基础Worker服务首先登录Cloudflare控制台进入Workers和Pages页面点击创建应用程序→创建Worker给Worker起个有意义的名字如github-proxy在代码编辑器中清空默认内容粘贴以下代码const upstream github.com const upstream_path / const blocked_region [] const blocked_ip_address [] addEventListener(fetch, event { event.respondWith(handleRequest(event.request)) }) async function handleRequest(request) { const url new URL(request.url) url.host upstream url.protocol https: // 处理请求头 let headers new Headers(request.headers) headers.set(Host, upstream) headers.delete(cf-connecting-ip) // 发起代理请求 const response await fetch(url.toString(), { method: request.method, headers: headers, body: request.body }) // 处理响应 let newHeaders new Headers(response.headers) newHeaders.set(access-control-allow-origin, *) return new Response(response.body, { status: response.status, headers: newHeaders }) }这段代码实现了最基本的GitHub反向代理功能。点击保存并部署后你会获得一个形如github-proxy.your-subdomain.workers.dev的访问地址。2.2 配置自定义域名和缓存策略Cloudflare默认分配的workers.dev域名在国内访问可能不稳定建议绑定自己的域名在Worker的设置→触发器中添加自定义域名如gh.yourdomain.com在域名DNS设置中添加CNAME记录指向workers.dev域名为了进一步提升速度我们可以添加缓存控制。修改代码中的handleRequest函数async function handleRequest(request) { const cacheKey new Request(request.url, request) const cache caches.default // 检查缓存 let response await cache.match(cacheKey) if (response) return response // 无缓存则请求源站 const url new URL(request.url) url.host upstream url.protocol https: response await fetch(url.toString(), { cf: { cacheTtl: 86400, // 缓存24小时 cacheEverything: true }, headers: { Host: upstream, User-Agent: request.headers.get(User-Agent) } }) // 存储响应到缓存 response new Response(response.body, response) response.headers.append(Cache-Control, public, max-age86400) event.waitUntil(cache.put(cacheKey, response.clone())) return response }这个优化使得静态资源会被缓存24小时重复访问时直接从边缘节点返回速度提升非常明显。3. Docker镜像加速实战3.1 部署Docker Registry代理对于Docker镜像加速我们需要更专业的Worker方案。推荐使用开源的cloudflare-docker-proxy项目git clone https://github.com/ciiiii/cloudflare-docker-proxy cd cloudflare-docker-proxy npm install npx wrangler publish发布成功后修改wrangler.toml配置自定义域名name docker-proxy route docker.yourdomain.com/*这个Worker支持代理以下仓库Docker Hub (registry-1.docker.io)gcr.ioquay.iok8s.gcr.io3.2 配置Docker客户端在/etc/docker/daemon.json中添加镜像加速配置{ registry-mirrors: [https://docker.yourdomain.com] }重启Docker服务后所有docker pull请求都会通过Cloudflare Workers中转sudo systemctl restart docker docker pull nginx # 测试加速效果3.3 Containerd/K8s环境配置对于使用containerd的Kubernetes集群需要修改/etc/containerd/config.toml[plugins.io.containerd.grpc.v1.cri.registry.mirrors] [plugins.io.containerd.grpc.v1.cri.registry.mirrors.docker.io] endpoint [https://docker.yourdomain.com] [plugins.io.containerd.grpc.v1.cri.registry.mirrors.gcr.io] endpoint [https://docker.yourdomain.com]如果是Rancher RKE2集群则配置/etc/rancher/rke2/registries.yamlmirrors: docker.io: endpoint: - https://docker.yourdomain.com gcr.io: endpoint: - https://docker.yourdomain.com4. 高级优化技巧4.1 智能路由选择通过判断用户地理位置可以自动选择最优的上游服务器。在Worker代码中添加const regions { CN: github.com.cn, US: github.com, EU: github.eu } async function handleRequest(request) { const country request.cf.country const upstream regions[country] || regions[US] // 其余代码不变... }4.2 流量监控与分析Cloudflare Workers集成了Analytics功能可以在控制台查看请求量统计错误率监控性能指标P95延迟等建议为不同服务创建单独的Worker这样能更清晰地分析各服务的流量模式。4.3 安全防护配置为防止滥用可以添加基础认证const BASIC_AUTH user:pass async function handleRequest(request) { const auth request.headers.get(Authorization) if (auth ! Basic ${btoa(BASIC_AUTH)}) { return new Response(Unauthorized, { status: 401 }) } // 其余代码不变... }也可以基于IP地址限制访问const ALLOW_IPS [192.168.1.0/24] async function handleRequest(request) { const ip request.headers.get(cf-connecting-ip) if (!ALLOW_IPS.some(net isIpInRange(ip, net))) { return new Response(Forbidden, { status: 403 }) } // 其余代码不变... }5. 常见问题排查在实际使用中可能会遇到以下问题问题1GitHub页面样式错乱这是因为部分CSS/JS资源仍从原始域名加载。解决方法是在Worker代码中添加URL重写规则const REWRITES { https://github.com/: /, //github.com/: //gh.yourdomain.com/ } async function rewriteContent(response) { let text await response.text() for (const [from, to] of Object.entries(REWRITES)) { text text.replace(new RegExp(escapeRegExp(from), g), to) } return new Response(text, response) }问题2Docker pull返回404错误通常是因为镜像路径解析错误。检查Worker日志确认实际请求的URL是否符合预期。可以临时开启调试日志console.log(Proxying request to:, url.toString())问题3Containerd镜像拉取失败检查/etc/containerd/certs.d目录下的hosts.toml配置是否正确。特别注意证书配置[host.https://docker.yourdomain.com] capabilities [pull, resolve] skip_verify true # 如果是自签名证书需要开启我在生产环境运行这些方案已有半年多整体稳定性非常好。特别是在CI/CD流水线中构建时间平均缩短了40%。最关键的是所有服务都运行在免费额度内真正实现了零成本加速。如果遇到任何问题欢迎参考GitHub上的完整示例代码库。
Cloudflare Workers 实战：从 GitHub 加速到 Docker 镜像优化
1. 为什么需要Cloudflare Workers加速服务作为开发者相信大家都遇到过GitHub加载缓慢、Docker镜像拉取超时的问题。特别是在某些网络环境下一个简单的docker pull操作可能要等待数分钟严重影响开发效率。这时候Cloudflare Workers就能派上大用场了。Cloudflare Workers本质上是一个全球分布的serverless执行环境它允许我们在全球200多个数据中心的边缘节点上运行JavaScript代码。这意味着我们可以把流量代理、内容改写等操作放在离用户最近的节点处理从而显著降低延迟。相比自建代理服务器Workers有三大优势零运维成本无需维护服务器全球加速自动选择最优节点免费额度每天10万次请求完全够个人使用我去年开始将团队的所有GitHub访问和Docker镜像拉取都通过Workers加速实测下载速度提升3-5倍。下面我就分享具体实现方法包含完整代码和避坑指南。2. 快速搭建GitHub加速服务2.1 创建基础Worker服务首先登录Cloudflare控制台进入Workers和Pages页面点击创建应用程序→创建Worker给Worker起个有意义的名字如github-proxy在代码编辑器中清空默认内容粘贴以下代码const upstream github.com const upstream_path / const blocked_region [] const blocked_ip_address [] addEventListener(fetch, event { event.respondWith(handleRequest(event.request)) }) async function handleRequest(request) { const url new URL(request.url) url.host upstream url.protocol https: // 处理请求头 let headers new Headers(request.headers) headers.set(Host, upstream) headers.delete(cf-connecting-ip) // 发起代理请求 const response await fetch(url.toString(), { method: request.method, headers: headers, body: request.body }) // 处理响应 let newHeaders new Headers(response.headers) newHeaders.set(access-control-allow-origin, *) return new Response(response.body, { status: response.status, headers: newHeaders }) }这段代码实现了最基本的GitHub反向代理功能。点击保存并部署后你会获得一个形如github-proxy.your-subdomain.workers.dev的访问地址。2.2 配置自定义域名和缓存策略Cloudflare默认分配的workers.dev域名在国内访问可能不稳定建议绑定自己的域名在Worker的设置→触发器中添加自定义域名如gh.yourdomain.com在域名DNS设置中添加CNAME记录指向workers.dev域名为了进一步提升速度我们可以添加缓存控制。修改代码中的handleRequest函数async function handleRequest(request) { const cacheKey new Request(request.url, request) const cache caches.default // 检查缓存 let response await cache.match(cacheKey) if (response) return response // 无缓存则请求源站 const url new URL(request.url) url.host upstream url.protocol https: response await fetch(url.toString(), { cf: { cacheTtl: 86400, // 缓存24小时 cacheEverything: true }, headers: { Host: upstream, User-Agent: request.headers.get(User-Agent) } }) // 存储响应到缓存 response new Response(response.body, response) response.headers.append(Cache-Control, public, max-age86400) event.waitUntil(cache.put(cacheKey, response.clone())) return response }这个优化使得静态资源会被缓存24小时重复访问时直接从边缘节点返回速度提升非常明显。3. Docker镜像加速实战3.1 部署Docker Registry代理对于Docker镜像加速我们需要更专业的Worker方案。推荐使用开源的cloudflare-docker-proxy项目git clone https://github.com/ciiiii/cloudflare-docker-proxy cd cloudflare-docker-proxy npm install npx wrangler publish发布成功后修改wrangler.toml配置自定义域名name docker-proxy route docker.yourdomain.com/*这个Worker支持代理以下仓库Docker Hub (registry-1.docker.io)gcr.ioquay.iok8s.gcr.io3.2 配置Docker客户端在/etc/docker/daemon.json中添加镜像加速配置{ registry-mirrors: [https://docker.yourdomain.com] }重启Docker服务后所有docker pull请求都会通过Cloudflare Workers中转sudo systemctl restart docker docker pull nginx # 测试加速效果3.3 Containerd/K8s环境配置对于使用containerd的Kubernetes集群需要修改/etc/containerd/config.toml[plugins.io.containerd.grpc.v1.cri.registry.mirrors] [plugins.io.containerd.grpc.v1.cri.registry.mirrors.docker.io] endpoint [https://docker.yourdomain.com] [plugins.io.containerd.grpc.v1.cri.registry.mirrors.gcr.io] endpoint [https://docker.yourdomain.com]如果是Rancher RKE2集群则配置/etc/rancher/rke2/registries.yamlmirrors: docker.io: endpoint: - https://docker.yourdomain.com gcr.io: endpoint: - https://docker.yourdomain.com4. 高级优化技巧4.1 智能路由选择通过判断用户地理位置可以自动选择最优的上游服务器。在Worker代码中添加const regions { CN: github.com.cn, US: github.com, EU: github.eu } async function handleRequest(request) { const country request.cf.country const upstream regions[country] || regions[US] // 其余代码不变... }4.2 流量监控与分析Cloudflare Workers集成了Analytics功能可以在控制台查看请求量统计错误率监控性能指标P95延迟等建议为不同服务创建单独的Worker这样能更清晰地分析各服务的流量模式。4.3 安全防护配置为防止滥用可以添加基础认证const BASIC_AUTH user:pass async function handleRequest(request) { const auth request.headers.get(Authorization) if (auth ! Basic ${btoa(BASIC_AUTH)}) { return new Response(Unauthorized, { status: 401 }) } // 其余代码不变... }也可以基于IP地址限制访问const ALLOW_IPS [192.168.1.0/24] async function handleRequest(request) { const ip request.headers.get(cf-connecting-ip) if (!ALLOW_IPS.some(net isIpInRange(ip, net))) { return new Response(Forbidden, { status: 403 }) } // 其余代码不变... }5. 常见问题排查在实际使用中可能会遇到以下问题问题1GitHub页面样式错乱这是因为部分CSS/JS资源仍从原始域名加载。解决方法是在Worker代码中添加URL重写规则const REWRITES { https://github.com/: /, //github.com/: //gh.yourdomain.com/ } async function rewriteContent(response) { let text await response.text() for (const [from, to] of Object.entries(REWRITES)) { text text.replace(new RegExp(escapeRegExp(from), g), to) } return new Response(text, response) }问题2Docker pull返回404错误通常是因为镜像路径解析错误。检查Worker日志确认实际请求的URL是否符合预期。可以临时开启调试日志console.log(Proxying request to:, url.toString())问题3Containerd镜像拉取失败检查/etc/containerd/certs.d目录下的hosts.toml配置是否正确。特别注意证书配置[host.https://docker.yourdomain.com] capabilities [pull, resolve] skip_verify true # 如果是自签名证书需要开启我在生产环境运行这些方案已有半年多整体稳定性非常好。特别是在CI/CD流水线中构建时间平均缩短了40%。最关键的是所有服务都运行在免费额度内真正实现了零成本加速。如果遇到任何问题欢迎参考GitHub上的完整示例代码库。
