ClashBox 装在 HarmonyOS 5 以上，三条安装路线和已知限制

纯血鸿蒙装不了 APK，这个缺口由它来补

HarmonyOS 5 及以上的手机和平板不再直接安装安卓 APK。华为官网列出的装应用途径只有应用市场、分享安装包和企业内部应用，分享来的 APK 能不能装，要看卓易通这个兼容应用支不支持。安卓上常用的 Clash Meta for Android 和 FlClash 都没有官方鸿蒙版。MetaCubeX 维护的文档站按平台列了客户端，给 HarmonyOS NEXT 的那一格里只有 ClashBox，状态写着维护中。两代系统怎么区分、版本号在哪看，写在鸿蒙平台页。

从 ClashMeta、ClashNEXT 一路改名过来

ClashBox 的前身是 likuai2010 名下的 ClashMeta，自称 HarmonyOS Next 上第一款 Go 语言开源移植应用，2024 年 11 月 28 日发完 1.5.6 后停更，README 让用户移步 xiaobaigroup/ClashBox。新仓库建于 2025 年 2 月 22 日，头几个测试版叫 ClashNEXT。2025 年 5 月的 1.4.7 已经用上 ClashBox 这个名字，7 月的 LTS 1.5.1 在发布说明里解释，AppGallery 审核不让继续用 ClashNEXT 的名称和图标。

我 2026 年 9 月 20 日看过仓库，没有归档，星标约 4400，最近一次推送在 8 月 15 日，9 月 11 日仍有维护者在 issue 里答复用户。GitHub Releases 上最新的是 2026 年 4 月 2 日的 1.7.4，标题是 ClashBox LTS (V1)。

ArkTS 写的界面，改版 mihomo 做内核

README 说前端用鸿蒙的 ArkTS 开发，排版仿照 Surfboard，从手机、折叠屏、平板到鸿蒙电脑都适配过，内核是改版的 mihomo，功能基本对齐。它读的是机场给的 Clash 订阅，添加配置有四个入口，URL、二维码、本地文件，外加新建空白配置。

源码只公开了一部分。main 分支首页宣称多数代码已经公开，指向 master 分支，可 master 分支自己的说明写着只有前端，改版的后端暂不开源。我翻了 master 的目录，proxy_core 里放着一个约 100 MB 的预编译 libflclash.so，内核子模块指向 xfz347/Clash.Meta，它是 FlClash 作者那个 Clash.Meta 分支的再分支。MetaCubeX 文档对它的标注也是前端开源、构建不可复现。

三条安装路线，都不省事

第一条是海外区应用市场。1.4.7 的发布说明写它已上架鸿蒙海外市场。项目成员 2026 年 6 月 22 日答复过，证书时效是华为定的，想要长期证书，唯一的途径是从华为海外应用市场下载安装。按维护者在其他 issue 里的回复，商店版已经更新到 2.x。大陆区应用市场里搜不到它，团队成员 2025 年 4 月说过，它上过一次内测尝鲜，被举报后下架。怎样才能在应用市场里搜到它，项目方没有给出步骤，本站也没有验证过。

第二条是侧载 GitHub 上的 HAP。1.7.4 只有一个文件 ClashBox_LTS_V1_unsigned.hap，约 103 MB，没有签名，直接传到手机上装不了。ClashBox 的 README 推荐用 Auto-installer 在电脑上签名安装，这个工具的中文名叫 小白调试助手，也在 likuai2010 名下。它的 GitHub 仓库除了说明文件就是两张打赏二维码，代码没放出来，用的时候要登录华为账号。签名这一步有两个限制，华为的签名服务器屏蔽中国大陆以外的 IP，自己签的应用默认只能用 14 天，实名认证过的开发者账号能签 180 天。英文版说明另外提醒，实名认证可能要求中国居民身份证。DevEco Testing 也在 README 的推荐里，不过到了 2026 年，维护者在 1 月、4 月两次答复，它装不了未签名的 HAP。

第三条是拉源码用 DevEco Studio 自己编译，维护者在 issue 里给过这个建议，适合本来就做鸿蒙开发的人。前两条的具体做法写在本页的鸿蒙教程里。

装好以后最常碰到的问题

鸿蒙会回收后台进程，华为开发者文档又写明，发起 VPN 的应用进程一退出，系统就会停掉它的 VPN。所以 ClashBox 在设置里放了后台运行，四种保活办法分别是模拟定位、模拟下载、模拟画中画和任务保持。README 说打开模拟画中画后还会启用核心恢复，进程被杀后自动拉起内核。应用里的提示写明，开了会更费电。

卓易通是一个装安卓应用的容器，项目成员说鸿蒙系统的 DNS 设置进不去这个容器，所以开着 ClashBox 时，卓易通里的应用可能上不了网。给的缓解办法是打开覆写 DNS 或兼容模式，不保证有效，访问控制也只能管非容器应用。9 月 16 日还有用户报告在鸿蒙 7 上从 URL 导入配置后出错，到 9 月 20 日维护者还没回复，用鸿蒙 7 的可以留意这个 issue。