1. 首页
  2. 机场客户端下载与教程
  3. ClashBox教程
纳兰迦 · 机场客户端下载与教程

ClashBox下载与使用教程

鸿蒙原生的代理客户端,mihomo 内核,给纯血鸿蒙手机和平板用

  • 核对到的版本 1.7.4
  • 核对日期 2026-09-09
  • 内核 mihomo
  • 源码不完整
  • 价格 免费

ClashBox官方下载入口

系统入口说明
鸿蒙 HarmonyOS NEXT官方仓库发布页仓库 Releases 入口(最新发布 1.7.4,2026-04-02);未核验具体二进制签名

本站不提供安装包,上面的入口都指向官方仓库或官方商店。仓库声明许可证 GPL-3.0(GitHub 元数据,2026-09-09 读取);目录标注“前端开源,构建不可复现”。

ClashBox 是给 HarmonyOS NEXT 写的代理客户端,也就是 HarmonyOS 5 及以上、装不了安卓 apk 的那一代鸿蒙。仓库在 GitHub 的 xiaobaigroup/ClashBox,README 自称“首个基于Navigation框架的HarmonyOS NEXT平台的代理软件”,内核是改版的 mihomo,界面用鸿蒙的 ArkTS 写。维护它的团队在应用里署名小白工坊。它早先叫 ClashNEXT,1.5.1 的发布说明提到因为应用市场审核,只能弃用这个名字和图标。本站 68 个客户端的目录里,平台写着 HarmonyOS NEXT 的只有它。

开源情况我分开交代。仓库声明的许可证是 GPL-3.0,本站目录的标注是“前端开源,构建不可复现”,页头显示成源码不完整。仓库自己有两种说法。默认的 main 分支只放了 README、许可证和隐私政策,README 写“本项目的大部分代码均已开源”,让人去 master 分支看,可 master 分支的 README 写的是“本仓库仅包含前端部分,改版的后端部分暂不开源”。两句话对不上。我没法替它裁定。发布页给的 hap 没有签名,目录的备注是未核验具体二进制签名。在意这一点的人,读完这一段再决定装不装。

版本有两条线。目录核对到的是 1.7.4,核对日期 2026-09-09,对应仓库发布页 2026 年 4 月 2 日的 ClashBox LTS (V1)。华为应用市场上的版本更新,我在 2026 年 11 月 19 日看到的是 2.1.0。协作者 11 月 14 日在 Issue 里说,仓库的 LTS 版暂定一年同步一次。两条线怎么装、各有什么门槛,写在鸿蒙怎么用机场里。

它适合手里只有纯血鸿蒙设备、机场又给 Clash 格式订阅的人。坑有两个。鸿蒙的后台管得严,README 自己写了进程可能被系统关掉。2026 年 11 月 1 日有人报告鸿蒙 7 上 1.7.4 所有节点超时,这条 Issue 到 11 月 19 日没人回复。HarmonyOS 4 及更早的手机用不着它,照 FlClash 的安卓教程走,别的系统该装哪个,到机场客户端下载与教程里按系统找。

鸿蒙上怎么装 ClashBox

这一节没有截图。按钮名字取自仓库 master 分支的界面文字,那份代码最后一次提交是 2026 年 8 月 15 日,市场版 2.1.0 的界面可能有出入。系统弹窗的说法来自华为开发者文档的连接 VPN一篇。

  1. 装应用。应用市场里搜得到 ClashBox 的直接安装。搜不到的走侧载,在电脑上下载发布页的 ClashBox_LTS_V1_unsigned.hap,用小白调试助手签名后装进手机。
  2. 第一次打开,读完用户协议点“同意并继续”。接着是欢迎页,点“进入引导”看新手提示,点“我是老手啦”跳过。
  3. 去机场后台复制订阅链接。回到 ClashBox,底部切到“配置”,点加号,在“添加配置”里选“从URL(链接)导入”。
  4. “配置名”自己起一个,URL 一栏粘贴订阅链接。点保存图标,等“正在下载配置文件”结束,弹出“下载成功”就是导入好了。报错的话提示以“下载失败”开头。
  5. 回到配置列表,点一下刚加的这份,把它设成当前配置。长按它可以编辑、更新和删除。
  6. 切到“代理”页,节点列表出来以后点一个节点。页面上有个按钮可以一次测完所有节点的延迟。
  7. 回“主页”点启动按钮。配置没加载好的时候点它,会提示“请检查配置文件是否导入,代理节点是否加载”。
  8. 第一次启动,系统弹出 VPN 连接授权对话框,问你是否信任这个应用,选同意。连上以后状态栏出现钥匙图标。
  9. 主页的“分流模式”有规则、全局、直连三项,日常用规则,区别见规则模式和全局模式。
  10. 不用的时候再点一次主页的按钮。

想让它在后台待得住,去“更多”里的“设置”,打开“后台运行”。README 说开了其中的“模拟画中画”,被系统杀掉的内核会自动恢复。应用自带的提示写着,开了以后更费电,平板和电脑建议改用“任务保持”。

下载和官方仓库

本站不提供安装包,官方入口有三个。

发布页给这个 hap 标的校验值是 sha256:9977a4b9e40c96e2fcb7831340f43829a25f95c5aa5ffe7addb811992cfdfd0e,下载后可以对一下。网盘和群文件里别人签好名的包,签名是谁的、内容改没改过都查不了,我不建议装。版本号以官方发布页和应用市场为准。

常见问题

ClashBox 是开源的吗

只能说部分开源。仓库声明的许可证是 GPL-3.0,本站目录标注“前端开源,构建不可复现”。仓库两个分支的 README 说法不一,一处写大部分代码已开源,一处写后端暂不开源。

ClashBox 导入订阅后节点变少或者是空的怎么办

先在订阅链接后面加上 &flag=meta 再导入。这是应用内置常见问题给的办法,它的解释是部分服务商不认 ClashBox 的 UA。导入后还是空的,它建议多试几次,或者把订阅转成 Clash 格式再导入,转换的风险见订阅转换是什么。

ClashBox 节点全部超时怎么办

到“更多”的“覆写”里,把“覆写DNS”和它下面的“状态”都打开,然后重启应用。应用内置的常见问题和协作者在 Issue #146 里给的是同一个办法。鸿蒙 7 上的 1.7.4 另有一条超时报告,编号 #178,到 11 月 19 日没人回复,这个办法管不管用我没能确认。

ClashBox 用一会儿就断线怎么办

打开应用的通知,再打开“后台运行”里的模拟后台功能。应用内置的常见问题说,原因是系统的后台管理很严。经常掉线的,它建议把内核切到前台模式,配合模拟后台一起用。

TO BE CONTINUED下一个客户端 OpenClash教程