# docker-cloudflare

**Repository Path**: niehaoran/docker-cloudflare

## Basic Information

- **Project Name**: docker-cloudflare
- **Description**: 用于搭建docker镜像加速站
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 1
- **Created**: 2025-09-17
- **Last Updated**: 2026-08-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Docker 镜像代理加速服务

> 🚀 基于 Cloudflare Workers 的 Docker 镜像代理服务

## 📚 项目来源

本项目基于原仓库: [niehaoran/docker-cloudflare](https://github.com/niehaoran/docker-cloudflare)

## ✨ 功能特性

- 🐳 支持 Docker Hub、GHCR、GCR、Quay 等镜像仓库
- ⚡ 全球 CDN 加速，提升拉取速度
- 🔒 安全控制：IP 白名单、域名限制、频率控制
- 📊 可选镜像大小检查功能
- 🎨 友好的 Web 管理界面

## 🚀 快速开始

### 1. 一键部署到 Cloudflare Workers

#### 方式1：使用 Wrangler CLI（推荐）
```bash
# 克隆项目
git clone https://github.com/niehaoran/docker-cloudflare.git
cd docker-cloudflare

# 安装依赖
npm install

# 登录 Cloudflare
npx wrangler login

# 部署
npm run deploy
```

#### 方式2：手动部署
1. 登录 [Cloudflare Dashboard](https://dash.cloudflare.com/)
2. 创建新的 Worker
3. 复制 `worker.js` 代码并保存部署
4. 配置自定义域名

### 2. 使用方法

#### 网页界面
访问你的域名，输入镜像名即可生成代理命令

#### 命令行使用
```bash
# 官方镜像
docker pull your-domain.com/nginx
docker pull your-domain.com/mysql:8.0

# 第三方镜像
docker pull your-domain.com/ghcr.io/username/repo:tag
```

## 📋 支持的镜像仓库

| 仓库 | 示例 |
|------|------|
| Docker Hub | `your-domain.com/nginx` |
| GitHub | `your-domain.com/ghcr.io/actions/runner` |
| Google | `your-domain.com/gcr.io/distroless/java` |
| Quay | `your-domain.com/quay.io/prometheus/prometheus` |

## ⚙️ 配置选项

```javascript
// 允许的域名
const ALLOWED_HOSTS = ['registry-1.docker.io', 'ghcr.io', 'gcr.io', 'quay.io'];

// 镜像大小限制（MB，0=不限制）
const MAX_IMAGE_SIZE_MB = 2048;

// 访问控制
const ENABLE_ACCESS_CONTROL = true;
const ALLOWED_IP_RANGES = ['192.168.0.0/16', '10.0.0.0/8'];
```

## 🔧 API 接口

```bash
# 创建拉取会话
curl -X POST "https://your-domain.com/api/create-session" \
  -H "Content-Type: application/json" \
  -d '{"image": "nginx"}'

# 获取会话日志
curl "https://your-domain.com/api/logs/{session-id}"
```

## 💖 支持项目

如果这个项目对你有帮助，欢迎打赏支持！

<div align="center">
  <img src="images/weixin.png" alt="微信打赏" width="300"/>
  <br>
  <em>扫码打赏，支持开发</em>
</div>

## 👨‍💻 作者

**陈不丢**
- GitHub: [@niehaoran](https://github.com/niehaoran)
- 博客: [blog.budiuyun.net](https://blog.budiuyun.net)
- 我的容器云平台: [budiuyun.net](https://budiuyun.net)

## 🚀 推荐服务

### 🐳 不丢容器 - 专业Docker托管平台
> 💡 一站式容器化解决方案，让部署更简单！

**访问地址**: [budiuyun.net](https://budiuyun.net)

**核心功能**:
- 🚀 一键部署Docker应用
- 📊 实时监控与日志查看
### 📝 技术博客 - 开发者知识分享
> 💡 分享前沿技术、实战经验和开发心得

**访问地址**: [blog.budiuyun.net](https://blog.budiuyun.net)

## ⚠️ 免责声明

- 本程序仅供学习交流使用，请勿用于非法用途
- 使用本程序需遵守当地法律法规
- 作者不对使用者的任何行为承担责任

---

<div align="center">
**⭐ 如果这个项目对你有帮助，请给个 Star！⭐**
</div>