XrayFA：Xray 代理客户端

项目简介

XrayFA 是一个基于 Xray-core 的开源代理客户端，使用 Kotlin Multiplatform 构建共享逻辑，界面由 Compose Multiplatform 实现。目前 Android 版本可以下载使用，iOS 尚未正式发布。

Android 支持 Android 9.0（API 28）及以上版本。

主要功能

• 节点与订阅：导入节点链接，添加、管理和更新订阅。
• 多协议支持：VLESS、VMess、Shadowsocks、Trojan、Hysteria2、SOCKS 以及 HTTP 代理链接。
• 多种导入方式：剪贴板、二维码，以及完整的 Xray JSON 配置。
• 连接与流量展示：显示 VPN 状态以及上传、下载速度。
• 路由与 DNS：可配置路由、DNS 及相关网络选项。
• 节点分享：把普通节点分享为链接或二维码。
• 界面与主题：共享的 Compose Multiplatform UI、深色模式，以及适配大屏的布局。
• Android 集成：分应用代理设置、日志查看，以及可调整大小的桌面小组件（显示当前节点、连接时长和本次会话流量）。

实际支持的协议、传输方式与配置字段，取决于当前的解析器和本仓库使用的 Xray-core 版本。

安装与使用

Android 安装包可从以下渠道获取：

• GitHub Releases
• F-Droid

如果不确定设备架构，选择 universal APK。不同渠道的安装包可能使用不同的签名密钥，切换渠道时可能需要重新安装，请先保存好配置。

快速开始：

1. 安装应用，导入节点链接或添加订阅。
2. 在配置列表中选择一个节点。
3. 在 Home 页面启动连接，并允许系统的 VPN 权限请求。
4. 查看状态与流量，按需调整路由和 DNS。

桌面小组件：Settings → General 中的 Home screen widget 开关控制 XrayFA 是否出现在系统小组件选择器中，默认关闭，需先启用再添加。关闭该开关会移除已有实例，重新启用后需要再次添加。添加方式为长按桌面 → 小组件 → 选择 XrayFA；调整尺寸可在紧凑开关和展开的连接卡片之间切换，开关用于控制 VPN，"Switch" 按钮打开节点列表。首次连接时会请求 VPN 权限。

注意事项

• 完整的 Xray JSON 配置在节点链接分享、延迟测试和部分流量统计上存在限制。
• iOS 版本尚未正式发布。
• 从源码构建需要 JDK 17、Android SDK Platform 37、NDK 28.2.13676358、Go 等环境，首次构建会下载 Gradle、依赖、Go 工具和路由数据；预先准备原生 AAR 后执行 ./gradlew :androidApp:assembleDebug 或 ./gradlew :androidApp:assembleRelease。
• 未提供 keystore 时，Release APK 未签名，安装前需自行签名；评估性能请使用 Release 版本，Debug 版本包含调试开销。

---

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