搜索“FlClash 鸿蒙”时,先确认你要找的是哪一种运行方式:FlClash 上游 Android APK、通过卓易通运行 Android 应用,还是社区维护的 FlClash OpenHarmony(HAP)分支。它们不是同一个安装包,也不代表上游 FlClash 已发布原生鸿蒙版。

先选运行方式

设备/环境 可核对的路径 需要知道的边界
HarmonyOS NEXT 原生环境 查看 tljk/FlClash-ohos 社区分支的 OpenHarmony HAP 这是独立社区分支,不是上游 chen08209/FlClash 的官方原生发行。HAP 的系统安装、签名或开发者模式要求以设备系统与分支说明为准。
能运行 Android 应用的鸿蒙设备/兼容环境 可查看上游 FlClash Android 发行页;若设备使用卓易通,应按卓易通当前支持说明安装 这是 Android APK 在兼容环境中运行,不等同于原生 HAP。不要把 Android APK 当 HAP 安装。

上游 FlClash 的主要发布平台是 Android、Windows、macOS 和 Linux;HarmonyOS NEXT 的原生支持由社区分支另行维护。请从你实际选择的项目发布页下载,不要从聚合站或网盘拿同名包。

下载社区 HAP 并检查文件

  1. 打开 FlClash-ohos Releases,确认发行条目平台标记为 OpenHarmony。
  2. 阅读该版本说明,下载与发布条目对应的 .hap 文件和 SHA256SUMS 校验文件(若该版本提供)。不要把同一仓库里的 Android APK、源码压缩包或旧版本 HAP 混用。
  3. 按发布页给出的 SHA-256 信息核对 HAP 文件。文件名或校验值不对应、下载不完整时,重新从该发行页获取。
  4. 在设备上按系统提供且你已启用的安装流程处理 HAP。不同 HarmonyOS 版本、设备策略和签名状态可能要求不同权限或开发者配置;分支 README/发行说明未覆盖的步骤,不要用来源不明的签名工具或 HAP 代装服务。

截至 2026-11-16,社区发布页最新条目为 v0.8.99+2026110201,附件包括 FlClash-0.8.99+2026110201-ohos.hap 和 SHA256SUMS。版本与附件会变化,下载时以 Releases 当前页面为准。

安装后检查订阅和连接

社区分支说明支持订阅导入。首次配置时使用你有权访问的服务所提供的兼容订阅或配置文件;订阅的具体格式、转换方式和规则要求以服务提供方与当前应用版本为准。订阅链接可能包含凭据,不要放到公开截图或 issue。

导入后先确认配置/节点列表有内容,再按应用界面启动代理并完成系统权限确认。用一个应直连的网站和一个规则预期走代理的网站分别测试,避免只看状态图标就认定可用。

常见问题排查

现象 建议检查
找不到安装入口或提示包类型不支持 确认下载的是 .hap 还是 Android APK,以及当前设备是否提供相应安装环境;不要互相改扩展名。
HAP 安装被系统拒绝 核对 HAP 来源、当前系统对该安装方式的要求和发行说明。若系统提示签名/权限问题,先停止安装并从项目说明或设备官方帮助确认,不使用未知签名包。
安装成功但应用无法启动 核对当前 HAP 版本和设备系统版本,查看该分支最新 issue/release notes;上游 Android 版的操作建议不一定适用于 HAP 分支。
订阅后没有节点 检查订阅是否有效、格式是否与当前导入方式匹配、网络能否访问订阅地址,并查看应用提示。不要把账号密码误当订阅链接。
显示已连接但网络不符合预期 分别测试直连和代理目标,检查选择的策略/节点、系统 VPN 状态与规则;若仍异常,记录版本、设备系统和脱敏日志。

官方项目入口