ClashBox 适用于 HarmonyOS NEXT(OpenHarmony)。项目仍在维护，安装前请确认当前版本支持你的设备。
进入下载区查看可用版本和安装入口，安装后按教程导入订阅并完成连接测试。
客户端下载与教程
ClashBox 下载与使用教程
ClashBox 目前没有与当前界面逐步对应的安全截图。这一页只提供 HarmonyOS NEXT(OpenHarmony) 的设备与软件类型通用路径，不会套用其他客户端的按钮名称。界面可能随版本变化，具体入口以软件当前说明为准。
直接答案
直接答案
ClashBox 当前提供项目或文档入口，没有可直接列出的统一安装资产。请根据官方安装说明选择包管理器、源代码或平台专用方式。
成立条件前端开源，构建不可复现
开始前确认
这个客户端适不适合你
- 支持设备
- HarmonyOS NEXT
- 上手难度
- 容易上手
- 适合谁
- 适合第一次在 HarmonyOS NEXT 配置订阅，希望从安装一路做到连接成功的人。
- 开始前提示
- 先按设备下载安装，再导入订阅、选择节点并检查连接；按钮名称和位置以当前版本界面为准。
安装方式
先阅读项目的安装说明
这个项目没有适合在此统一列出的安装资产，可能需要包管理器、命令行、源代码构建或平台专用步骤。
查看官方安装说明安装与配置
ClashBox 下载与使用教程 · 通用配置路径
ClashBox 目前没有与当前界面逐步对应的安全截图。这一页只提供 HarmonyOS NEXT(OpenHarmony) 的设备与软件类型通用路径，不会套用其他客户端的按钮名称。界面可能随版本变化，具体入口以软件当前说明为准。
准备自己的订阅
从服务账户中复制供 ClashBox 使用的订阅地址，先确认套餐仍有效。若地址曾经公开泄露，应先在服务端重置，再继续配置。
完成后会看到订阅仍有效，地址没有出现在公开页面或共享截图中。
卡住时先检查- 订阅已经到期或地址曾经泄露，继续操作只会得到空列表或更新错误。
- 没有先确认设备平台和恢复方法，连接失败后不知道怎样回到原网络。
确认来源并安装
ClashBox 暂不提供安装包直链。请进入项目页，按当前设备查看发布说明、支持的 HarmonyOS NEXT(OpenHarmony) 版本与文件校验信息；无法确认发布者时不要安装。
完成后会看到ClashBox 能正常打开，来源与设备平台已经核对。
卡住时先检查- 下载了不适合当前平台或架构的 ClashBox 文件，安装程序无法运行。
- 从转载页取得旧版本，界面与当前项目文档无法对应。
按项目文档导入
先核对 ClashBox 对 HarmonyOS NEXT 或 OpenHarmony 的当前支持说明，再按项目文档导入配置。系统兼容层与 Android 不同，不使用 Android 客户端教程替代。
完成后会看到软件中出现新配置、订阅分组或项目文档要求的记录。
卡住时先检查- 订阅地址缺少字符、夹带空格或已经失效，配置无法更新。
- 软件要求配置文件，但输入的是普通订阅 URL，导入方式彼此不兼容。
选择节点并连接
在 ClashBox 中载入配置后，按 HarmonyOS 当前权限提示建立连接。核对提示中的应用名称，再用普通网页完成首次验证。
完成后会看到连接已启用，系统权限提示与当前软件名称一致。
卡住时先检查- 配置已经导入却没有选中活动节点，开启连接后仍然没有可用出口。
- 同时修改代理模式、DNS 和系统权限，失败后难以定位具体原因。
检查结果并留好退路
确认 ClashBox 能更新配置并完成基础访问。遇到失败时先关闭连接，记录错误提示，再分别检查订阅有效期、系统时间、网络权限和当前项目文档。
完成后会看到基础网页可访问，并且你知道如何关闭连接、恢复原网络。
卡住时先检查- 只测试受地区限制的目标，无法区分客户端配置和目标服务本身的问题。
- 测试后没有关闭代理并检查恢复路径，原网络异常时缺少参照。
连接不成功
按现象继续排查
先找到最接近的现象，再逐项检查。这样比反复重装客户端更快。