Clash Meta for Android：安卓规则代理客户端

项目简介

Clash Meta for Android（简称 CMFA）是 Clash.Meta 内核在 Android 平台上的图形界面客户端。它把规则化的流量隧道能力带到手机上，用户可以导入配置、切换节点、按规则决定哪些流量走代理、哪些直连。项目使用 Kotlin 编写，遵循 GPL-3.0 许可证。

主要功能

• 提供 Clash.Meta 内核的全部能力，以图形界面方式在 Android 上运行。
• 支持通过 URL Scheme 快速导入配置：clash://install-config?url=<encoded URI> 或 clashmeta://install-config?url=<encoded URI>。
• 对外暴露自动化控制接口，其他应用或自动化工具可以发送 Intent 控制服务状态。

安装与使用

获取应用

README 提供了 F-Droid 的下载入口：

<img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png" alt="Get it on F-Droid" height="80">

系统要求

• Android 5.0 及以上（最低），Android 7.0 及以上（推荐）
• 处理器架构需为 armeabi-v7a、arm64-v8a、x86 或 x86_64

自动化控制

应用包名为 com.github.metacubex.clash.meta。

• 切换 Clash.Meta 服务状态：向 Activity com.github.kr328.clash.ExternalControlActivity 发送 action com.github.metacubex.clash.meta.action.TOGGLE_CLASH
• 启动服务：action com.github.metacubex.clash.meta.action.START_CLASH
• 停止服务：action com.github.metacubex.clash.meta.action.STOP_CLASH

从源码构建

1. 更新子模块：

   git submodule update --init --recursive
   

2. 安装 OpenJDK 11、Android SDK、CMake 与 Golang。

3. 在项目根目录创建 local.properties，写入 SDK 路径：

   sdk.dir=/path/to/android-sdk
   

4. （可选）自定义应用包名，同样写在 local.properties 中：

   # config your ownn applicationId, or it will be 'com.github.metacubex.clash'
   custom.application.id=com.my.compile.clash
   # remove application id suffix, or the applicaion id will be 'com.github.metacubex.clash.alpha'
   remove.suffix=true
   

5. 在项目根目录创建 signing.properties：

   keystore.path=/path/to/keystore/file
   keystore.password=<key store password>
   key.alias=<key alias>
   key.password=<key password>
   

6. 执行构建：

   ./gradlew app:assembleAlphaRelease
   

注意事项

• 应用需要 Android 5.0 以上系统，且设备架构必须是 armeabi-v7a、arm64-v8a、x86、x86_64 之一。
• CMFA 使用 MetaCubeX/Clash.Meta 仓库中 android-real 分支的内核；向内核提交改动时，通用改动提到 Alpha 分支，Android 专属补丁提到 android-open 分支。
• 内核发布新版本后，仓库的 Update Dependencies 自动化流程会拉取新内核、更新 Go 依赖并创建 PR；若出现编译错误需先修复再合并。
• 手动触发 Build Pre-Release 会编译并发布 PreRelease 版本；触发 Build Release 会编译、打标签并发布正式版本，需按 v1.2.3 格式填写 Release Tag。

---

本作品整理自 GitHub 开源项目 MetaCubeX/ClashMetaForAndroid，原作者 @MetaCubeX，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。