Cloudflare-ProxyX

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

Cloudflare-ProxyX

★ 19 Open GitHub ↗

基于 Cloudflare Workers 的 GitHub 和 Docker 加速服务，自动生成加速链接与命令。

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Cloudflare-ProxyX (Ultimate Edition)

基于 Cloudflare Workers 的全能下载代理与 Docker 镜像加速服务。

这是一个集成了 **Docker 镜像智能加速**、**通用文件/网页代理**、**大文件流式处理** 以及 **安全防护** 于一体的终极解决方案。它解决了 Docker 拉取 AWS S3/Cloudflare R2 资源时的 403 签名错误，支持断点续传，并提供了直观的 Web 管理界面。

## 🚀 核心特点

### 1. 🐳 Docker 镜像加速 (核心增强)
- **智能路由**: 自动识别 Docker 客户端请求（User-Agent 检测），**CLI 拉取无需密码**。
- **路径补全**: 自动为 Docker Hub 官方镜像补全 `library/` 前缀（如 `docker pull domain/nginx` 自动转换为 `library/nginx`）。
- **S3 签名修复**: 智能识别并修复 Docker Layer 在重定向到 AWS S3/R2 时的签名问题，彻底解决 `403 Forbidden` 错误。
- **递归处理**: 自动追踪多级 302/307 跳转，确保镜像拉取成功率。
- **多仓库支持**: 完美支持 `docker.io`, `ghcr.io`, `quay.io`, `k8s.gcr.io` 等主流仓库。

### 2. ⚡ 通用文件/网页代理
- **密码保护**: 普通文件下载或网页访问需通过 `/密码/` 路径验证，防止恶意盗用。
- **流式处理**: 支持无限大小的大文件流式传输，内存占用极低。
- **内容重写**:
    - 自动替换 `.sh/.py` 脚本中的 URL 为代理链接。
    - 自动重写网页 HTML 中的 `href`/`src` 链接。
- **防盗链伪装**: 自动修改 Referer/Origin/User-Agent，绕过目标网站限制。

### 3. 🛡️ 安全与隐私
- **隐身模式**: 访问根目录或错误密码返回 404，只有知道密码才能看到管理面板。
- **访问控制**: 支持 **IP 白名单** 和 **国家/地区限制**。
- **黑白名单**: 可配置目标域名的黑名单或白名单。
- **隐私保护**: 内置 `robots.txt` 禁止搜索引擎爬虫收录。

### 4. 🎨 现代化 UI
- **经典双栏设计**: 上方通用加速（带打开链接），下方 Docker 加速（带复制命令）。
- **配置生成器**: UI 底部一键生成 `daemon.json` 配置内容。
- **自动适配**: 支持深色/浅色模式切换。

---

## 🛠️ 部署方法

# docker部署
```
git clone https://github.com/Kevin-YST-Du/Cloudflare-ProxyX.git #git我的仓库
cd Cloudflare-ProxyX # 进入我的目录
docker compose up -d # 运行容器
docker-compose up -d # 运行容器（docker如果是低版本的运行这个命令）
```
---
# 一键脚本安装
```
git clone https://github.com/Kevin-YST-Du/Cloudflare-ProxyX.git #git我的仓库
cd Cloudflare-ProxyX # 进入我的目录
bash install.sh # 执行一键安装
```
---
# 二进制安装
```
git clone https://github.com/Kevin-YST-Du/Cloudflare-ProxyX.git #git我的仓库
cd Cloudflare-ProxyX # 进入我的目录
wget https://github.com/Kevin-YST-Du/Cloudflare-ProxyX/releases/download/v3.7.0/proxyx-linux-x64 #下载最新版本的二进制包
bash install-binary.sh
```
---
### 1. Cloudflare部署代码
#### 1. 登录 [Cloudflare Dashboard](https://dash.cloudflare.com/)。
#### 2. 进入 **Workers & Pages** -> **Create Application** -> **Create Worker**。
#### 3. 命名你的 Worker（例如 `docker-accel`），点击 **Deploy**。
#### 4. 点击 **Edit code**，将本项目提供的 `worker.js` 代码全选粘贴覆盖，**Save and Deploy**。

### 2. 配置环境变量 (推荐)
为了安全和灵活性，建议在 Cloudflare 后台设置配置，而不是修改代码。
进入 Worker 的 **Settings** -> **Variables**，添加以下变量：

| 变量名 | 说明 | 示例值 | 必填 |
| :--- | :--- | :--- | :--- |
| `PASSWORD` |  访问密码 (用于 Web 界面和普通代理) | `123456` | 推荐 |
| `MAX_REDIRECTS` | 最大重定向次数 (防止死循环) | `5` | 否 |
| `ENABLE_CACHE` | 是否开启 Cloudflare 缓存 (`true`/`false`) | `true` | 否 |
| `CACHE_TTL` | 缓存时间 (秒) | `3600` | 否 |
| `BLACKLIST` | 目标域名黑名单 (禁止代理访问的域名) | `baidu.com, qq.com` | 否 |
| `WHITELIST` | 目标域名白名单 (只允许代理访问的域名) | `github.com, raw.githubusercontent.com` | 否 |
| `ALLOW_IPS` | 允许访问的客户端 IP (逗号分隔，留空不限制) | `1.2.3.4, 223.5.5.5` | 否 |
| `ALLOW_COUNTRIES` | 允许访问的国家代码 (逗号分隔，留空不限制) | `CN, US, HK` | 否 |
| `DAILY_LIMIT_COUNT` | 额度限制 (KV)每个 IP 每日最大请求次数 | `200` | 否 |
| `ADMIN_IPS` | 管理员 IP (拥有重置额度、查看统计、清空全站数据的权限)| `127.0.0.1` | 否 |
| `IP_LIMIT_WHITELIST` | 免额度 IP 白名单 (请求不计入每日限额)| `127.0.0.1` | 否 |
| `ALLOW_REFERER` | 免密访问增强| `github.com` | 否 |

# 📦 重点：KV 命名空间绑定 D1数据库绑定（二选一即可）
# 1. 为什么要绑定 KV？
## 持久化存储：如果不绑定 KV，所有的计数（IP 请求数）都存在内存中。Worker 闲置或重启后，计数会清零，导致限额功能失效。
## 全站统计：绑定 KV 后，管理员可以跨 session 查看今天所有 IP 的访问记录和总请求量。
## 防爆破：持久化的限额可以更有效地保护你的 Cloudflare 额度（防止被他人恶意刷流量）。

# 2. 绑定步骤 (详细操作)
## 在 Cloudflare 侧边栏点击 Storage & Databases -> KV。
## 点击 Create namespace，名字可以自定义（例如：ACCEL_STORAGE）。
## 回到你的 Worker 详情页。
## 点击 Settings 选项卡 -> Variables 页面。
## 滚动到 KV Namespace Bindings 部分，点击 Add binding。
## Variable name 必须填：IP_LIMIT_KV (注意全大写)。
## KV namespace 选择你刚才创建的那个空间（如 ACCEL_STORAGE）。
## 点击 Save and deploy。

# 3. 如果不绑定 KV 会怎样？
## 程序依然可以运行，但限额功能将变得不可靠。
## 每次 Worker “冷启动”（一段时间没访问后再访问）时，之前的计数都会消失。
## Web 面板中的“全站统计”将无法获取历史数据，只能看到当前瞬间的内存状态。
## *(注：如果未设置环境变量，代码将使用文件顶部的 `DEFAULT_CONFIG` 默认值)*

# D1数据库绑定
## 在 Cloudflare 后台找到存储和数据库
## 创建一个D1数据库
## 执行以下 SQL 初始化表结构
```
DROP TABLE IF EXISTS ip_limits;
CREATE TABLE IF NOT EXISTS ip_limits (
    ip TEXT,
    date TEXT,
    count INTEGER DEFAULT 0,
    updated_at INTEGER,
    PRIMARY KEY (ip, date)
);
CREATE INDEX IF NOT EXISTS idx_date_count ON ip_limits(date, count DESC);
```
## 并在Workers和Pages找到部署的Workers中绑定
## 变量名设为 DB
## 另外的文件为混淆版本
---

## 💻 使用示例

## 假设你的 Worker 域名为 `docker.example.com`，设置的密码为 `123456`。

### 场景 1：Docker 镜像加速 (无需密码)

#### Worker 会自动检测 Docker 客户端，直接使用即可。

#### 直接拉取官方镜像 (自动补全 library):
```bash
docker pull domain/nginx
docker pull domain/mysql
docker pull domain/alpine
```
拉取第三方镜像 (ghcr.io, quay.io 等):
```bash
# GitHub Container Registry
docker pull domain/ghcr.io/username/image:tag

# Google Container Registry
docker pull domain/gcr.io/google-samples/hello-app:1.0
```

# ❓ 常见问题
## Q: 为什么浏览器直接访问 /v2/ 路径返回 404？
### A: 这是为了安全。脚本检测到非 Docker 客户端（如 Chrome）访问 Docker API 路径时，会故意返回 404 隐藏服务。

## Q: 为什么拉取大镜像层时通过了，但速度不快？
### A: Worker 对流式传输进行了优化，但速度仍受限于 Cloudflare 边缘节点到源站（如 Docker Hub）的连接质量。开启 ENABLE_CACHE 可以加速热门镜像的二次拉取。

## Q: 出现 403 Forbidden 怎么回事？ 
### 1.检查是否触发了 BLACKLIST 黑名单。

### 2.检查你的 IP/国家是否在允许列表中。

### 3.如果是 Docker 拉取，脚本已自动处理 S3 签名问题，请确保你的 Worker 域名没有被墙。

## Q: 为什么我修改了 PASSWORD 环境变量，但访问还是旧密码？
### A: 修改环境变量后，必须点击页面底部的 Save and deploy，Cloudflare 需要约 30 秒同步到全球节点。

## Q: 我该如何查看自己的 IP 是否在管理员列表中？
### A: 访问 Web 面板（https://域名/密码），顶部会显示你的当前 IP。将该 IP 复制并填入 ADMIN_IPS 变量中即可生效。

## Q: Docker 拉取镜像提示 429 错误？
### A: 这表示该 IP 已达到 DAILY_LIMIT_COUNT 设定的上限。你可以作为管理员进入后台点击“重置额度”，或者增加变量的值。

## Q: 换源脚本报错 "Permission denied"？
### A: 脚本中包含 sudo 命令，请确保你的 Linux 用户具有 sudo 权限，或者直接以 root 用户运行。

## Q: 是否支持自定义域名？
### A: 非常建议使用自定义域名。在 Worker 的 Settings -> Domains & Routes 中添加你的域名。使用自定义域名可以避免某些地区对 *.workers.dev 的干扰。

## 📄 法律说明
### 本项目仅供网络技术研究和学习使用。在使用过程中，请遵守所在地及 Cloudflare 的服务条款。

# 许可证
## 本项目基于 MIT 许可证开源。

# 致谢与声明
## 本项目基于 [fscarmen2/Cloudflare-Accel](https://github.com/fscarmen2/Cloudflare-Accel) 进行二次开发。

### 借鉴了原作者的 HTML 界面样式。

### 参考并改进了 Docker 镜像加速 的核心逻辑。

### 在此对原作者表示感谢！

Cloudflare-ProxyX

Today's picks

Was this content helpful?

Recent Feedback

Cloudflare-ProxyX

Today's picks

Was this content helpful?

Recent Feedback

Download README