ClashBox 使用教程

发布日期: 2026-09-24更新日期: 2026-10-12平台: HarmonyOS NEXT(手机 / 平板 / 鸿蒙电脑)类别: 客户端下载配置

ClashBox 是 HarmonyOS NEXT(纯血鸿蒙)上的原生代理软件,前端使用鸿蒙原生语言 ArkTS 开发,内核采用改版的 Mihomo(Clash Meta),功能基本与 Mihomo 对齐。界面参考了 Surfboard 的排版,支持深色模式和模糊效果,并适配了手机、平板、折叠屏和鸿蒙电脑。

由于 HarmonyOS NEXT 不再兼容安卓 APK,ClashBox 是目前鸿蒙 NEXT 用户使用 Clash 订阅的主要选择之一。

开发语言ArkTS(鸿蒙原生)
代理内核改版 Mihomo(Clash Meta)
支持系统HarmonyOS NEXT
安装方式侧载(自签名)

本文只讲软件本身,不推荐具体服务商。客户端只是工具,节点需要另外订阅;如果还没有订阅,可以先看 性价比机场挑选与防坑指南。

官方项目地址:https://github.com/xiaobaigroup/ClashBox

侧载安装

ClashBox 未上架应用市场,需要侧载安装,官方推荐两种工具:

  • Auto-installer:开源的鸿蒙侧载工具,在电脑上连接手机后安装。
  • DevEco Testing:华为官方开发测试工具。

注意事项:

  • 华为签名服务器屏蔽了非中国大陆 IP,在海外签名时需要使用中国大陆 IP。
  • 自签名安装的应用默认只有 14 天 有效期,完成华为开发者实名认证后可延长到 180 天,到期后需重新签名安装。

导入订阅

  1. 复制机场的 Clash / Mihomo 订阅链接。
  2. 在 ClashBox 中添加订阅并更新,选择节点后启动,允许 VPN 权限。

防止后台被系统关闭

HarmonyOS NEXT 的后台调度较激进,代理进程可能被系统结束导致断网。ClashBox 内置了核心恢复功能:在设置中开启“后台运行 - 模拟画中画”后,系统杀掉进程时会自动恢复内核。

常见问题 (FAQ)

用了一段时间突然打不开了?

很可能是自签名到期(默认 14 天)。重新签名安装即可,完成开发者实名认证可延长到 180 天。

鸿蒙 4.x(非 NEXT)能用吗?

非 NEXT 版本仍兼容安卓应用,可以直接使用 FlClash 等安卓客户端。