图文教程 · 鸿蒙
ClashBox 鸿蒙挂梯子教程：14 步，从电脑签名到连上
ClashBox 鸿蒙挂梯子一共 14 步，大约 30 分钟，开始前要备好 3 样东西，清单在下面“开始前准备”。走完以后订阅已经导入、节点已经选好，代理开关处于打开状态。这一遍在 走完，本页更新于 。
- 适用系统
- HarmonyOS 5.0.5 或更高，1.7.4 源码写明的最低版本（2026-09-25 核对）
- 客户端版本
- ClashBox 1.7.4 LTS（2026-04-02 发布）；签名安装用的小白调试助手是 3.1.0 版，发布于 2026-03-25
- 所需时间
- 约 30 分钟
- 难度
- 进阶
- 走完日期
- 更新日期
这一页是鸿蒙设备的装备段。你有一部 HarmonyOS 5.0.5 以上的华为设备、一条 Clash 订阅链接，手边还有一台电脑。ClashBox 发布页只给未签名的包，要先用电脑签名再装进设备，步骤比直接装一个客户端多。本篇没有截图。
开始前准备
Clash 格式的订阅链接从机场用户中心里复制，ClashBox 靠这条 https 地址下载配置文件。还没挑机场的，先去梯子推荐页；想先把签名走通再付费的，免费节点页有 Clash 订阅地址可以练手，免费节点在大陆能不能用，本站没有试过。
系统版本在第 1 步里查。电脑能解压文件、能插 USB 线就够。ClashBox 的版本和仓库地址见 ClashBox 的客户端页，鸿蒙上的其他做法在鸿蒙梯子页。
14 步走完
每一步下面两行：“你会看到”是做对了的样子，“卡住了”是不对时先做什么。
查看系统版本号
打开“设置”，点第一行的本机名称，在列表里找“软件版本”，记下后面的数字。
- 你会看到
- “软件版本”一行显示 HarmonyOS 开头的版本号，5.0.5 或更高就能往下走。
- 卡住了
- 版本在 5.0.0 到 5.0.4 之间，先到系统更新里升一次再回来。4.x 的设备能装安卓应用，直接改用安卓客户端，不走这篇。
退出电脑上的代理
在电脑上把代理软件、VPN 全部退出，系统代理也关掉，网络改用国内宽带或手机热点。
- 你会看到
- 电脑任务栏或菜单栏里已经看不到任何代理软件的图标。
- 卡住了
- 旧资料说华为的签名服务不接受大陆以外的 IP，ClashBox 仓库没写这条，本站没有核实，后面登录失败时先回这一步查。
打开开发者选项
回到本机名称那一页，对着“软件版本”连点 7 次，按提示确认，再输一次锁屏密码。
- 你会看到
- 输完锁屏密码，设备自动重启一次，之后“设置”的“系统”分组里多出“开发者选项”。
- 卡住了
- 点了 7 次没有任何提示，重启后到“设置”里的“系统”分组找“开发者选项”，有这一项就说明已经开了。
打开 USB 调试并授权
进“设置”，点“系统”，再点“开发者选项”，把“USB 调试”拨开。用数据线接上电脑，在设备弹出的询问里选允许。
- 你会看到
- “USB 调试”开关拨开，接上数据线后设备上弹出是否允许调试的询问。
- 卡住了
- 接上后没有任何询问，换一个 USB 口或换一根线，再把“USB 调试”关掉重新拨开一次。
下载 ClashBox 安装包
在电脑上打开 ClashBox 的 GitHub 发布页，找到 1.7.4 LTS（2026-04-02），下载 ClashBox_LTS_V1_unsigned.hap。
- 你会看到
- 下载文件夹里多出一个约 103 MB 的 hap 文件，这一版的附件只有它一个。
- 卡住了
- 文件名带 unsigned，意思是还没签名，传到手机上点开是装不上的，别在这上面花时间，留在电脑上等第 8 步用。
下载小白调试助手
下载小白调试助手（Auto-installer）3.1.0，Windows 选 hap_installer-Windows-3.1.0.zip，Mac 选 hap_installer-Mac-3.1.0.zip，下好后解压。
- 你会看到
- 解压出的文件夹里能找到调试助手的程序，双击可以打开。
- 卡住了
- Mac 上提示文件已损坏或来自身份不明的开发者，按项目说明用 xattr 命令去掉隔离属性再打开。
登录华为账号
用数据线把设备接上电脑，打开调试助手，看到工具里识别出这台设备后，用本人的华为账号登录。
- 你会看到
- 登录成功后，工具用这个账号去申请调试证书。
- 卡住了
- 账号登不上或证书申请失败，回第 2 步确认电脑上没有代理在跑；还不行，网络换成手机热点再试一次。
签名并装进设备
在调试助手里选中第 5 步下载的 hap 文件，点开始安装，等进度走完。
- 你会看到
- 工具先签名再经 USB 调试安装，结束后设备桌面上多出 ClashBox 的图标。
- 卡住了
- 安装走到一半断掉，先查数据线有没有松，再看设备上 USB 调试的授权是否还在。
首次打开 ClashBox
点开桌面上的 ClashBox，把弹出的三份文件（用户协议、隐私声明、免责声明）依次点同意。
- 你会看到
- 欢迎页上并排两个按钮，“进入引导”和“我是老手啦”；屏幕最下方有四个标签，从左数第一个是主页，往右是代理、配置和更多。
- 卡住了
- 两个按钮任选一个都能进主界面；同意之后又退回桌面，把 ClashBox 再点开一次。
从 URL 导入订阅
点底部“配置”，再点右下角的加号，选“从 URL(链接)导入”，填一个配置名，粘贴订阅地址，点保存。
- 你会看到
- 配置名和地址缺一个，保存按钮就不出现；点了保存，先提示“正在下载配置文件”，接着提示“下载成功”。
- 卡住了
- 一直停在“正在下载配置文件”，先确认设备本身能上网，再看粘贴的是不是 Clash 格式的地址。
选中配置并测延迟
在“配置”页的列表里点刚导入的那条，把它设为当前配置。切到底部的“代理”，点右下角带闪电的圆圈。
- 你会看到
- 节点后面陆续出现毫秒数，挑一个数字小的点一下。
- 卡住了
- 满屏都是 TIMEOUT，先回“配置”页确认那条已经是当前配置，再看页末的常见卡点。
选规则模式并启动
回到底部的“主页”标签，把“分流模式”那张卡片切到“规则”，再点三角形的启动按钮，系统问 VPN 授权时点允许。
- 你会看到
- 三角形按钮换成暂停图标，说明内核已经跑起来。
- 卡住了
- 提示“请检查配置文件是否导入”，是第 11 步没有把配置设为当前，回去点一次再启动。
开启后台运行
点“更多”，进“设置”，找“后台运行”。手机在“模拟定位”“模拟画中画”里挑一个，平板和电脑选“任务保持”，改完重启 ClashBox。
- 你会看到
- 重启后“后台运行”一行显示你选的那一项。
- 卡住了
- 挑了“模拟定位”要给位置权限，系统定位也得一直开着；这几个选项都会多耗电，想省电可以改回关闭。
到期前续签
签名到期之前，把设备接回电脑，打开小白调试助手做一次续签。
- 你会看到
- 调试助手 3.1 里有一键续期，续完还可以把下一个到期日写进日历当提醒。
- 卡住了
- 已经过期打不开了，就按第 7、8 步重新签名安装一遍。
连上了怎么确认
第 12 步点了启动以后，用设备自带的浏览器开一个查 IP 的网页，看它报出来的地区。地区和你选的节点一致，代理就在走了；读法见梯子 IP 查询。它证明不了速度，本篇没有测速数字。
这篇教程不适用的情况
- 本篇按小白调试助手 3.1.0 和 ClashBox 1.7.4 LTS 写，HarmonyOS 5.0.5 这个门槛来自 2026 年 9 月 25 日核对的源码，两个工具换了版本后菜单位置可能不同。
- HarmonyOS 4.x 的设备还能装安卓应用，用不着签名，去安卓梯子页选一个客户端。
- 本篇没有截图，“会看到什么”按 1.7.4 的界面文字写，你的设备上字样有出入时以设备为准。
- 签名服务挑不挑网络、签名能用多久，这两件事目前只有旧资料提过，本站没有核实；在单位或学校的网络里能不能签名，本站没有试过。
- 节点全部超时的排查顺序在全部节点超时那篇。
想退回去怎么办
先在“主页”点暂停停掉代理，再到“更多”的设置里把“后台运行”改回关闭。然后按常规方式卸载 ClashBox。想把设备恢复原样的，回“设置”里的“开发者选项”关掉“USB 调试”；开发者选项本身怎么关，资料未写。
卡住了怎么办
按出现的现象找，每条先说原因，再说先做什么。
签名时登录华为账号失败或证书申请不下来
先把电脑上的代理和 VPN 全部退出，换成普通宽带或手机热点再试。旧资料提到签名服务会拒绝大陆以外的地址，ClashBox 仓库没写这一条，本站没有核实。
hap 文件传到手机上点开装不上
文件名里的 unsigned 说明这个包没签过名，鸿蒙不让直接装。正确做法是在电脑上用小白调试助手拿你的华为账号签好，经数据线装进设备，见第 8 步。
测延迟后所有节点都是 TIMEOUT
先看“配置”页里那条是不是当前配置，再到机场面板查一下订阅过没过期、流量还剩多少。都没问题的话，在“配置”页删掉它重新导入一次；还不行，按本站问答“梯子全部节点超时怎么办”那篇的次序排查。
点启动后提示“请检查配置文件是否导入”
这是没有选中配置。回“配置”页点一下导入的那条，设为当前，再回“主页”点启动。列表是空的，先回第 10 步重新导入一次。
用了一段时间 ClashBox 突然打不开
个人账号的签名有有效期，过期后要接回电脑重新签名安装。有效期的说法来自旧资料，个人账号签出来的是 14 天，做过开发者联盟实名认证能到 180 天；ClashBox 的仓库没提，本站也没有核实。续签用调试助手 3.1 的一键续期。
下一步
- 装好了还缺一家靠得住的机场，去梯子推荐按价格和线路挑；还没有订阅链接的，可以先用免费节点试导入，这批节点在大陆网络下能不能用，本站并未核对。
- 版本号、各系统的安装包和已知问题在 ClashBox 的下载与安装页；鸿蒙上的其他客户端在鸿蒙梯子页。
- 用起来以后常遇到的问题：梯子全部节点超时怎么办：先查订阅是否过期，再查本机。
截图说明本篇没有截图，“你会看到”按当时的界面文字写。步骤在 走完一遍，本页更新于 。截图里的账号、流量和到期日已遮住，检测点只写海外。