机场帮

ClashBox 鸿蒙教程：HarmonyOS NEXT 侧载安装

本页最后更新：

以阶梯步骤卡片为主视觉的编辑风插画，配合书本、路线与勾选标记，表示按顺序完成的入门流程。画面右下角有机场帮淡色水印。

一句话结论

流程分 6 步：了解签名前提 → 下载 hap → 电脑上用侧载工具签名安装 → 导入订阅 → 启动连接 → 验证。ClashBox 未上架应用市场，安装比常规应用多一道签名手续，自签名默认 14 天有效，约 20 分钟完成。

HarmonyOS NEXT 共 6 步 约 20 分钟完成
项目仓库 本地下载

操作步骤

  1. 了解侧载与签名前提

    盾牌图形，表示系统权限或安全设置。画面标出这是第 1 步（共 6 步）：了解侧载与签名前提。右下角有机场帮淡色水印。

    HarmonyOS NEXT 只运行带有效签名的应用，ClashBox 未上架应用市场，需要侧载：用工具对安装包自动签名后装入设备。项目推荐使用 Auto-installer 或 DevEco Testing。自签名默认 14 天有效，到期后重新签名安装即可；完成华为开发者实名认证后可延长至 180 天。

  2. 下载 hap 安装包

    窗口面板图形，表示从发布页获取安装包。画面标出这是第 2 步（共 6 步）：下载 hap 安装包。右下角有机场帮淡色水印。

    点客户端总表里 ClashBox 的「本地下载」获取未签名的 hap 包（官方 release 加速直链），保存到电脑。

  3. 签名并安装

    显示器图形，表示把客户端安装到设备上。画面标出这是第 3 步（共 6 步）：签名并安装。右下角有机场帮淡色水印。

    在电脑上安装侧载工具（Auto-installer 或 DevEco Testing），手机开启开发者模式并用数据线连接，按工具指引登录华为账号、对 hap 自动签名并安装。签名过程需要连接华为的签名服务器：在大陆网络下直接进行即可；身处境外时需让签名流量走大陆 IP（项目 README 明确说明了这一点）。

    • 工具的具体界面以其自身指引为准，核心流程都是：连接设备 → 选择 hap → 自动签名安装。

  4. 导入订阅

    清单图形，表示订阅导入后出现配置列表。画面标出这是第 4 步（共 6 步）：导入订阅。右下角有机场帮淡色水印。

    打开 ClashBox（内核为 Mihomo），在添加订阅的入口粘贴机场订阅地址导入。导入成功后会出现节点信息。

  5. 启动连接

    滑块开关图形，表示打开代理开关。画面标出这是第 5 步（共 6 步）：启动连接。右下角有机场帮淡色水印。

    启动连接并按系统提示完成 VPN 类授权，然后选择节点。建议开启应用设置里的「后台运行 - 模拟画中画」：ClashBox 内置的内核恢复功能依赖它，可减少后台被系统回收导致的断连。

  6. 验证连接

    勾选徽章图形，表示确认连接成功。画面标出这是第 6 步（共 6 步）：验证连接。右下角有机场帮淡色水印。

    打开浏览器访问一个平时无法打开的网站验证，能加载即成功。签名到期（默认 14 天）后应用会无法打开，重新执行第 3 步签名安装即可，订阅地址重新导入一次就能恢复使用。

常见问题排查

侧载工具安装失败
确认手机已开启开发者模式并允许调试；确认华为账号已登录；签名服务器验证失败时检查网络是否为大陆 IP。
应用突然打不开了
多数是签名到期（自签名 14 天）：重新签名安装即可。想延长有效期，完成华为开发者实名认证后签名有效期为 180 天。
连接一段时间后断开
开启「后台运行 - 模拟画中画」启用内核恢复；把应用加入系统的后台运行许可。
订阅导入后没有节点
确认订阅格式与 Mihomo 内核兼容（多数机场的通用订阅即可）；必要时到机场用户中心重置订阅后重试。

常见问题

为什么鸿蒙上装个应用这么麻烦？

HarmonyOS NEXT 只允许运行带有效签名的应用，未上架商店的开源应用只能通过开发者签名侧载，这是系统机制，不是 ClashBox 的问题。

重新签名后数据会丢吗？

覆盖安装一般保留应用数据；稳妥起见记好订阅地址，即使数据被清，重新导入一次订阅就能恢复。

老版本鸿蒙（非 NEXT）能用吗？

基于安卓的旧版鸿蒙可以直接使用常规 Android 客户端（见 FlClash Android 教程），不需要侧载流程。

返回客户端总表