# EdgeMirror

**Repository Path**: MitchellSorin/EdgeMirror

## Basic Information

- **Project Name**: EdgeMirror
- **Description**: 国内访问常用开发资源的cdn加速
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-03
- **Last Updated**: 2026-07-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
  <a href="README.md">English</a> | <a href="README.es.md">Español</a> | <strong>中文</strong>
</p>

<h1 align="center">EdgeMirror</h1>

<p align="center">
  面向开发者资源的 CDN 风格边缘镜像网关。
</p>

<p align="center">
  用一个清爽域名加速 PyPI、PyTorch、Hugging Face、GitHub、Docker 镜像仓库、Linux 软件源、npm、Go modules、Maven、crates.io、运行时下载和通用文件转发。
</p>

<p align="center">
  <a href="https://deploy.workers.cloudflare.com/?url=https://github.com/tianrking/edgemirror">
    <img alt="Deploy to Cloudflare" src="https://img.shields.io/badge/Deploy%20to-Cloudflare-f38020?style=for-the-badge&logo=cloudflare&logoColor=white&labelColor=111827">
  </a>
  <a href="https://vercel.com/new/clone?repository-url=https://github.com/tianrking/edgemirror">
    <img alt="Deploy with Vercel" src="https://img.shields.io/badge/Deploy%20with-Vercel-000000?style=for-the-badge&logo=vercel&logoColor=white&labelColor=111827">
  </a>
</p>

<p align="center">
  <img alt="Verify" src="https://img.shields.io/github/actions/workflow/status/tianrking/edgemirror/verify.yml?branch=main&style=for-the-badge&label=verify">
  <img alt="Runtime" src="https://img.shields.io/badge/runtime-Cloudflare%20Workers%20%7C%20Vercel%20Functions-0f172a?style=for-the-badge">
  <img alt="Language" src="https://img.shields.io/badge/language-JavaScript%20ESM-f7df1e?style=for-the-badge&labelColor=111827">
  <img alt="Package manager" src="https://img.shields.io/badge/package-npm-cb3837?style=for-the-badge">
  <img alt="Maintainer" src="https://img.shields.io/badge/maintainer-tianrking-2563eb?style=for-the-badge">
</p>

## 项目定位

EdgeMirror 是一个单域名边缘镜像网关，用一个仓库提供一组常用开发源加速服务。推荐的生产玩法是一个公开域名，例如 `edgemirror.w0x7ce.eu`，然后用路径区分服务：`/edgemirror`、`/pypi`、`/hf`、`/github`、`/docker`、`/mirrors`、`/proxy`、`/npm`、`/go`、`/maven`、`/crates`、`/downloads`、`/help`。

维护者：[tianrking](https://github.com/tianrking)

关键词：边缘镜像网关，CDN 风格源加速，Cloudflare Workers 代理，Vercel Functions 代理，PyPI 加速，PyTorch wheel 代理，Hugging Face 镜像，Docker registry 代理，GitHub raw 代理，Linux 软件源代理，npm registry 代理，Go module proxy，Maven / Gradle 镜像，crates.io sparse registry 代理，运行时下载加速。

## 技术栈标签卡片

<p align="center">
  <img alt="Cloudflare Workers" src="https://img.shields.io/badge/Cloudflare-Workers-f38020?style=for-the-badge">
  <img alt="Vercel Functions" src="https://img.shields.io/badge/Vercel-Functions-000?style=for-the-badge">
  <img alt="JavaScript ESM" src="https://img.shields.io/badge/JavaScript-ESM-f7df1e?style=for-the-badge&labelColor=111827">
  <img alt="Single domain" src="https://img.shields.io/badge/single--domain-paths-2563eb?style=for-the-badge">
  <img alt="Path routing" src="https://img.shields.io/badge/path-routing-16a34a?style=for-the-badge">
  <img alt="PyPI" src="https://img.shields.io/badge/PyPI-packages-3775a9?style=for-the-badge">
  <img alt="PyTorch" src="https://img.shields.io/badge/PyTorch-wheels-ee4c2c?style=for-the-badge">
  <img alt="Hugging Face" src="https://img.shields.io/badge/Hugging%20Face-models-ffd21e?style=for-the-badge&labelColor=111827">
  <img alt="GitHub" src="https://img.shields.io/badge/GitHub-proxy-2da44e?style=for-the-badge">
  <img alt="Docker" src="https://img.shields.io/badge/Docker-registry-0db7ed?style=for-the-badge">
  <img alt="Linux mirrors" src="https://img.shields.io/badge/Linux-mirrors-8b5cf6?style=for-the-badge">
  <img alt="Universal proxy" src="https://img.shields.io/badge/Universal-file%20proxy-d946ef?style=for-the-badge">
  <img alt="npm" src="https://img.shields.io/badge/npm-registry-cb3837?style=for-the-badge">
  <img alt="Go modules" src="https://img.shields.io/badge/Go-modules-00add8?style=for-the-badge">
  <img alt="Maven" src="https://img.shields.io/badge/Maven-Gradle-c71a36?style=for-the-badge">
  <img alt="crates.io" src="https://img.shields.io/badge/crates.io-sparse-dea584?style=for-the-badge&labelColor=111827">
  <img alt="Downloads" src="https://img.shields.io/badge/runtime-downloads-0f766e?style=for-the-badge">
  <img alt="Syntax check" src="https://img.shields.io/badge/syntax-check-22c55e?style=for-the-badge">
  <img alt="Smoke test" src="https://img.shields.io/badge/smoke-tested-22c55e?style=for-the-badge">
  <img alt="npm audit" src="https://img.shields.io/badge/npm-audit-22c55e?style=for-the-badge">
  <img alt="One click deploy" src="https://img.shields.io/badge/one--click-deploy-7c3aed?style=for-the-badge">
  <img alt="Wrangler" src="https://img.shields.io/badge/Wrangler-4.x-f38020?style=for-the-badge">
</p>

## 服务矩阵

`Stable` 表示已经适合日常使用。`Test` 表示功能已经实现、接入 smoke test，并适合继续验证，稳定后再提升为 Stable。

每个页面都有统一的 English / Español / 中文 切换。工具名称保持英文，说明、用法提示和常见 UI 标签会跟随所选语言显示。

| 状态 | 服务 | 单域名路径 | 可加速资源 |
| --- | --- | --- | --- |
| Stable | EdgeMirror Portal | `/` 或 `/edgemirror` | 所有源加速服务的可视化入口和使用示例 |
| Stable | Help | `/help` | 支持英文、西班牙语、中文的路径地图、网页用法、命令行示例和配置说明 |
| Stable | PyPI / PyTorch | `/pypi` | PyPI simple index、Python 包文件、PyTorch wheel 下载 |
| Stable | Hugging Face | `/hf` | Hugging Face API、模型、数据集和 LFS 大文件下载 |
| Stable | GitHub | `/github` | Git clone、Raw 文件、Release 资源和 GitHub 页面 |
| Stable | Docker Registry | `/docker` UI，`/v2` API | Docker Hub 以及 `quay`、`gcr`、`k8s`、`ghcr`、`nvcr` 前缀 |
| Stable | Linux Mirrors | `/mirrors` | APT、YUM、DNF、Pacman、wget、curl 的透传软件源路径 |
| Stable | Universal Proxy | `/proxy` | 任意 HTTP/HTTPS 文件 URL 和下载文件名处理 |
| Test | npm Registry | `/npm` | npm、pnpm、yarn metadata 和 tarball 下载 |
| Test | Go Module Proxy | `/go` | GOPROXY module list、版本 metadata、`.mod` 和 `.zip` 文件 |
| Test | Maven / Gradle | `/maven` | Maven Central、Google Maven、Gradle Plugin Portal、JitPack |
| Test | crates.io Sparse | `/crates` | Cargo sparse index 和 `.crate` 包下载 |
| Test | Runtime Downloads | `/downloads` | Node.js、Python、Go、Rustup、Open VSX、SourceForge、GitLab、Gitea 和直接 URL 文件 |

## 一键部署

### 部署到 Cloudflare Workers

点击 README 顶部的 Cloudflare 按钮，或直接打开：

```text
https://deploy.workers.cloudflare.com/?url=https://github.com/tianrking/edgemirror
```

Cloudflare 会读取 `wrangler.toml`，创建 Worker，并部署到当前账户提供的 Worker 名称。默认配置是可移植的一键部署配置：启用 `workers.dev`，关闭 preview URLs，并且不会默认绑定维护者自己的自定义域名。

Worker 部署成功后，可以在 Cloudflare 控制台添加一个自定义域名；也可以确认该域名属于当前 Cloudflare 账户后，把 `wrangler.custom-domain.example.toml` 里的 route 配置复制到 `wrangler.toml`。所有工具仍然使用同一套路径路由。

### 部署到 Vercel

点击 README 顶部的 Vercel 按钮，或直接打开：

```text
https://vercel.com/new/clone?repository-url=https://github.com/tianrking/edgemirror
```

Vercel 会使用 `api/index.js` 作为 Web Handler 函数入口，并根据 `vercel.json` 把所有路径转发到该函数。Vercel 部署使用同一套路由：`/edgemirror`、`/pypi`、`/hf`、`/github`、`/docker`、`/mirrors`、`/proxy`、`/npm`、`/go`、`/maven`、`/crates`、`/downloads`、`/help`。Docker Registry API 流量会在 `/v2`、`/token`、`/_worker_blob_proxy` 自动识别，因此单个 Vercel 域名也可以直接用于 Docker pull，不需要把 `/docker` 写进镜像名。

## 本地开发

```bash
npm install
npm run verify
npm run dev
```

常用命令：

| 命令 | 作用 |
| --- | --- |
| `npm run dev` | 启动 Cloudflare Worker 本地开发服务器 |
| `npm run dev:cloudflare` | 与 `npm run dev` 相同 |
| `npm run dev:vercel` | 使用 `npx vercel@latest dev` 启动 Vercel 本地开发 |
| `npm run check` | 语法检查 `src` 和 `scripts` 下所有 JavaScript 文件 |
| `npm run smoke:vercel` | 导入 Vercel 函数入口并验证核心路由 |
| `npm run verify` | 运行语法检查、Vercel smoke test 和高危 npm audit |
| `npm run deploy:cloudflare` | 使用 Wrangler 部署到 Cloudflare |
| `npm run deploy:vercel` | 使用 `npx vercel@latest --prod` 部署到 Vercel 生产环境 |

## 路由模型

EdgeMirror 以单域名路径路由为主：

| 路由方式 | 示例 | 说明 |
| --- | --- | --- |
| 路径路由 | `https://edgemirror.w0x7ce.eu/pypi/simple/` | 推荐生产模式 |
| Vercel 路径路由 | `https://your-app.vercel.app/pypi/simple/` | Vercel 一键部署后使用同样路径 |

单域名部署下的 Docker 用法：

```bash
docker pull your-app.vercel.app/library/nginx:latest
```

路由器会自动把 Docker 的 `/v2`、`/token` 和 blob redirect 流量转交给 Docker 工具。

健康检查路径：

```text
/health
/healthz
/__health
```

健康检查会返回项目版本和已注册服务列表。

## 使用示例

安装 Python 包：

```bash
pip install numpy -i https://edgemirror.w0x7ce.eu/pypi/simple/
```

安装 PyTorch wheel：

```bash
pip install torch torchvision --index-url https://edgemirror.w0x7ce.eu/pypi/pytorch/cu118
```

下载 Hugging Face 模型：

```bash
export HF_ENDPOINT=https://edgemirror.w0x7ce.eu/hf
huggingface-cli download gpt2
```

通过 GitHub 代理克隆仓库：

```bash
git clone https://edgemirror.w0x7ce.eu/github/vercel/next.js.git
```

拉取 Docker 镜像：

```bash
docker pull edgemirror.w0x7ce.eu/library/nginx:latest
```

代理任意文件：

```bash
curl -L -O "https://edgemirror.w0x7ce.eu/proxy/https://nodejs.org/dist/v22.11.0/node-v22.11.0-x64.msi"
```

使用新增的 Test npm registry 路由：

```bash
npm install lodash --registry=https://edgemirror.w0x7ce.eu/npm/
pnpm install lodash --registry=https://edgemirror.w0x7ce.eu/npm/
```

使用新增的 Test Go module 路由：

```bash
go env -w GOPROXY=https://edgemirror.w0x7ce.eu/go,direct
```

使用新增的 Test Maven / Gradle 路由：

```kotlin
repositories {
    maven { url = uri("https://edgemirror.w0x7ce.eu/maven/maven-central") }
    maven { url = uri("https://edgemirror.w0x7ce.eu/maven/google") }
    maven { url = uri("https://edgemirror.w0x7ce.eu/maven/gradle-plugin") }
}
```

使用新增的 Test crates.io sparse 路由：

```toml
[source.crates-io]
replace-with = "edgemirror"

[source.edgemirror]
registry = "sparse+https://edgemirror.w0x7ce.eu/crates/"
```

使用新增的 Test 运行时下载路由：

```bash
curl -L -O "https://edgemirror.w0x7ce.eu/downloads/node/v22.11.0/node-v22.11.0-x64.msi"
curl -L -O "https://edgemirror.w0x7ce.eu/downloads/https://nodejs.org/dist/v22.11.0/node-v22.11.0-x64.msi"
```

## 项目结构

```text
api/index.js              Vercel Functions Web Handler 入口
scripts/check-syntax.mjs  跨平台 JavaScript 语法检查脚本
scripts/smoke-vercel.mjs  Vercel 运行时 smoke test
src/config.js             项目元数据、服务注册表、健康检查路径
src/html.js               非 Cloudflare 运行时的 HTML rewrite fallback
src/i18n.js               语言检测、语言切换链接和本地化 URL
src/index.js              域名/路径路由和健康检查入口
src/proxy-utils.js        共享 CORS、重定向、请求头和代理工具
src/tools/*.js            各工具实现
vercel.json               Vercel 路由与构建配置
wrangler.toml             可移植的 Cloudflare Workers 部署配置
wrangler.custom-domain.example.toml  可选自定义域名配置示例
```

## 配置说明

新增、重命名或说明工具时，优先修改 `src/config.js`。修改 Cloudflare Worker 名称或兼容日期时，修改 `wrangler.toml`。

如果要在 Cloudflare 使用自定义域名，请先在 Cloudflare 控制台添加该域名，或参考 `wrangler.custom-domain.example.toml`。如果要在 Vercel 使用自定义域名，请在 Vercel 控制台添加一个主域名，并继续使用同样的路径路由。

## 生产注意事项

- 部署前保持 `npm run verify` 通过。
- 保持 `wrangler` 更新，它是本地 Cloudflare 开发和部署工具链。
- Cloudflare 自定义域名与账户绑定，因此默认 `wrangler.toml` 不硬编码自定义域名。
- 公开产品体验推荐使用一个主域名；旧的多工具多域名不是推荐交互模型。
- 上游服务自己的限流、认证要求和服务条款仍然适用。

## 后续路线

- 新增 Test 加速器经过更多上游兼容性验证后提升为 Stable。
- 支持通过环境变量配置服务域名。
- 增加结构化访问日志和可选请求追踪。
- 为每个工具补充 mock upstream 的 smoke test。
- 增加门户和工具页面的部署预览截图。