基于 mihomo 内核构建的 Android 代理客户端,支持 XiaoV2b / Xboard 面板。
| 依赖 | 版本 |
|---|---|
| JDK | 17+(推荐 21) |
| Android SDK | compileSdk 36 |
| NDK | 28.2 |
| CMake | 3.22+ |
| Gradle | 8.13(wrapper 内置) |
内核已预编译为
libclash.so随仓库提供,普通编译无需 Go 环境;仅修改 Go 补丁链或升级内核版本时才需要。
# 调试包(含单元测试)
./gradlew :app:testDebugUnitTest :app:assembleDebug
# 发布包(必须提供签名环境变量)
SLTE_RELEASE_STORE_FILE=<keystore> \
SLTE_RELEASE_STORE_PASSWORD=<密码> \
SLTE_RELEASE_KEY_ALIAS=<别名> \
SLTE_RELEASE_KEY_PASSWORD=<密码> \
./gradlew :app:assembleRelease通过环境变量注入(默认值为占位符,请替换为自部署地址):
| 变量 | 默认值 | 说明 |
|---|---|---|
SLTE_API_BASE_URL |
https://api.example.com |
面板 API 地址 |
SLTE_API_TYPE |
xiaov2b |
后端类型(xiaov2b / xboard) |
SLTE_REMOTE_CONFIG_URLS |
空(不启用) | 远程配置 URL,逗号分隔多源,如 https://config.example.com/config.json |
安全白名单:为防配置投毒导致凭据外泄,API 地址与远程配置中的直连域名只允许在域名白名单内切换。白名单 =
SLTE_ALLOWED_DOMAINS追加项 + API 地址域名 + 远程配置源域名,构建期自动并入(详见 CONFIG.md),无需修改代码。仓库内置占位符example.com,部署前请通过环境变量或app/gradle.properties注入你的域名。内核直连兜底:内核侧补丁链(
kernel-core/src/main/golang/native/config/process.go)含独立的直连域名占位(与构建注入互不影响),自持域名需在此同步,并在修改后重新交叉编译libclash.so(GOOS=linux GOARCH=arm64 go build -tags "android cmfa with_gvisor" ./native/config/,无需 NDK)。
- mihomo - 内核引擎(本项目核心依赖,vendored 于
kernel-core/src/foss/golang/clash/) - ClashMetaForAndroid - 内核栈(
kernel-*模块)派生自该项目,第三方声明见 THIRD-PARTY-NOTICES.md - V2Board (xiaov2b) - 兼容的机场面板后端(
xiaov2bAPI,master 分支) - Xboard - 兼容的机场面板后端(
xboardAPI,master 分支)
- Telegram 频道:https://t.me/slteapp
- Telegram 作者:https://t.me/dc_slte
本项目以 GPL-3.0 协议开源,基于 mihomo 内核构建,第三方组件声明见 THIRD-PARTY-NOTICES.md。
© 2026 SLTE