ClashBox 鸿蒙教程:纯血鸿蒙挂梯子的侧载、订阅与续签
ClashBox 在纯血鸿蒙上怎么装、怎么导入订阅:用电脑和小白调试助手侧载 1.7.4 版,从 URL 导入机场的 Clash 订阅,以规则模式连上。适用 HarmonyOS 5.0.5 及以上,预计 30 分钟,自签名有到期时间,要定期续签。
开始之前
- 华为手机或平板一台,系统版本不低于 HarmonyOS 5.0.5,第 1 步会查版本
- 一台 Windows 或 Mac 电脑,外加一根能传文件的 USB 线(只能充电的线不行)
- 本人的华为账号,签名时要用
- 一条 Clash 格式的机场订阅链接
操作步骤14 步
步骤目录
这篇没有配截图。每一步写了点哪里、操作后应该看到什么,照着核对即可。
第 1 步:查看系统版本号
进入设置,点第一行的本机名称,页面里的“软件版本”就是系统版本。ClashBox 1.7.4 的源码把最低兼容版本定在 HarmonyOS 5.0.5,达到或高于它再往下做。显示 4.x 的设备能装安卓应用,不必侧载,改用安卓客户端;显示 5.0.0 到 5.0.4 的,先检查系统更新。
第 2 步:退出电脑上的代理
签名要连到华为的服务器完成。本站参考的旧资料写到这台服务器会拒收中国大陆以外的 IP,ClashBox 仓库说明里没有这句,本站也没有核实。稳妥起见,签名那段时间电脑不挂任何代理,梯子、VPN 客户端和系统代理设置一律退出,改走国内宽带或手机热点。USB 线要用能传数据的,只能充电的线插上后电脑看不到设备。
第 3 步:打开开发者选项
开发者选项默认隐藏。还是在本机名称这一页,连续点“软件版本”7 次,系统弹框询问是否开启,确认并输入锁屏密码后,设备自动重启。点够次数却毫无反应的,先去 设置 > 系统 下面找一找,开发者选项可能早就开过。
第 4 步:打开 USB 调试并授权
设备重启完成后,设置 > 系统 下面多出开发者选项,进去把“USB 调试”拨开。接上电脑,设备会询问是否允许这台电脑调试,选允许。询问一直不出现,换一个 USB 口或换一根线,也可以把 USB 调试关掉再开。
第 5 步:下载 ClashBox 安装包
打开 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 步:首次打开 ClashBox
点开桌面上的 ClashBox,先看用户协议、隐私声明和免责声明,同意后进入欢迎页。欢迎页有“进入引导”和“我是老手啦”两个按钮,前者会逐个提示按钮位置。App 底部有四个标签,依次是 主页、代理、配置、更多,后面几步都在这四页里完成。
第 10 步:从 URL 导入订阅
底部切到“配置”,右下角悬浮着一个“+”,点开后选“从 URL(链接)导入”。这一页有配置名和链接两栏,名称自己定,链接栏贴 Clash 订阅,两栏都填了保存按钮才会出现。保存后界面提示“正在下载配置文件”,随后出现“下载成功”。下载失败的,核对订阅是否过期、链接首尾是否复制全。
第 11 步:选中配置并测延迟
导入的配置出现在“配置”页的列表里,点它,把它设为当前配置。再去“代理”页,右下角圆圈里带闪电的是延迟测试按钮,一次测完全部节点。选一个显示了毫秒数的节点。满屏 TIMEOUT 的处理办法放在文末常见问题。
第 12 步:选规则模式并启动
“主页”上有一张“分流模式”卡片,选其中的“规则”,直连和走节点的范围按订阅自带的规则划分。启动按钮是三角形播放图标,第一次点会弹出系统的 VPN 授权,允许后图标换成暂停。弹出“请检查配置文件是否导入”一类提示的,回上一步确认已经选中配置。
第 13 步:开启后台运行
鸿蒙回收后台比较积极,ClashBox 靠模拟后台维持运行,入口是 更多 > 设置 > 后台运行。App 的提示写着手机可选“模拟定位”或“模拟画中画”,平板、电脑则推荐“任务保持”。选了模拟定位的,App 要拿到位置权限,系统定位开关也得一直开着,切换这一项后重启 App。App 同时提示这些选项会增加耗电。
第 14 步:到期前续签
用个人账号签名装上的应用有有效期,过期就打不开。本站参考的旧资料写的是默认 14 天、在华为开发者联盟实名后 180 天,ClashBox 仓库说明里没有这句,本站没有核实,以小白调试助手显示的到期时间为准。它 3.1 版的更新日志里有两项相关功能,一键续期,以及把到期时间写进日历提醒。到期前接回电脑续一次,已过期就重新签名安装。
完成检查节点列表里出现延迟数字,打开代理后能打开平时打不开的网站,这篇就做完了。
测试环境与验证
这篇 ClashBox 鸿蒙教程只覆盖纯血鸿蒙。设备还在 HarmonyOS 4.x 的,系统能直接装安卓应用,照 Clash Meta for Android 的安卓教程 做即可;鸿蒙上其他能用的客户端列在 鸿蒙梯子软件下载。版本记录和下载按钮在 ClashBox 下载页。还没有订阅的,先看 梯子推荐。
测试环境
本站尚未在真机上完整走过这 14 步。下表是 2026-09-25 核对过的版本信息,不是测试记录。
| 项目 | 核对结果 | 来源 |
|---|---|---|
| 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 能用日历提醒到期时间,也能一键续期,到期后续期或重新签名安装即可。有效期的具体天数本站没有在官方文档核实。
