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

手里的华为手机升级到 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 及以下，去教程中心找安卓客户端的教程即可。

路线一，外区 AppGallery 直接安装（不用电脑、不用续期）

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

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

路线二，大陆账号签名侧载的整条流程

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

1. 电脑下载小白调试助手 3.1.0（hap_installer-Windows-3.1.0.zip）和 ClashBox LTS 1.7.4 未签名包（ClashBox_LTS_V1_unsigned.hap），核对 SHA-256
2. 手机开开发者模式、USB 调试和无线调试，记下 IP:端口
3. 在小白调试助手里登录华为账号 → 连接设备 → 选择安装包 → 开始调试；手机桌面出现 ClashBox 图标即安装完成
4. 在 ClashBox 里进配置 → 添加配置 → 从 URL 导入 Clash / Mihomo 订阅
5. 模式选「规则」，代理页选节点，主页启动，系统弹窗允许 ClashBox 建立 VPN
6. 后台运行里打开「模拟画中画」，有「内核前台模式」的版本一并打开
7. 证书到期前（默认 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 是长期支持版，比普通版稳定），两个都是项目当时的最新发布。版本更新以后先看发布说明，再决定要不要换文件。

表里的校验值取自 GitHub 发布页上每个文件旁边的 Digest 字段（2026-09-14 核对）。ClashBox 的文件名里没有 1.7.4 这个版本号，认发布页标题就行。

GitHub 直连打不开的话，可以在文件下载地址前面加公共加速前缀，例如把 https://github.com/xiaobaigroup/ClashBox/releases/download/1.7.4/ClashBox_LTS_V1_unsigned.hap 改成 https://ghfast.top/https://github.com/xiaobaigroup/…（前缀加在文件地址前，不是发布页地址前）。加速站是第三方转发，只解决下载速度，所以下载完必须核对校验值。

把两个文件放进 C:\HarmonyOS\，在这个文件夹空白处按住 Shift 点右键，选「在终端中打开」，分别运行下面两条命令。

Get-FileHash -Algorithm SHA256 ".\hap_installer-Windows-3.1.0.zip"
Get-FileHash -Algorithm SHA256 ".\ClashBox_LTS_V1_unsigned.hap"

输出有 Algorithm、Hash、Path 三列，只看 Hash 那一列的 64 位字符，必须和上表完全一致，大小写不影响。差一个字符就删掉重下，改走 GitHub 官方地址。

然后在 C:\HarmonyOS\ 里新建 AutoInstaller 文件夹，把 ZIP 完整解压进去，解压完应能看到 Release\hap_installer.exe。路径和文件名保持英文、数字、无空格，HAP 文件名就留 ClashBox_LTS_V1_unsigned.hap。中文用户名、括号和过长路径都可能让签名工具出错。

第一次双击 hap_installer.exe，Windows 很可能弹「Windows 已保护你的电脑」。这是因为程序没有微软的数字签名，和本文说的华为签名是两回事。校验值对上了就点「更多信息 → 仍要运行」；校验值没对上就不要点。

有个容易踩的旧坑。项目 README 里还留着「首次启动可能要装 Java」的老说明，但按 2.5.0 的发布说明，签名算法已经用 Go 重写、不再需要 Java 环境。用 3.1.0 时不要提前去装来路不明的 Java，双击程序能看到主界面就直接往下走；只有程序明确提示缺运行环境时，再从对应官方站点安装。

第二步：手机开调试

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

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

无线调试。主流程用无线调试连接，数据线在这一步只负责供电和作为无线连不上时的备用排查手段，USB 调试可以先开着不用。手机和电脑连同一个 Wi-Fi，开发者选项 → 「无线调试」→ 记下页面显示的地址，格式类似 192.168.1.23:45678。IP 和端口都要，只复制 IP 会连接失败。锁屏、换 Wi-Fi、重开无线调试之后端口会变，要回来重新看。

第三步：用小白调试助手给 HAP 签名并侧载

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

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

过程中不要关无线调试、切 Wi-Fi、锁屏，插着线的话也别拔。

装好以后 USB 调试和无线调试可以关掉，续期或重装时再临时开；开发者模式先留着，助手的说明提到部分调试安装的应用依赖它，关了如果 ClashBox 打不开就再开回来。用过别人的电脑做这一步的话，记得在开发者选项里撤销那台电脑的授权。

备份别删。 小白调试助手 3.1 会在电脑的下载文件夹（C:\Users\你的用户名\Downloads\小白调试助手）建账号文件和备份，到期续期就靠它。里面是签名证书和授权信息，不是你的密码，但拿到它的人能冒用你的签名身份。不要删、不要传网盘、不要截图分享。进工具的证书或应用管理页看一眼 ClashBox 的到期时间，给自己加个日历提醒。

登录时浏览器不弹授权页

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

备选路径，DevEco Testing 和 hdc

第三步已经装好的，直接跳到第四步。这一节只给无线连不上、想确认硬件连接的人看。

DevEco Testing 是华为官方测试工具，ClashBox 的 README 把它和 Auto-installer 并列为两种安装方式。本文没有验证它的自动签名流程，这里只用它附带的 hdc 命令判断真机连接、以及安装你已经签好名的包。直接 hdc install 未签名的 HAP 会报错，它不是绕过签名的办法。华为官方页面给它的推荐配置相当高，普通笔记本多半不够格，够不着就别硬装，前面的轻量路径够用。

装好后在安装目录里搜 hdc.exe（不同版本子目录会变，别照抄陌生教程的固定路径），把它所在文件夹加入 PATH 或直接在那个文件夹打开终端，运行下面这条命令。

hdc list targets

看到一串设备编号就是连上了。显示 Unauthorized 就解锁手机接受信任提示；列表为空就换线、换口、重开 USB 调试。有签名包时这样安装。

hdc install "C:\HarmonyOS\ClashBox_signed.hap"

出现 install bundle successfully 再去桌面找图标。无线也行，先 hdc tconn 手机IP:端口 看到 Connect OK 再装，不过华为文档自己也说无线稳定性差，第一次优先用 USB。

第四步：拿到订阅并导入

ClashBox 装好只是个空客户端，要有一条 Clash 或 Mihomo 格式的订阅才会出现节点。

订阅从哪来？ 任何提供 Clash / Mihomo 格式订阅的机场都行。这是最通用的格式，多数机场用户面板里直接能复制，你以前在安卓 Clash 里用的那条通常就是。想先零成本验证 ClashBox 能不能跑通，可以先拿每日免费节点那页的 Clash 订阅导入试一次，通了再考虑买。挑机场的方法在机场推荐，第一次建议先月付测试。

下面这段含星岛梦的推广入口（页首已有推广披露）。星岛梦与 ClashBox、Auto-installer 和华为没有任何关系，你用哪家机场都不影响本文的安装步骤。

我自己长期用的是星岛梦（测速、解锁、拓扑和客服的实测都在评测里）。它在鸿蒙上有个缺点要先说。官网不放订阅复制入口（评测里客服称这是临时策略），要从官网入口登录后打开在线客服、说明用 ClashBox 才给可导入的链接，比其他机场多一步。截至 2026 年 8 月客服确认可以提供，我尚未在 ClashBox 里实际导入验证。

拿订阅时直接用手机浏览器登录服务商的用户中心，在手机上复制，比从电脑传过来省事。订阅链接里带着你的账户身份，等同于账号密码，别发给陌生人，截图时遮住，泄露了立刻让客服重置。

1. 打开 ClashBox，进「配置」
2. 点右上角「+」或「添加配置」，选「从 URL 导入」
3. 起个好认的名字，把完整订阅粘进 URL 框，打开自动更新
4. 保存，回到配置列表点选它

成功的标志只有一个，就是代理页出现节点和策略组（安卓 Clash 里叫代理组，一回事）。只有配置名没有节点，多半是格式不兼容或链接没复制完整，找服务商确认 Clash / Mihomo 格式，不要把链接丢到网上那些「订阅转换站」。

第五步：选节点、允许 VPN

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

只有 VPN 图标却打不开网页，先回代理页换节点，不要立刻重装。

第六步：后台保活

鸿蒙会回收后台 VPN 进程，表现就是「连上几分钟自己断了」。ClashBox 为此做了核心恢复和模拟画中画，按下面的步骤设置。

1. ClashBox → 更多 / 设置 → 「后台运行」
2. 打开「模拟画中画」。打开后屏幕上可能出现一个小窗或常驻提示，那是保活用的，不要手动关掉它
3. 有「内核前台模式」的版本一并打开
4. 按提示重启核心或重开应用

项目说明称打开模拟画中画后会自动启用核心恢复。之后手机重启、系统升级、强制停止或一键清理后台，都要重新打开 ClashBox 看一眼状态。

没装过卓易通、出境易（鸿蒙 NEXT 上运行安卓应用的容器）的，可以跳过这段。如果只是容器里的应用连不上网，去「复写 → 网络」试试兼容模式，然后完全退出重开 ClashBox。普通浏览器已经能用时别先开它，那是针对特定场景的排查开关。

日常使用

平时用起来就是配置页更新订阅、代理页选节点、主页启动看状态这三件事。

升级 ClashBox 没有商店更新，等于下载新版 HAP，回到第三步用助手重新签名安装一次。动手前先备份配置和订阅名。新版本要求卸载旧版的话，卸载会清掉本地设置，订阅链接在服务商后台还能重新拿，自己写过的覆写规则要单独导出。

证书续期要在到期前临时开回无线调试，按第三步 1 至 2 条连上手机，在证书或应用管理页看 ClashBox 的到期时间并点续期，一般不用重装、配置不丢。原备份丢了、换了账号、证书已经失效，就得重新签名安装，操作前先保存订阅和自定义配置。别为了一个普通连接错误去点「重置证书」，那会影响后续续期。

装完客户端别忘了做一次 DNS 泄漏检测，鸿蒙上的 ClashBox 和其他 Clash 系客户端一样，靠 fake-ip 模式把域名查询留在隧道里。

按现象排查

官方项目与参考

• ClashBox · GitHub（发布页、Issues 都在这里）
• Auto-installer（小白调试助手）· GitHub
• Mihomo 内核 · GitHub
• 开启开发者模式 · 华为开发者文档
• hdc 工具 · 华为开发者文档

不确定自己该用哪个客户端见客户端怎么选；其他平台的教程在教程中心，官方安装包入口在客户端下载页。发现步骤过时请反馈，我核对后更新。