自托管 Minecraft 下载镜像 · BMCLAPI 兼容 · 磁盘缓存 + SHA-1 内容校验 · 零依赖 Node.js

Mojang piston-meta / piston-data Assets Maven / Libraries Forge NeoForge Fabric —

运行状态

–
总请求
–
缓存命中率
–
缓存命中
–
回源下载
–
回源流量
–
对外流量

路由计数加载中…

最新版本 同步中…

–
Minecraft 正式版 / 快照
–
Fabric Loader
–
Forge(最新 MC 推荐)
–
NeoForge

版本数据定时从各官方源同步,写入 data/versions.json,同时刷新镜像内部缓存。

端点一览

路径上游缓存
/mc/game/version_manifest.jsonpiston-meta.mojang.comTTL 60s
/v1/packages/<sha1>/<name>piston-meta.mojang.com永久 · SHA-1 校验
/v1/objects/<sha1>/<name>piston-data.mojang.com永久 · SHA-1 校验
/version/<id>/json|client|server经版本清单解析后 302302
/assets/<xx>/<sha1>resources.download.minecraft.net永久 · SHA-1 校验
/maven/<path>libraries.minecraft.net → Maven CentralTTL 24h
/maven.minecraftforge.net/<path>maven.minecraftforge.netTTL 24h
/files.minecraftforge.net/<path>files.minecraftforge.netTTL 5min
/fabric-meta/<path>meta.fabricmc.netTTL 5min
/maven.fabricmc.net/<path>maven.fabricmc.netTTL 24h
/maven.neoforged.net/<path>maven.neoforged.netTTL 24h
/healthz · /api/stats · /api/versions本机实时

同时兼容把 Mojang 域名直接替换为本站 host 的用法:/piston-meta/…、/launchermeta/…、/piston-data/…、/launcher/…、/resources.download.minecraft.net/…。JSON 内的所有上游 URL 都会被重写为本站地址。

接入方式

HMCL:设置 → 更新 → 下载源选择「自定义 BMCLAPI」,填入 http://<本机IP>:8080。其他启动器同理,任何支持自定义 BMCLAPI 根地址的客户端都可以直接使用。