cf-workers-docker.io

该介绍目前仅提供英文版本。

cf-workers-docker.io is a Docker registry proxy tool built on Cloudflare Workers. It serves as an intermediary for Docker Hub requests, helping to bypass access restrictions and accelerate Docker image downloads.

Key Features

• Easy Deployment: Can be deployed via Cloudflare Workers or Pages
• Simple Configuration: Minimal setup required
• Multiple Usage Methods: Supports both direct pull and registry mirror configuration
• Broad Compatibility: Works with various container runtimes (Docker, Containerd, Podman)

Deployment Methods

1. Workers Deployment:

   • Copy the _worker.js code
   • Save and deploy to Cloudflare Workers

2. Pages Deployment:

   • Fork the repository
   • Connect to GitHub for one-click deployment

Usage Guide

1. Direct Pull Method

Add your Workers domain before the official image path:

docker pull your-worker-domain/library/nginx:stable-alpine3.19-perl

2. Docker Registry Mirror Configuration

Edit /etc/docker/daemon.json:

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

3. Container Runtime Configuration

Containerd Configuration

Edit /etc/containerd/config.toml:

[plugins."io.containerd.grpc.v1.cri".registry]
  [plugins."io.containerd.grpc.v1.cri".registry.mirrors]
    [plugins."io.containerd.grpc.v1.cri".registry.mirrors."docker.io"]
      endpoint = ["https://your-worker-domain"]

Podman Configuration

Edit /etc/containers/registries.conf:

[[registry]]
prefix = "docker.io"
insecure = true
location = "registry-1.docker.io"

[[registry.mirror]]
location = "your-worker-domain"

Important Notes

1. Security Warning:

   • Using this service may violate Cloudflare’s terms of service
   • There’s a potential risk of account suspension
   • Use at your own discretion

2. Configuration Variables:

   • URL302: Optional redirect URL for homepage
   • URL: Optional homepage disguise
   • UA: Optional user agent configuration