打开 mihomo 的 GitHub 仓库,为什么看到的是另一个项目?
mihomo 仓库的默认分支放的是一个无关的 Python 项目,内核代码和发布版在别处。这篇说明怎么认准真正的发布页。
标签:mihomo
- 内容
- 内核代码在哪个分支、下载认准发布页、大多数人不用下载内核
- 预计阅读
- 约 2 分钟
打开 github.com/MetaCubeX/mihomo(在新窗口打开),首页显示的不是代理内核,而是一个 Python 项目:README 写的是 Honkai: Star Rail(崩坏:星穹铁道)游戏数据的 Python 模型,文件也只有 pyproject.toml、mihomo 文件夹等几个。很多人会因此以为自己进错了仓库。
其实仓库没错,只是 GitHub 首页默认显示的是 main 分支,而这个分支放的不是内核代码。
内核代码在哪个分支
以下是 2026-10-29 查看仓库的结果:
| 分支 | 内容 |
|---|---|
main(默认分支) |
与内核无关的 Python 项目 |
Alpha |
内核最新提交,测试版(Prerelease-Alpha)从这里构建 |
Meta |
内核正式版代码。官方构建流程在发布正式版时把 Alpha 同步到 Meta,并在这个提交上打版本标签 |
官方 FAQ(在新窗口打开) 的说法是:alpha 分支是最新提交,meta 分支每隔一段时间合并 alpha 的代码,meta 不一定比 alpha 更稳定。
想看内核代码,在仓库首页左上角的分支下拉框里切换到 Meta;切换后 README 标题是 “Meta Kernel”。
下载认准发布页
不管默认分支显示什么,发布页是整个仓库共用的,安装包都在这里:
github.com/MetaCubeX/mihomo/releases(在新窗口打开)
- 正式版的版本标签是
v1.19.33这样的格式,例如 v1.19.33(在新窗口打开)。 - 标着 Pre-release 的
Prerelease-Alpha是测试版,由Alpha分支自动构建,日常使用选正式版。 - 官方文档在 wiki.metacubex.one(在新窗口打开)(
Meta分支 README 里的链接)。
文件很多,怎么选见 mihomo 下载与安装。
大多数人不用下载内核
mihomo 是内核,没有图形界面。Clash Verge Rev、FlClash、Clash Meta for Android 等客户端已经内置了它,装客户端就够了。只有在服务器、路由器上直接运行,或者自己写配置调试时,才需要单独下载内核。按设备选客户端见 Clash 下载。
mihomo 和 Clash Meta 是什么关系,见 mihomo 中文指南。
本页内容依据各项目的官方文档和源码整理 · 有错误?提交反馈