HarmonyOS NEXT ClashBox Tutorial: Huawei Phone External App Market or Sideload
Prerequisites
- 鸿蒙 One device with latest OS version recommended
- Valid airport subscription link（支持 Clash/Surge/V2Ray 格式）
- 可访问 GitHub/官网下载安装包
Advanced Settings
手里的华为手机升级到 HarmonyOS NEXT 之后，很多人的第一反应是去装以前用惯的 Clash 或 v2rayNG，然后发现 APK 装不上，国内区应用市场也搜不到。原因在系统，鸿蒙 NEXT 把安卓运行层整个拿掉了。 HarmonyOS NEXT（HarmonyOS 5.0 及以上）的华为手机不能安装安卓 APK，所以装不了安卓版 Clash 和 v2rayNG。目前公开可用、我核对过的方案是 ClashBox （曾用名 ClashNEXT），一个基于 Mihomo（原 Clash Meta）内核的鸿蒙原生客户端。装法有两条。非大陆地区的华为账号 可以在海外区 AppGallery 直接安装；大陆账号 只能拿它在 GitHub 发布的未签名 HAP，在 Windows 或 macOS 电脑上用小白调试助手 （GitHub 项目名 Auto-installer）登录华为账号签名，再通过手机的无线调试侧载进去。装好后导入 Clash / Mihomo 格式订阅即可使用。侧载的签名证书默认 14 天有效，完成华为开发者实名后延长到 180 天，到期要回电脑续期。 鸿蒙 NEXT 上没有传统的 VPN App 可装，能用的是 ClashBox 这类代理客户端，它通过系统的 VPN 接口接管流量，所以后面会看到「允许 VPN」的弹窗。走侧载路线的成本是一台电脑、大约半小时，以及每 14 天（实名后 180 天）回电脑续一次证书。 上面那段有四个词得先解释清楚，后面全靠它们。
- HAP （HarmonyOS Ability Package）是鸿蒙的应用安装包格式，相当于安卓的 APK
- 签名 是给安装包盖一个华为认可的章。鸿蒙 NEXT 只允许安装带有效签名的 HAP，ClashBox 发布的是未签名 版本，所以要先用你的华为账号申请一张调试证书 给它盖章
- 侧载 就是不经过华为应用市场，通过开发者调试通道把 HAP 装进手机
- Mihomo 是 Clash 内核的后续版本（原名 Clash Meta），你以前在安卓 Clash 里用过的订阅它照样能读
这篇把整条路走完，从下载文件到后台保活，中间每一个会卡住的地方都标出来，最容易让人放弃的两处（华为账号授权、证书 14 天）单独说透。
来源说明 。步骤按 ClashBox、Auto-installer 项目发布页与华为开发者文档整理，版本号、文件校验值和文档链接均于 2026 年 9 月 14 日逐项核对。软件版本、按钮名称和证书规则以后可能变化，操作时请同时看项目发布页。配图是示意图，不是真机截图，真机截图后续补上。
先分清你的华为手机是哪一代系统
华为手机能不能用 VPN，取决于系统是哪一代。 HarmonyOS 4 及更早版本（包括 EMUI）底层仍是安卓，可以直接安装安卓版 Clash、v2rayNG、sing-box 等客户端，不需要本文的流程。HarmonyOS NEXT（HarmonyOS 5.0 起）去掉了安卓运行层，只能安装鸿蒙原生 HAP 应用；系统保留了 VPN 通道（后文第五步会看到系统弹出的 VPN 连接请求），国内区应用市场里没有代理客户端，所以要么用非大陆地区的华为账号从海外区 AppGallery 装 ClashBox，要么把它签名后侧载。 查看方法是进设置 → 关于本机 → 「HarmonyOS 版本」。显示 5.x 就是 NEXT，按本文走；显示 4.x 及以下，去[教程中心](https://jichangtuijian
Troubleshooting
cn.co/tutorials/)找安卓客户端的教程即可。
路线一，外区 AppGallery 直接安装（不用电脑、不用续期）
ClashBox 项目在 1.4.7 的发布说明里写明「此应用已经上架鸿蒙海外市场」。如果你有非大陆地区的华为账号 （比如港区），在手机上切换到该账号登录后，直接在 AppGallery 搜索 ClashBox 安装即可，不需要电脑、不需要签名、没有 14 天证书的事，之后的导入订阅、允许 VPN、后台保活与本文第四到第六步相同。 有三点要知道。一是切换系统登录的华为账号会影响云空间、支付等华为服务，换回去要重新登录；二是公开反馈称港区账号可以用大陆手机号注册，本站尚未验证，以华为当时的注册页面为准；三是商店版与 GitHub 上的 LTS 版本号可能不同，功能以商店版为准。没有外区账号、也不想折腾账号的，走下面的路线二。
路线二，大陆账号签名侧载的整条流程
七个环节按下面的顺序走。
- 电脑下载小白调试助手 3.1.0（
hap_installer-Windows-3.1.0.zip）和 ClashBox LTS 1.7.4 未签名包（ClashBox_LTS_V1_unsigned.hap），核对 SHA-256 - 手机开开发者模式、USB 调试和无线调试，记下
IP:端口 - 在小白调试助手里登录华为账号 → 连接设备 → 选择安装包 → 开始调试；手机桌面出现 ClashBox 图标即安装完成
- 在 ClashBox 里进配置 → 添加配置 → 从 URL 导入 Clash / Mihomo 订阅
- 模式选「规则」，代理页选节点，主页启动，系统弹窗允许 ClashBox 建立 VPN
- 后台运行里Open「模拟画中画」，有「内核前台模式」的版本一并Open
- 证书到期前（默认 14 天，实名后 180 天）回小白调试助手续期
拆开说就是三个角色。
- ClashBox 是装到手机上的客户端，读订阅、接管系统 VPN
- 小白调试助手 跑在电脑上，用你的华为账号申请调试证书（华为发给「这个账号 + 这台手机」的一张临时通行证，凭它签过名的应用才能装）、给 HAP 签名、把签好的包装进手机
- 订阅 是机场提供的 Clash / Mihomo 格式链接，没有它 ClashBox 只是个空壳
下载校验、开调试、签名安装这三步要手机和电脑放在一起做一次，之后导入订阅、启动、保活都在手机上完成；证书到期时再回电脑续一次期。
准备清单
- 一台 HarmonyOS 5.0 或更高版本（也就是 NEXT，设置 → 关于本机能看到）的华为手机或平板
- 一台 Windows 10 / 11 电脑（小白调试助手也有 macOS 版，本文按 Windows 写）
- 一根能传数据的 USB 线，原装线最省事
- 一个正常使用的华为账号（下面会讲它用来做什么）
- 电脑上留几 GB 空余空间放安装包、解压文件和备份（两个文件加起来约 190MB，解压和备份还要再占一些）
- 一条 Clash 或 Mihomo 格式的订阅。你以前在 Clash for Android 里粘过的那条一般就是 Clash 格式，可以直接用 ；还没有的往下看，第四步会讲从哪拿
手机电量保持 60% 以上，过程中不要关机，也不要切换华为账号。公司电脑如果限制装软件或 USB 调试，换自己的电脑做。
动手前要接受的两个事实
第一，小白调试助手是社区工具，不是华为官方的，而且它要登录你的华为账号。 先说它为什么要账号。鸿蒙规定侧载的应用必须由某个华为账号签名，这本来是华为给开发者调试用的官方流程，助手只是替你把网页上要手动点的那一套自动跑完。登录本身发生在华为自己的网页 上，密码不会输进助手界面，助手拿到的是华为发给它的一个签名授权，不是你的密码。从机制上看签名账号不必是手机上登录的那个，如果不放心，用一个不绑支付、不绑云备份的备用华为账号更稳妥。工具如果提示要求一致，以它的提示为准。 它的仓库公开了说明和安装包，但没有可以完整审计的安装器源码。能做的防护就三条，分别是只从 GitHub 发布页下载、下载后核对校验值（文件的指纹，用来确认下到的包没被换过）、不把它生成的证书目录发给任何人。接受不了这个信任范围，就先别装，等官方商店分发或可信的已签名包。 第二，证书有有效期，这是鸿蒙侧载机制本身的规则，不是 bug。 ClashBox 项目说明，自签名侧载应用默认 14 天有效。不做实名就是 14 天一续；在华为开发者网站完成开发者实名认证（提交身份证信息，具体材料以当时页面为准）可以延长到 180 天。实名不是必须的，只是少续几次。 续期要做的就是临时开回无线调试，用助手连上手机，在证书页点续期，几分钟的事，一般不用重装，ClashBox 里的订阅和设置照旧。到期后应用会打不开，但不会丢东西，续完就能开。装之前把这个心理预期定好，后面就不会觉得被坑。
第一步：下载两个文件并核对校验值
本文核对的版本是小白调试助手 3.1.0 和 ClashBox LTS 1.7.4 （LTS 是长期支持版，比普通版稳定），两个都是项目当时的最新发布。版本更新以后先看发布说明，再决定要不要换文件。
| 文件 | 官方发布页 | SHA-256 |
|---|---|---|
小白调试助手 Windows 3.1.0 hap_installer-Windows-3.1.0.zip |
likuai2010/auto-installer | d1d5f1198ee92427ff97a88ada078adb3353121ede261fdcf1e4350c88c18fbf |
ClashBox LTS 1.7.4 ClashBox_LTS_V1_unsigned.hap |
xiaobaigroup/ClashBox | `9977a4b9e40c96e2fcb7831340f43829a25f95c5aa |
Screenshots (from the public tutorial on jichangtuijiancn.co; UI may differ by app version)
Fig. 1: 鸿蒙 NEXT 安装 ClashBox 的七个环节，依次是下载、校验、开调试、签名安装、导入订阅、允许 VPN、后台保活
Fig. 2: 华为手机开启开发者模式、无线调试，并把 IP 和端口交给电脑端小白调试助手的示意图
Fig. 3: ClashBox 导入订阅的四步，依次是打开配置、添加配置、从 URL 导入粘贴链接、保存并选中，代理页出现节点就算成功
Fig. 4: ClashBox 规则模式、代理页选节点、主页启动、允许华为 VPN 请求、开启后台保活的顺序示意图
Related Resources
- 检测IP纯净度：ippure.com
- 免费节点：downloadnth、freesocks、openrung
- 专线搭建方案：2026中国大陆专线建设方案
- 美国静态住宅IP的VPN推荐：thank.my.id
- 带静态住宅的机场：
https://JTMRHF.快车.com（复制Paste到浏览器Open）或者 https://jtmrhf.xn--66tw07h.com - 带静态住宅IP的VPS（独立站+线路搭建）：lisahost
- 极速VPN：vpn07
FAQ
Q: ClashBox 怎么导入机场订阅？
A: 在配置界面选择「从 URL 下载」或「托管配置」，粘贴订阅链接即可。
Q: 导入后无节点怎么办？
A: 检查订阅链接是否有效、网络是否通达、客户端版本是否过旧。
Q: 怎么切换代理模式？
A: 进入「配置」或「策略组」，选择「规则模式」或「全局模式」后重启代理。
Q: 连不上网如何排查？
A: 依次查：订阅有效性、节点延迟、本地网络、杀毒软件拦截、系统代理冲突。