https://github.com/q7df1/xrayfa
XrayFA is a powerful and user-friendly Android client for Xray-core.
https://github.com/q7df1/xrayfa
android-app hysteria2 shadowsocks trojan tun2socks vless vmess vpn-client xray-core
Last synced: about 2 months ago
JSON representation
XrayFA is a powerful and user-friendly Android client for Xray-core.
- Host: GitHub
- URL: https://github.com/q7df1/xrayfa
- Owner: Q7DF1
- License: apache-2.0
- Created: 2025-09-02T09:27:03.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2026-04-28T15:33:39.000Z (about 2 months ago)
- Last Synced: 2026-04-28T17:26:04.227Z (about 2 months ago)
- Topics: android-app, hysteria2, shadowsocks, trojan, tun2socks, vless, vmess, vpn-client, xray-core
- Language: Kotlin
- Homepage:
- Size: 12.4 MB
- Stars: 46
- Watchers: 2
- Forks: 7
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ๐ XrayFA
**A modern, powerful, and user-friendly Android client for [Xray-core](https://github.com/XTLS/Xray-core).**
XrayFA provides a secure, high-speed proxy experience with a focus on simplicity and performance.
English | ็ฎไฝไธญๆ | ะ ัััะบะธะน | ํ๊ธ
[](https://github.com/Q7DF1/XrayFA/releases)
[](https://github.com/Q7DF1/XrayFA/blob/main/LICENSE)
[](https://github.com/Q7DF1/XrayFA)
[](https://github.com/Q7DF1/XrayFA/stargazers)
---
## ๐ธ Screenshots
Phone UI
Tablet / Foldable UI
---
## โจ Features
### ๐ก Protocol Support
| VLESS | VMESS | Shadowsocks | Trojan | Hysteria2 |
| :---: | :---: | :---: | :---: | :---: |
| โ
| โ
| โ
| โ
| โ
|
### ๐ ๏ธ Core Capabilities
* **Subscription Management**: Easily import, manage, and batch-update subscription links.
* **Intuitive Dashboard**: Clean real-time monitoring of connection status, speed, and traffic.
* **Rich Configuration**: Advanced routing rules and DNS settings for power users.
* **Smooth UX**: Modern Material Design 3 interface with fluid animations and Dark Mode support.
* **Stable Engine**: Built on the latest **Xray-core** for maximum compatibility and security.
---
## ๐ฅ Download
Ready to get started?
---
## ๐จ Build from Source
### Prerequisites
* **Android Studio**: Latest stable version.
* **JDK**: 11 or higher.
* **Go (Golang)**: 1.21+ (Required for Xray-core compilation).
* **Git**: For cloning submodules.
### Build Steps
1. **Clone the repository** (with submodules):
`
git clone --recursive https://github.com/Q7DF1/XrayFA.git
cd XrayFA
`
*If you missed submodules:* `git submodule update --init --recursive`
2. **Open in Android Studio**:
Select the `XrayFA` folder and wait for Gradle sync.
3. **Build and Run**:
Connect your device and press **Shift + F10**.
> [!CAUTION]
> ๐จ **IMPORTANT**: For accurate performance testing, ensure the build configuration is set to **RELEASE**. [Learn more about Compose performance](https://medium.com/androiddevelopers/why-should-you-always-test-compose-performance-in-release-4168dd0f2c71).
---
## ๐ Quick Start
1. **Import Configuration**:
* Click the **+** button to import from Clipboard (`vless://`, `vmess://`, etc.).
* Or scan a **QR Code**.
2. **Manage Subscriptions**:
* Navigate to **Subscription Settings** to add provider URLs.
3. **Connect**:
* Select a node and tap the **Floating Action Button**.
* Accept the VPN permission request.
---
## ๐ Credits & Acknowledgements
Special thanks to these projects that make XrayFA possible:
* [Xray-core](https://github.com/XTLS/Xray-core) - The core network engine.
* [AndroidLibXrayLite](https://github.com/2dust/AndroidLibXrayLite)
* [hev-socks5-tunnel](https://github.com/heiher/hev-socks5-tunnel)
## ๐ License
Distributed under the **Apache-2.0 License**. See [LICENSE](LICENSE) for details.
---
### ๐ Star History
[](https://star-history.com/q7df1/xrayFA)