ClashBox 鸿蒙 教程：鸿蒙 NEXT 怎么安装 Clash？华为手机 ClashBox 外区应用市场或签名侧载教程（附截图）

手里的华为手机升级到 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 天）回电脑续一次证书。

上面那段有四个词得先解释清楚，后面全靠它们。

这篇把整条路走完，从下载文件到后台保活，中间每一个会卡住的地方都标出来，最容易让人放弃的两处（华为账号授权、证书 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

cn.co/tutorials/)找安卓客户端的教程即可。

ClashBox 项目在 1.4.7 的发布说明里写明「此应用已经上架鸿蒙海外市场」。如果你有非大陆地区的华为账号 （比如港区），在手机上切换到该账号登录后，直接在 AppGallery 搜索 ClashBox 安装即可，不需要电脑、不需要签名、没有 14 天证书的事，之后的导入订阅、允许 VPN、后台保活与本文第四到第六步相同。

有三点要知道。一是切换系统登录的华为账号会影响云空间、支付等华为服务，换回去要重新登录；二是公开反馈称港区账号可以用大陆手机号注册，本站尚未验证，以华为当时的注册页面为准；三是商店版与 GitHub 上的 LTS 版本号可能不同，功能以商店版为准。没有外区账号、也不想折腾账号的，走下面的路线二。

七个环节按下面的顺序走。

拆开说就是三个角色。

下载校验、开调试、签名安装这三步要手机和电脑放在一起做一次，之后导入订阅、启动、保活都在手机上完成；证书到期时再回电脑续一次期。

手机电量保持 60% 以上，过程中不要关机，也不要切换华为账号。公司电脑如果限制装软件或 USB 调试，换自己的电脑做。

第一，小白调试助手是社区工具，不是华为官方的，而且它要登录你的华为账号。

先说它为什么要账号。鸿蒙规定侧载的应用必须由某个华为账号签名，这本来是华为给开发者调试用的官方流程，助手只是替你把网页上要手动点的那一套自动跑完。登录本身发生在华为自己的网页 上，密码不会输进助手界面，助手拿到的是华为发给它的一个签名授权，不是你的密码。从机制上看签名账号不必是手机上登录的那个，如果不放心，用一个不绑支付、不绑云备份的备用华为账号更稳妥。工具如果提示要求一致，以它的提示为准。

它的仓库公开了说明和安装包，但没有可以完整审计的安装器源码。能做的防护就三条，分别是只从 GitHub 发布页下载、下载后核对校验值（文件的指纹，用来确认下到的包没被换过）、不把它生成的证书目录发给任何人。接受不了这个信任范围，就先别装，等官方商店分发或可信的已签名包。

第二，证书有有效期，这是鸿蒙侧载机制本身的规则，不是 bug。

ClashBox 项目说明，自签名侧载应用默认 14 天有效。不做实名就是 14 天一续；在华为开发者网站完成 开发者实名认证 （提交身份证信息，具体材料以当时页面为准）可以延长到 180 天。实名不是必须的，只是少续几次。

续期要做的就是临时开回无线调试，用助手连上手机，在证书页点续期，几分钟的事，一般不用重装，ClashBox 里的订阅和设置照旧。到期后应用会打不开，但不会丢东西，续完就能开。装之前把这个心理预期定好，后面就不会觉得被坑。

本文核对的版本是小白调试助手 3.1.0 和 ClashBox LTS 1.7.4 （LTS 是长期支持版，比普通版稳定），两个都是项目当时的最新发布。版本更新以后先看发布说明，再决定要不要换文件。

| ClashBox LTS 1.7.4 ClashBox_LTS_V1_unsigned.hap | xiaobaigroup/ClashBox | `9977a4b9e40c96e2fcb7831340f43829a25f95c5aa

开发者模式：进设置 → 关于本机 → 找到「软件版本」连点 7 次 → 按提示输入锁屏密码，要求重启就重启；之后在设置 → 系统里能看到「开发者选项」（找不到就在设置顶部搜索框搜）。

USB 调试：进开发者选项打开「USB 调试」，用数据线连电脑，手机弹出信任提示时选信任（自用电脑可勾「始终允许」）。注意手机显示正在充电不等于数据连接成功；电脑没有任何设备提示时先换线、换 USB 口，别经过扩展坞。

无线调试（主流程用它）：手机和电脑连同一个 Wi-Fi，开发者选项 →「无线调试」→ 记下页面显示的地址，格式类似 192.168.1.23:45678。IP 和端口都要，只复制 IP 会连接失败；锁屏、换 Wi-Fi、重开无线调试之后端口会变，要回来重新看。

先做一件事：电脑上如果开着代理，签名前先关掉或切直连。ClashBox 的 README 明确写了「华为的签名服务器屏蔽了非中国大陆的 IP 地址」，而看这篇的人电脑上多半开着代理，这是签名失败最常见的原因之一。人在海外则反过来，要先用大陆 IP。

双击 Release\hap_installer.exe，点「登录账号」：浏览器会打开华为账号授权页，地址栏域名应以 huawei.com 结尾，密码是在华为的页面上输、不是在助手里输；点允许后回到助手，界面上显示了账号信息才算登录成功。点「连接设备」，填无线调试页面的 IP 和端口（部分版本可以直接粘贴 IP:端口），手机弹出调试授权时选始终允许；界面显示「无线连接」和手机地址才算连上，没连上就别往下点。点「选择安装包」，选 ClashBox_LTS_V1_unsigned.hap，确认路径显示正确。点「开始调试」（不同版本可能叫安装），等签名、传输、安装几个阶段依次完成，通常几分钟以内；超过五分钟没动静就看助手的报错，不要反复点。手机再弹确认就允许。工具显示全部成功后回手机桌面，出现 ClashBox 图标就是装好了；先打开一次确认能进主页，再去弄订阅。

过程中不要关无线调试、切 Wi-Fi、锁屏，插着线的话也别拔。装好以后 USB 调试和无线调试可以关掉（续期或重装时再临时开）；开发者模式先留着——助手的说明提到部分调试安装的应用依赖它，关了如果 ClashBox 打不开就再开回来。

登录时浏览器不弹授权页：先确认电脑时间正确、默认浏览器能正常打开华为开发者网站，然后关掉助手和浏览器重开一次。还是只跳到官网首页的话，不要反复输密码，停下来去项目 Issues 看有没有同样的反馈。这时可以用下面的 DevEco Testing 路径确认手机和电脑至少是连通的。

DevEco Testing 是华为官方测试工具（ClashBox 的 README 把它和 Auto-installer 并列为两种安装方式；本文没有验证它的自动签名流程）：这里只用它附带的 hdc 命令判断真机连接、以及安装你已经签好名的包——直接 hdc install 未签名的 HAP 会报错，它不是绕过签名的办法。装好后在安装目录里搜 hdc.exe（不同版本子目录会变，别照抄陌生教程的固定路径），把它所在文件夹加入 PATH 或直接在那个文件夹打开终端：

看到一串设备编号就是连上了；显示 Unauthorized 就解锁手机接受信任提示，列表为空就换线、换口、重开 USB 调试。安装出现 install bundle successfully 再去桌面找图标。无线也可以（先 hdc tconn 手机IP:端口 看到 Connect OK 再装），不过华为文档自己也说无线稳定性差，第一次优先用 USB。

在 ClashBox 里进「配置 → 添加配置 → 从 URL 导入」，粘贴 Clash / Mihomo 格式订阅。导入后没节点，多数是链接没复制完整或格式不对：回手机浏览器重新登录用户中心复制，或让服务商明确给 Clash / Mihomo 格式；导入时临时关掉自动更新再试。

模式选「规则」（流量按订阅里的规则分流：国内直连、国外走代理；全局模式只适合短时排查）。代理页打开主策略组，选一个近的、延迟正常的节点，第一次别同时改别的设置。回主页点「启动」，鸿蒙弹出 VPN 连接请求时核对应用名是 ClashBox，点允许。状态栏出现 VPN 标志、主页显示已连接、浏览器能打开一个平时打不开的网站——三个都满足才算跑通；规则模式下百度能开不代表代理通了。只有 VPN 图标却打不开网页，先回代理页换节点，不要立刻重装。

鸿蒙会回收后台 VPN 进程，表现就是「连上几分钟自己断了」。在 ClashBox →「更多 / 设置」→「后台运行」里：打开「模拟画中画」（打开后屏幕上可能出现一个小窗或常驻提示，那是保活用的，不要手动关掉它），有「内核前台模式」的版本一并打开，然后按提示重启核心或重开应用。之后手机重启、系统升级、强制停止或一键清理后台，都要重新打开 ClashBox 看一眼状态。

平时用起来就是三件事：配置页更新订阅、代理页选节点、主页看状态。升级 ClashBox 没有商店更新，等于下载新版 HAP、回到第三步用助手重新签名安装一次；动手前先备份配置和订阅名——新版本要求卸载旧版的话，卸载会清掉本地设置（订阅链接在服务商后台还能重新拿，自己写过的覆写规则要单独导出）。证书续期要在到期前临时开回无线调试，按第三步连上手机，在证书或应用管理页看 ClashBox 的到期时间并点续期，一般不用重装、配置不丢；备份丢了、换了账号、证书已经失效，就得重新签名安装。别为了一个普通连接错误去点「重置证书」，那会影响后续续期。装完客户端别忘了做一次 DNS 泄漏检测——鸿蒙上的 ClashBox 和其他 Clash 系客户端一样，靠 fake-ip 模式把域名查询留在隧道里。

*图 1：鸿蒙 NEXT 安装 ClashBox 的七个环节，依次是下载、校验、开调试、签名安装、导入订阅、允许 VPN、后台保活*

*图 2：华为手机开启开发者模式、无线调试，并把 IP 和端口交给电脑端小白调试助手的示意图*

*图 3：ClashBox 导入订阅的四步，依次是打开配置、添加配置、从 URL 导入粘贴链接、保存并选中，代理页出现节点就算成功*

*图 4：ClashBox 规则模式、代理页选节点、主页启动、允许华为 VPN 请求、开启后台保活的顺序示意图*