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

> 来源 https://jichangtuijianweb.co/kehuduan/clashbox/，更新于 2026 年 9 月 20 日。机场推荐网（https://jichangtuijianweb.co/）原创内容。
> 维护中。mihomo 内核，最新版本 1.7.4（核对于 2026-09-18）。支持 鸿蒙 HarmonyOS。

ClashBox 是 HarmonyOS 5 及以上的原生 Clash 客户端，2026 年 9 月仍在维护。纯血鸿蒙装不了 APK，用机场主要靠它，只是安装麻烦、证书会过期。

## 官方下载入口

- 鸿蒙 HarmonyOS https://github.com/xiaobaigroup/ClashBox/releases
- 官方仓库 https://github.com/xiaobaigroup/ClashBox

## 用之前要知道

- GitHub 发布页的 HAP 没签过名，得借电脑签名后装。按 README 的说法，自己签的证书默认管 14 天，开发者账号实名以后延长到 180 天，过期就要重装
- 人在境外时签名会被拒，README 说华为的签名服务器屏蔽中国大陆以外的 IP
- 源码没有全部公开，master 分支只放出前端，改版后端暂不开源
- 鸿蒙会回收后台进程，要在设置的后台运行里选一种保活方式，应用自己提示这样更费电
- 卓易通里的安卓应用可能上不了网，项目成员说鸿蒙系统的 DNS 设置进不去这个容器

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

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

## 从 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](https://jichangtuijianweb.co/kehuduan/surfboard/)，从手机、折叠屏、平板到鸿蒙电脑都适配过，内核是改版的 [mihomo](https://jichangtuijianweb.co/kepu/mihomo-neihe/)，功能基本对齐。它读的是机场给的 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 里给过这个建议，适合本来就做鸿蒙开发的人。前两条的具体做法写在[本页的鸿蒙教程](https://jichangtuijianweb.co/kehuduan/clashbox/#jiaocheng-harmonyos)里。

## 装好以后最常碰到的问题

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

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

## ClashBox 鸿蒙教程，查版本、侧载 HAP 到导入订阅

这份教程没有配截图，我们手上没有能跑 HarmonyOS 5 的华为设备。界面文字取自 ClashBox 1.7.4 源码里的中文资源，系统操作以华为官方文档为准。顺序是先查版本，再选商店或侧载，装好后导入订阅、启动，最后处理保活和证书到期。

1. **查软件版本，确认是不是纯血鸿蒙** 华为官网给的查看位置分两种。HarmonyOS 5 及以上，打开设置，点列表最上方的设备名称进入关于本机，看软件版本。HarmonyOS 4 及以下，设置里往下滑到关于手机，看 HarmonyOS 版本。显示 4.x 的手机还能装 APK，用安卓客户端就行。显示 5.0 以上的继续往下做，ClashBox 构建配置里写的最低兼容版本是 5.0.5(17)。
2. **能用海外区应用市场的，直接在商店里装** 项目成员说，想要长期有效的证书，唯一的途径是从华为海外应用市场安装，商店版已经更新到 2.x。大陆区应用市场里搜不到它，海外区要满足什么条件才能搜到，项目方没写，本站也没试过。能从商店装上的，跳过下面四步，直接看打开 ClashBox 导入订阅那一步，界面可能和 1.7.4 有出入。
3. **下载 1.7.4 的未签名 HAP，核对校验值** 到 GitHub 上 xiaobaigroup/ClashBox 的 Releases 页，1.7.4 只有一个附件 `ClashBox_LTS_V1_unsigned.hap`，107951762 字节，约 103 MB。GitHub 在附件旁给出了 SHA-256，开头是 9977a4b9，下载后可以在电脑上算一遍对照。unsigned 这个词说明它还没签过名，先留在电脑上，传到手机也装不了。
4. **在手机上打开开发者选项和无线调试** 开发者选项一般在设置的系统里。找不到的话，华为开发者文档给的办法是进设置里以设备名称命名的那一页，对着软件版本连点七次，直到屏幕提示开启开发者选项，点确认，再输一次锁屏 PIN，手机会自动重启。之后进开发者选项打开无线调试，页面上能看到本机 IP 和端口号。电脑和手机要在同一个 Wi-Fi 里。
5. **在电脑上装好 Auto-installer** ClashBox 的 README 推荐用 Auto-installer 签名安装，中文名 `小白调试助手`。从它的 GitHub 发布页下载 3 月发布的 3.1.0，Windows 和 Mac 各有一个 zip。Mac 首次运行前，按 README 在终端执行 `xattr -d com.apple.quarantine` 加程序路径。工具代码没有公开，还得登华为账号，有顾虑就回头走商店路线。
6. **登录华为账号，签名并把 HAP 装进手机** 工具仓库没有图文说明，只有一段演示视频，按钮叫什么本站没法核实，流程按 3.1 的更新说明来理解。它会保留账号登录状态，能自动把手机的无线调试端口设为 12345，启动时自动连接，然后给选中的 HAP 签名并装进手机。签名时电脑要走中国大陆的网络，开着代理的先关掉。装好后桌面会出现 ClashBox 图标。
7. **打开 ClashBox，从配置页导入订阅** 底栏的四个标签是主页、代理、配置和更多，先点配置，打开添加配置，选从URL(链接)导入。配置名随便起，订阅链接贴进输入链接那一栏，地址前面必须带着 http 或 https 协议头。自动更新和自动更新间隔按需设置。保存后应用开始下载配置，看到下载成功就好了。手上还没有订阅的，可以先看[机场推荐榜单](https://jichangtuijianweb.co/tuijian/)。
8. **切到代理页，测延迟后挑节点** 代理页按订阅里的策略组列出节点，点一个就是选中。页面上有测速延迟的按钮，测完每个节点会标出延迟，超时的别选。长按节点可以收藏，收藏的节点会出现在主页。主页上还能切换分流模式，平时用规则，按订阅里的规则分流，另外两档是全局和直连。
9. **回主页点启动，在系统弹窗里允许 VPN** 回主页按启动按钮。配置没加载成功时按下去只会弹一条提示，让你先导入配置。第一次连接前，华为开发者文档写明系统会先弹出 VPN 授权框，看清请求来自 ClashBox，再点同意。连接建立后，状态栏多出一个钥匙样子的 VPN 标志。鸿蒙一次只能挂一个 VPN，别的代理或加速器要先断开。
10. **在后台运行里选一种保活方式** 鸿蒙回收后台进程时，VPN 会跟着断。进更多页里的设置，打开后台运行，四个选项分别是模拟画中画、模拟定位、模拟下载、任务保持。手机上可以先试模拟画中画，README 说开了它还会启用核心恢复。平板和电脑，应用提示建议用任务保持。选模拟定位要给位置权限并保持定位开关打开，改完重启应用。这些选项都会让耗电变多。
11. **打开网页确认连通，再记下证书到期日** 打开一个平时要代理才能访问的网站，页面出来就算成功，也可以看主页那张 IP地址 卡片，出口换成节点所在地区才对。侧载装的要留意有效期，README 说自签名默认 14 天，开发者账号实名后能延长到 180 天。Auto-installer 3.1 有一键续期和日历提醒。设置里的备份与恢复能把数据存到下载目录的 ClashBox 文件夹，重装前先备份。

### 卡住了怎么办

- **安装时报错码 9568320** 华为 bm 工具的文档里，9568320 表示签名文件不存在，也就是 HAP 还没签名。hdc 和 DevEco Testing 只管安装，不会替你签，维护者也答复过 DevEco Testing 装不了没签名的 HAP。回到 Auto-installer 那一步，签名后再装。
- **安装报 9568297 或 9568332** 按华为 bm 工具文档，9568297 是设备 SDK 版本较低，系统低于 ClashBox 要求的 5.0.5(17)，先升级系统。9568332 是签名不一致，手机上已经有一个用别的证书签过的 ClashBox LTS，先备份配置，卸载旧的再装。
- **签名这一步一直失败** 先看网络，README 写明华为签名服务器屏蔽中国大陆以外的 IP，电脑开着代理也可能让请求走了境外出口。再看电脑时间，华为的自动签名文档要求本地时间和北京时间一致。Auto-installer 是从 2.5 之前的版本升级来的，按 2.5.0 的说明，在它的更多菜单里执行一次重置证书。
- **用了两周，打开提示应用过期** 按维护者在 issue 里的说法，这是调试证书到期，重新安装就行。Auto-installer 3.1 有一键续期功能，可以先试这个。想彻底摆脱到期，项目成员说长期证书只能来自华为海外应用市场。重装前先用备份与恢复导出数据，或者把订阅链接另存一份。
- **锁屏一会儿代理就断了** 应用内常见问题把原因归到系统严格的后台管理上，建议同时开启通知和模拟后台。掉线频繁的话，应用的特别提示推荐前台模式配合模拟后台，前台模式在设置的内核里切换，切完要重启 VPN 服务。1.4.7 的发布说明也写明，VPN 被回收是系统原因。
- **节点测速全部超时，或者比别的客户端少** 全部超时，应用内常见问题的解释是部分机场内置的 DNS 地址解析有问题，在覆写设置的 DNS 部分把覆写 DNS 打开，再重启 ClashBox。节点偏少，是部分机场对 ClashBox 的请求标识支持很少，把 `&flag=meta` 接在订阅地址末尾，重新导入。

## 常见问题

### ClashBox 和 ClashNEXT 是同一个软件吗

是同一个项目。2025 年上半年的几个测试版叫 ClashNEXT，5 月的 1.4.7 起发布页换成 ClashBox。7 月的 LTS 1.5.1 解释过，AppGallery 审核不让继续用 ClashNEXT 的名称和图标。更早的前身是 likuai2010 名下的 ClashMeta，已经永久停更。

### ClashBox 最低要哪个鸿蒙版本

master 分支里的 build-profile 文件把最低兼容版本写成 5.0.5(17)，目标版本 6.0.0(20)，发布说明没有单独交代。还在用 HarmonyOS 4 或更早版本的，系统照样能装 APK，用不着它，装 Clash Meta for Android 或 FlClash 更省事。

### GitHub 上的 ClashBox 1.7.4 和应用市场版有什么区别

GitHub 上只有 1.7.4 这一个 LTS 版本，2026 年 4 月 2 日发布，没签名，要自己签名侧载。项目成员在 issue 里说商店版 2026 年 5 月已经更新，8 月又提到 2.1.0 修好了一个问题，可见商店版已到 2.x。商店版只在海外区应用市场，本站没有核实过它的上架页面。

### ClashBox 导入订阅后节点比别的客户端少

应用内的常见问题解释过，部分机场对 ClashBox 的请求标识支持很少，办法是把 `&flag=meta` 接在订阅地址最后面，重新导入一次。它默认的 UA 是 clash.meta/1.19.5，覆写的基础设置里能改。节点测速全部超时的，常见问题建议打开覆写 DNS 后重启应用。

### ClashBox 能在控制中心放一个快捷开关吗

暂时不能。有用户在 issue 里提了这个建议，维护者 2026 年 9 月 11 日回复说系统暂未开放相关接口。开关代理还是要进应用里操作。