ClashBox 鸿蒙教程:原生侧载与签名续期要点
纯血鸿蒙安装 ClashBox 并导入订阅:通过电脑配合小白调试助手侧载 1.7.4 版,以 URL 添加机场的 Clash 订阅,再用规则模式连接。支持 HarmonyOS 5.0.5 及更高版本,约需 30 分钟;自签名会过期,需定期续签。
开始之前
- 一部华为手机或平板,系统至少是 HarmonyOS 5.0.5,怎么看版本在第 1 步
- 一台 Windows 或 Mac 电脑,再加一根能传数据的 USB 线(光能充电的那种不行)
- 你自己的华为账号,签名环节要登录
- 一条机场提供的 Clash 格式订阅链接
ClashBox 鸿蒙版
1.7.4· 11 月 16 日核验
操作步骤14 步
步骤目录
第 1 步:确认系统版本
打开设置,点最上面那一行的设备名称,里面「软件版本」写的就是系统版本。ClashBox 1.7.4 在源码里把最低兼容版本设成 HarmonyOS 5.0.5,你的版本不低于它再继续。如果显示的是 4.x,这类设备本来就能装安卓应用,没必要侧载,换用安卓客户端就好;如果是 5.0.0 到 5.0.4,先去看看有没有系统更新。
第 2 步:把电脑上的代理关掉
签名这一步需要连华为的服务器。本站参考过的旧资料说,这台服务器不接受中国大陆以外的 IP,不过 ClashBox 仓库的说明里找不到这句话,本站也没验证过。保险的做法是:签名期间电脑别开任何代理,梯子、VPN 客户端、系统代理设置统统关掉,用国内宽带或手机热点上网。数据线得是能传数据的,只能充电的线插上后电脑根本认不出设备。
第 3 步:调出开发者选项
开发者选项平时是藏起来的。还是在设备名称那一页,对着「软件版本」连点 7 下,系统会弹窗问你要不要开启,确认后输入锁屏密码,设备会自己重启。点够了次数却什么都没发生的,先到「设置 > 系统」里看看,可能之前就已经开过了。
第 4 步:打开 USB 调试并授权给电脑
等设备重启好,「设置 > 系统」底下会多出开发者选项,进去打开「USB 调试」。把设备连上电脑,屏幕上会问是否允许这台电脑调试,点允许。如果迟迟不弹出这个提示,换个 USB 口、换根线试试,或者把 USB 调试关了再重新打开。
第 5 步:下载安装包
在 ClashBox 的 GitHub 发布页下载 1.7.4 LTS 版(发布于 2026 年 4 月 2 日)。页面上只有一个文件,ClashBox_LTS_V1_unsigned.hap,大小约 103 MB。名字里带 unsigned,意思是还没签名,直接在手机上点是装不上的,得交给下一步的工具来处理。别人在网盘、群里转的 HAP 包不要装。
第 6 步:下载小白调试助手
ClashBox 项目说明里推荐的安装工具叫 Auto-installer,中文叫小白调试助手。到它的 GitHub 发布页下 3.1.0 版(2026 年 3 月 25 日发布):Windows 选 hap_installer-Windows-3.1.0.zip,Mac 选 hap_installer-Mac-3.1.0.zip,解压后打开。Mac 第一次运行被系统拦住的话,照项目说明在终端里跑一条 xattr 命令,把隔离属性去掉。
第 7 步:登录华为账号
线别拔,打开小白调试助手,等工具里认到设备之后,跟着界面提示登录你自己的华为账号——工具要拿这个账号去申请调试证书。登录失败或证书申请不下来,先回到第 2 步,确认电脑真的没走代理。按钮叫什么以工具里显示的为准。
第 8 步:签名后装到设备上
在工具里选中第 5 步下好的那个 HAP 文件,点开始安装。工具会先拿你的账号给它签名,然后经 USB 调试把应用推到设备上,完成后桌面上会出现 ClashBox 的图标。装到一半断了,看看线有没有松、设备上的调试授权是不是还在,再重新来一遍。
第 9 步:第一次打开 App
点桌面上的 ClashBox 图标,先会看到用户协议、隐私声明和免责声明,点同意后进到欢迎页。欢迎页上有「进入引导」和「我是老手啦」两个按钮,选前者会一个个告诉你按钮在哪儿。App 最下面有四个标签:主页、代理、配置、更多,接下来几步都在这四页里操作。
第 10 步:用链接导入订阅
切到底部的「配置」,右下角飘着一个「+」号,点开后选「从 URL(链接)导入」。页面上有配置名和链接两个框,名字自己起,链接框里贴 Clash 订阅;两个框都填上,保存按钮才会显示出来。点保存后会提示「正在下载配置文件」,接着出现「下载成功」。下载不成功的,检查订阅有没有过期、链接头尾有没有复制完整。
第 11 步:选好配置、测延迟
刚导入的配置会出现在「配置」页的列表里,点一下,把它设成当前使用的配置。然后去「代理」页,右下角那个圆圈里画着闪电的按钮就是测延迟,一下就能把所有节点测完。挑一个后面显示了毫秒数的节点。如果满屏都是 TIMEOUT,解决办法在文末的常见问题里。
第 12 步:切到规则模式再启动
「主页」上有张叫「分流模式」的卡片,在里面选「规则」,哪些直连、哪些走节点,就照订阅里自带的规则来分。启动键是个三角形的播放图标,第一次点会弹出系统的 VPN 授权,允许之后图标会变成暂停。如果跳出「请检查配置文件是否导入」之类的提示,回上一步看看是不是忘了选中配置。
第 13 步:开启后台保活
鸿蒙清后台清得比较狠,ClashBox 得借一项后台保活手段才能一直运行,设置位置在「更多 > 设置 > 后台运行」。App 里的说明是:手机可以选「模拟定位」或「模拟画中画」(这是 App 里的菜单原名),平板和电脑更推荐「任务保持」。选定位那一项的话,得给 App 位置权限,系统的定位开关也要一直开着,改完这一项要重启 App。App 也提醒了,开这些选项会更费电。
第 14 步:到期前记得续签
用个人账号签名装上的应用是有期限的,一过期就打不开。本站参考的旧资料写着默认 14 天、在华为开发者联盟做过实名认证可延到 180 天,但 ClashBox 仓库说明里没有这个说法,本站也没核实,以小白调试助手里显示的到期时间为准。这个工具 3.1 版的更新日志提到了两项相关功能:一键续期,以及把到期时间加进日历提醒。快到期时把设备接回电脑续一次;已经过期了,就重新签名再装。
检查一下节点列表里显示出延迟数值、开启代理后原本上不去的网站能正常访问,到这一步就配置好了。
测试环境与验证
这篇 ClashBox 教程只讲纯血鸿蒙。设备还在用 HarmonyOS 4.x 的,系统本身就能装安卓应用,照 Clash Meta for Android 的安卓教程 操作就行;鸿蒙上还有哪些客户端能用,列在 鸿蒙梯子软件下载。历次版本与下载入口在 ClashBox 下载页。还没有订阅的,可以先去 梯子推荐看看。
测试环境
这 14 步本站还没有在真机上从头做完一次。下面这张表整理的是版本资料。
| 项目 | 核对结果 | 来源 |
|---|---|---|
| ClashBox | 1.7.4 LTS,2026-04-02 发布,安装包大约 103 MB | GitHub 发布页 |
| 系统要求 | 支持下限为 HarmonyOS 5.0.5(API 17),目标为 6.0.0(API 20) | ClashBox 源码里的构建配置 |
| 小白调试助手 | 3.1.0,2026-03-25 发布,Windows、Mac 各有一个压缩包 | GitHub 发布页 |
| 界面文字 | 照源码里的中文字符串资源逐条对过 | master 分支 2026-08-15 那次提交,版本号写的是 1.7.4 |
步骤中提到的按钮名字和位置都取自源码。源码分支比 1.7.4 安装包晚了四个多月,个别文字可能有出入。小白调试助手的仓库里只有说明文件,源码没公开,它的界面只能照着说明来写。怎样开启开发者选项,以 华为开发者文档中关于开发者选项的说明 为准。
做完后怎么验证
- 看主页上的「IP 地址」卡片,地区应该变成你选的那个节点所在地。这张卡片是 App 去调第三方接口查出来的,查不到不等于代理没生效;而且它只代表 ClashBox 自己发的这一次请求,别的应用的流量走没走代理,它说明不了。
- 用系统浏览器分别打开一个境外网站和一个国内网站,两个都能正常显示,这一步才算真正完成。
- 装了卓易通的,里面的应用得另外试一遍。ClashBox 仓库的 Issue #113 中,有人反映 1.7.2 版在 HarmonyOS 6.0 上系统浏览器没走代理,卓易通里的应用却没问题;Issue #102 说的是 1.6.6 版在 HarmonyOS 6.0 上恰好反过来。这两条都只是个别用户的反馈,本站没有重现过。
如果所有节点都超时,照 梯子所有节点超时的排查对照 一段一段查。「规则」和「全局」这两种分流有什么不同,见 规则模式与全局模式有何不同。
卸载和还原
- 暂停代理:在主页点暂停键,VPN 连接会跟着断开。
- 卸载 ClashBox:在桌面上长按它的图标,选卸载。
- 关闭调试入口:到「设置 > 系统 > 开发者选项」里把 USB 调试关掉;以后不打算再侧载的话,整个开发者选项都可以关掉。
- 清理电脑:小白调试助手 3.1 会在「下载」文件夹里建一个跟它同名的目录,用来放账号文件和备份,用不着了可以删掉。
常见疑问
ClashBox 里的节点比机场后台显示的少
App 自带的说明里提到,很多服务商对 ClashBox 的 UA 适配得不好,建议在订阅地址末尾补上 &flag=meta。如果原地址里没有问号,这段就得写成 ?flag=meta。改完把旧配置删了,按第 10 步重新导一次。
ClashBox 测延迟全是 TIMEOUT
App 的说明把原因归到一些服务商自带的 DNS 地址解析出了错,办法是在「覆写」里把「覆写 DNS」打开,然后重启 ClashBox。改完还是超时,就去机场用户中心看看套餐到期没有、流量还剩多少。
ClashBox 一放到后台就断线
先看第 13 步是不是选了一种后台保活方式。设置页里有个「VPN 进程已被系统终结」的计数,可以拿来判断是不是被系统杀掉了。App 的特别提示还建议,掉线频繁时把内核改成前台模式,同时保留一种后台保活,不然代理会失效。
小白调试助手认不到设备,或者签名报错
设备无法识别,通常是未在设备上确认「允许调试」,或连接线仅支持充电;拔下来重插,再在设备上点授权。签名报错先查电脑网络,把所有代理关掉、直接连网再试。换了一台电脑的,要在新电脑上重新登录华为账号。
ClashBox 用了一阵子忽然打不开
订阅和节点都没问题的话,先看签名是不是到期了。小白调试助手 3.1 可以用日历提醒你什么时候到期,也能一键续期;过期以后续一下或者重新签名安装就行。有效期到底是多少天,本站没有在官方文档里查到确切说法。