> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qomicex.top/llms.txt
> Use this file to discover all available pages before exploring further.

# 下载镜像

> QML-Mirror：Minecraft 模组与依赖库的国内加速镜像，支持按路径前缀路由到各加载器仓库。

## 下载镜像

**QML-Mirror** 是为国内 Minecraft 玩家提供的模组与依赖库加速镜像。针对直连海外官方源（Forge、Fabric、Mojang 等）时常见的超时、单线程限速与频繁断连问题，镜像基于腾讯云 EdgeOne 全球边缘节点构建。

核心特性：

* **国内直连**：国内三网直连，无需跨国链路。
* **边缘强缓存**：热门模组与依赖库在边缘节点缓存，重复下载走边缘命中。
* **支持多线程分片**：兼容启动器并发下载，突破官方源单线程限速。
* **全加载器覆盖**：Forge、NeoForge、Fabric、Quilt、Legacy Fabric、Babric、Cleanroom、Sponge 等。
* **强制 HTTPS**：全站 HTTPS + HTTP/2。

## 调用方式

镜像采用**路径前缀路由**：把原始 URL 的域名替换为 `mirror.shenv.top`，并在路径前加上对应仓库的前缀，其余路径保持不变。

例如 Forge 安装包：

```text theme={null}
# 原始链接
https://maven.minecraftforge.net/net/minecraftforge/forge/1.20.1-47.2.0/forge-1.20.1-47.2.0-installer.jar

# 镜像链接
https://mirror.shenv.top/mc-forge/net/minecraftforge/forge/1.20.1-47.2.0/forge-1.20.1-47.2.0-installer.jar
```

## 路径映射表

> [!WARNING]
>
> 标注「暂不可用」的前缀当前请求会失败，正在修复中；其余前缀可正常使用。

### 核心加载器（Maven 仓库）

| 上游域名 | 镜像前缀 | 原路径示例 |
| :- | :- | :- |
| `maven.minecraftforge.net` | `/mc-forge/` | `/mc-forge/net/minecraftforge/...` |
| `files.minecraftforge.net` | `/mc-forge-files/` | `/mc-forge-files/maven/...` |
| `maven.neoforged.net` | `/mc-neoforge/` | `/mc-neoforge/net/neoforged/...` （暂不可用） |
| `maven.fabricmc.net` | `/mc-fabric/` | `/mc-fabric/net/fabricmc/...` |
| `maven.quiltmc.org` | `/mc-quilt/` | `/mc-quilt/org/quiltmc/...` |
| `maven.legacyfabric.net` | `/mc-legacyfabric/` | `/mc-legacyfabric/net/legacyfabric/...` （暂不可用） |
| `maven.glass-launcher.net` | `/mc-babric/` | `/mc-babric/...` （暂不可用） |
| `repo.maven.apache.org` | `/mc-apache/` | `/mc-apache/maven2/...` |
| `maven.cleanroommc.com` | `/mc-cleanroom/` | `/mc-cleanroom/...` （暂不可用） |
| `repo.spongepowered.org` | `/mc-sponge/` | `/mc-sponge/maven/...` （暂不可用） |

### 版本元数据（Meta）

注：`maven.neoforged.net` 的 QML 镜像前缀暂不可用。Qomicex 启动器对 NeoForge maven 已改用官方 CDN `neoforged.forgecdn.net` 作为兜底（路径与官方 maven 同构），BMCLAPI `/maven` 亦可用；插件批量下载（`download.addBatch`）自动获得这些兜底。

| 上游域名 | 镜像前缀 | 原路径示例 |
| :- | :- | :- |
| `meta.fabricmc.net` | `/mc-fabric-meta/` | `/mc-fabric-meta/v2/versions/...` |
| `meta.quiltmc.org` | `/mc-quilt-meta/` | `/mc-quilt-meta/v3/versions/...` |
| `meta.legacyfabric.net` | `/mc-legacyfabric-meta/` | `/mc-legacyfabric-meta/v2/versions/...` |
| `meta.babric.glass-launcher.net` | `/mc-babric-meta/` | `/mc-babric-meta/v2/versions/...` （暂不可用） |

### 原版基础资源

| 上游域名 | 镜像前缀 | 原路径示例 |
| :- | :- | :- |
| `libraries.minecraft.net` | `/mc-libraries/` | `/mc-libraries/com/mojang/...` （暂不可用） |
| `resources.download.minecraft.net` | `/mc-assets/` | `/mc-assets/xx/xxxx...` （暂不可用） |

## 架构说明与性能指标

**缓存策略**：`.jar`、`.pom` 等不可变文件走边缘节点长缓存；`.xml`、`.json` 等元数据文件采用短缓存或不缓存，保证拿到最新版本信息。

**回源机制**：大文件请求直接走 EdgeOne 原生 CDN 链路回源并分片传输，不经过边缘函数，从而降低首字节延迟（TTFB）并突破单线程带宽限制。

**性能实测**：下载 8 MB 的 Forge 安装包，官方源直连约 14 秒，经本镜像约 4.3 秒（单线程）；二次下载命中缓存后可缩短至 1 秒内。

## 与 Qomicex 启动器的关系

> [!NOTE]
>
> 启动器已按流量分工接入：**模组加载器的 meta 与 installer**（Fabric/Quilt meta、Forge installer 与 maven 依赖等小体积、强缓存文件）默认走 QML-Mirror（上表前缀路由，官方源自动兜底）；**模组文件**走官方 CDN（MCIM 镜像兜底）——模组文件体积大、流量高，统一打到公益镜像会打爆 CDN，因此只在加载器元数据与安装器这类小文件上使用镜像。

## 常见问题

**下载返回 404？** 检查路径前缀是否与映射表一致。部分上游仓库有额外目录层级（如 NeoForge 依赖的 `/releases/`），镜像内部已做重写。

**会记录下载内容吗？** 不会。镜像仅作为 CDN 缓存节点，不记录或审查用户行为。

**是官方服务吗？** 不是。由个人开发者基于开源精神维护的公益加速节点，与 Mojang、Forge、Fabric 等团队无隶属关系。

> 仅供学习交流与个人游戏加速使用，请勿用于商业用途或恶意刷流量。所有游戏文件版权归各自原作者所有。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.