SimpleXray：Android 代理客户端

项目简介

SimpleXray 是一款面向 Android 的高性能代理客户端，基于 Xray-core 构建。它与常见的 JNI 方案不同，直接运行官方编译好的 Xray-core 二进制文件，把核心逻辑与 App 层隔离开，从而提升稳定性并充分发挥核心的原生性能。

主要功能

• 更高的稳定性：Xray-core 以独立子进程方式运行，避开 JNI 的复杂性与内存问题，核心库出错时也不会连带导致 App 崩溃。
• 高性能：沿用 Xray-core 的原生速度，并集成 hev-socks5-tunnel 实现 Tun2socks，兼顾低延迟与高吞吐。
• 易上手：界面简洁直观，配置流程经过简化，方便导入和管理连接。

技术特点

市面上多数 Xray-core Android 客户端通过 JNI 调用编译后的 .so 库，集成简单，但可能带来性能开销、跨语言复杂度和核心库故障引发的崩溃。

SimpleXray 的做法是：安装或更新时解压内嵌的 Xray-core 二进制（以 libxray.so 形式提供）；连接时通过标准 Android API 把该二进制作为独立的子进程启动，而非 JNI 调用，双方通过预定义的进程间通信（IPC）交互。这样既保留了原始二进制的稳定性与性能，也在物理上把核心进程与主 App 隔离。

项目还内置了来自 v2ray-rules-dat 的简化版 geoip.dat / geosite.dat，包含 geoip:private、geoip:cn、geosite:gfw 等基础规则。

安装与使用

1. 系统要求：Android 10 或更高版本。
2. 获取应用：从 Release 页面 下载 APK，或在 F-Droid 获取。
3. 安装：在设备上安装 APK。
4. 配置：打开应用，导入或手动添加服务器信息。
5. 连接：选择一个配置并点击连接。

从源码构建

1. 安装 Android Studio 并配置 Android SDK。
2. 克隆仓库及子模块：

git clone --recursive https://github.com/lhear/SimpleXray

3. 在 Android Studio 中打开项目。
4. 将对应架构的 Xray-core 二进制 libxray.so 放入 app/src/main/jniLibs/[架构目录]，例如 app/src/main/jniLibs/arm64-v8a/libxray.so。
5. 把 geoip.dat 与 geosite.dat 放入 app/src/main/assets/，路由功能需要这两个文件。
6. 同步 Gradle 并执行构建。

注意事项

• 需要 Android 10 及以上系统。
• 路由依赖 geoip.dat / geosite.dat，自行构建时务必补齐；项目自带的是简化规则集。
• 项目采用 Mozilla Public License 2.0 许可证。

---

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