Mihomo for Android 安装配置指南
简答:如果你只是想在 Android 手机上使用 Mihomo,通常不要直接下载 mihomo-android 的 .gz 核心文件,而应先安装带图形界面的 Android 客户端。普通新款手机优先选择 arm64-v8a;安装后导入订阅或 YAML 配置,授予 VPN 权限,再用规则模式测试连接。
定义:Mihomo for Android 可以指 Android 平台的 Mihomo 核心,也可以泛指搭载 Mihomo 内核的 Android 图形客户端,两者不是同一种下载文件。
先判断:你要下载核心,还是安装 Android 客户端?
本文是使用指南站整理的第三方资料,不是任何客户端或项目的官方下载站。搜索 Mihomo for Android 时最容易混淆的是“核心”和“客户端”:Mihomo 官方发布页提供的是按系统和 CPU 架构区分的压缩二进制文件,Android 文件名通常以 mihomo-android- 开头并以 .gz 结尾;它不是可以直接点击安装的 APK。官方 Android 图形项目则提供界面、配置管理和系统 VPN 接入能力,适合不准备手动运行核心的普通手机用户。Mihomo Releases 与 Android 图形客户端项目说明 可分别核对这两类文件。
| 你的目的 | 应选择的文件或方式 | 适用情况 |
|---|---|---|
| 在手机上直接使用 | Android 图形客户端 APK | 适合需要导入订阅、切换节点和开启 VPN 的普通用户 |
| 自行运行 Mihomo 核心 | mihomo-android-架构-版本.gz | 适合有终端、文件权限和配置管理经验的用户 |
| 手机是常见新款 ARM 设备 | 优先核对 arm64-v8a | 仍需以设备实际 ABI 和客户端兼容性为准 |
| 模拟器或 x86 设备 | x86_64 或 x86 | 仅在设备 ABI 确认对应时使用 |
截至 2026-11-08,Mihomo Releases 页面显示的稳定版本为 v1.19.33,该页面列出了 Android 的 386、amd64、arm64-v8 和 armv7 构建;版本信息可能继续变化,下载前应重新查看发布页。
四步速查:Android 安装、导入与启用
- 确认安装对象:如果你没有运行命令行核心的需求,选择 Android 图形客户端;不要把
.gz文件当成 APK 安装。成功判据是安装包能被 Android 识别并完成安装。若系统提示文件格式不支持,回到发布页重新确认下载类型。 - 确认 ABI:在手机的系统信息或设备信息页面查看 CPU/ABI。常见值包括
arm64-v8a、armeabi-v7a、x86_64和x86。官方 Android 项目列出的支持架构包括armeabi-v7a、arm64-v8a、x86和x86_64;如果系统未显示 ABI,不要仅凭手机品牌猜测,先用设备信息页核对。Android 项目要求 - 导入配置:打开客户端,进入配置、Profiles 或类似入口,粘贴订阅链接,或选择本地 YAML 文件。保存后手动更新一次配置,并确认配置列表中出现可用代理组或节点。若显示空配置、解析失败或没有节点,先检查链接是否完整、是否需要登录以及订阅格式是否与客户端兼容。
- 开启 VPN 并验证:选择规则模式作为第一次测试,点击启动或连接,接受 Android 的 VPN 权限提示。成功判据要分开看:客户端状态显示运行、系统状态栏出现 VPN 标识、代理测试页面能打开、节点延迟或连接测试有返回。只看到“已启动”并不能证明实际代理链路正常。
如果客户端支持通过链接导入配置,官方 Android 项目 README 记录了 clash://install-config?url= 和 clashmeta://install-config?url= 形式的导入方案;具体是否被你安装的版本接收,仍应以该版本界面和发布说明为准。项目 README
Mihomo Android 架构文件怎么选?
官方 FAQ 说明,发布文件名包含程序名称、操作系统、架构和编译方式等信息。对 Android 用户,先看 android,再看架构部分;不要把 amd64、386 和 ARM 文件混用。Mihomo 文件选择 FAQ
| 文件标识 | 通常对应 | 选择建议 |
|---|---|---|
android-arm64 或 arm64-v8 | 64 位 ARM Android 设备 | 多数较新的实体 Android 手机优先核对这一项 |
android-armv7 | 32 位 ARM 设备 | 老旧手机或明确显示 armeabi-v7a 时考虑 |
android-amd64 | 64 位 x86 Android 设备 | 主要用于部分模拟器或特殊设备 |
android-386 | 32 位 x86 Android 设备 | 仅在 ABI 明确为 x86 时使用 |
下载核心时还要注意:官方页面列出的 Android 核心是压缩文件,不能替代图形客户端的安装、配置和 VPN 授权流程。若你的目标只是连接节点,直接寻找“核心 APK”容易走错流程;应先确认是否需要图形界面。
下载与校验:避免把未知 APK 当成 Mihomo 客户端
- 优先从项目官方 GitHub 仓库或其 Releases 页面进入下载,不使用无法核实归属的二次打包页面。
- 核对项目名称、发布标签、资产文件名和发布日期,避免把测试版、旧版或其他架构文件混在一起。
- 对于 Mihomo 核心,官方 Releases 页面为每个资产列出了 SHA-256 值。下载后使用系统或可信校验工具计算 SHA-256,并与页面值逐字比较;不一致就删除文件,不继续解压或运行。
- 对于 APK,如果下载页没有给出可核对的发布记录、签名信息或校验值,应把来源标记为“未核实”,不要因为文件名包含 Mihomo 就视为官方包。
回滚方法是卸载当前客户端前先导出或记录订阅地址、配置文件和自定义规则;升级失败时安装此前能够正常工作的版本,并重新导入配置。具体版本兼容性不能仅凭核心版本号推断。
Android 连接失败时按现象分流
| 现象 | 先检查 | 成功判据 | 失败时的回滚或下一步 |
|---|---|---|---|
| 没有节点或代理组 | 订阅地址、登录状态、配置更新时间和 YAML 解析提示 | 配置中出现代理组或节点列表 | 删除失败配置,重新导入原始链接或本地备份 |
| 点击启动后无 VPN 标识 | Android VPN 权限、是否被其他 VPN 应用占用 | 系统状态栏出现 VPN 标识,客户端状态为运行 | 停止其他 VPN 应用,撤销后重新授予权限 |
| 显示运行但网页打不开 | 当前模式、节点选择、代理链路和 DNS 错误日志 | 代理测试和目标网页分别有返回 | 先切换到规则模式或更换已存在的节点,不要同时修改 DNS、MTU 和规则 |
| 锁屏后断连 | 电池优化、后台限制、系统清理策略 | 锁屏一段时间后客户端仍保持运行 | 先恢复默认电池策略;若问题仅出现在某个系统版本,记录系统版本和日志后再判断 |
排查时建议逐项记录:Android 版本、客户端版本、ABI、配置来源、当前模式、节点名称、发生时间和错误日志。不要一次同时更改节点、DNS、TUN 和规则,否则无法判断究竟是哪一步产生了变化。
适用范围与未核实内容
本文覆盖 Android 手机上选择 Mihomo 核心或图形客户端、核对 ABI、导入订阅、授予 VPN 权限和基础连接排查。不同客户端的菜单名称、APK 发布渠道、签名方式、TUN 实现、电池保活策略和订阅格式支持可能不同,本文不对未列明版本作保证。具体版本、下载资产和官方发布状态,以项目当前页面为准。
本站仅提供使用指南,不代表任何客户端项目的官网。若你使用的是具体服务订阅,服务地址、可用性、节点质量和账号状态需要由对应服务提供方核实。
参考资料
- Mihomo 官方 Releases:版本、Android 架构资产与 SHA-256
- Mihomo 官方文档:预编译文件与 Android 架构列表
- Mihomo 官方 FAQ:发布文件名与架构选择说明
- Android 图形客户端项目:支持架构、系统要求与配置导入说明
常见问题
Mihomo for Android 有官方 APK 吗?
Mihomo 核心官方 Releases 页面主要列出按 Android 架构区分的压缩二进制文件,不等同于 APK。需要图形界面和 VPN 操作的用户,应寻找能够核实项目归属的 Android 图形客户端;具体 APK 发布位置和版本以对应项目页面为准。
普通 Android 手机应该下载 arm64 还是 armv7?
不要只凭手机型号判断。先查看设备 ABI;显示 arm64-v8a 时核对 arm64 文件,显示 armeabi-v7a 时核对 armv7 文件。无法确认时不要反复安装不同架构包,以免把安装失败误判为客户端故障。
为什么下载了 mihomo-android 文件却无法安装?
因为该文件通常是 Mihomo 核心压缩包,不是 Android APK。核心需要由支持它的客户端或运行环境调用,不能直接通过系统安装器打开。请先确认你的目标是安装图形客户端,还是自行运行核心。
导入订阅后没有节点怎么办?
先确认订阅链接完整、账号仍有效、配置更新没有报错,再检查配置中是否出现代理组或节点。若仍为空,删除当前失败配置并重新导入备份链接;服务地址和订阅状态需要向对应提供方核实。
连接后很快断开,应该先改 DNS 或 MTU 吗?
不建议一开始同时修改 DNS、MTU、TUN 和规则。先确认 VPN 权限、节点选择、当前模式和日志,再检查电池优化或后台限制;每次只改一项并记录结果,便于回滚。