<div align="center">
🚀 엑스레이FA
**Xray-core를 위한 현대적이고 강력하며 사용자 친화적인 안드로이드 클라이언트입니다**

XrayFA는 간편함과 성능에 중점을 두고 안전하고 빠른 프록시 환경을 제공합니다.

<p align="center">
  <a href="README_zh-CN.md">English</a> | <a href="README_zh-CN.md">简体中文</a> | <a href="README_RU.md">Русский</a> | <b>한글</b>
</p>

[![GitHub release](https://img.shields.io/github/v/release/Q7DF1/XrayFA?style=flat-square&color=blue)](https://github.com/Q7DF1/XrayFA/releases)
[![GitHub license](https://img.shields.io/github/license/Q7DF1/XrayFA?style=flat-square)](https://github.com/Q7DF1/XrayFA/blob/main/LICENSE)
[![GitHub top language](https://img.shields.io/github/languages/top/Q7DF1/XrayFA?style=flat-square)](https://github.com/Q7DF1/XrayFA)
[![GitHub stars](https://img.shields.io/github/stars/Q7DF1/XrayFA?style=flat-square)](https://github.com/Q7DF1/XrayFA/stargazers)

</div>

---

## 📸 스샷

<div align="center">
    <h3>폰 UI</h3>
    <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/1.png" width="30%" />
    <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/2.png" width="30%" />
    <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/3.png" width="30%" />
    <br><br>
    <h3>태블릿 / 폴더블 UI</h3>
    <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/4.png" width="85%" />
</div>

---

## ✨ 특징
📡 프로토콜 지원
| VLESS | VMESS | Shadowsocks | Trojan | Hysteria2 |
| :---: | :---: | :---: | :---: | :---: |
| ✅ | ✅ | ✅ | ✅ | ✅ |

### 🛠️ 주요 기능
*   **구독 관리**: 구독 링크를 간편하게 가져오고 관리하며 일괄 업데이트할 수 있습니다
*   **직관적인 대시보드**: 연결 상태, 속도 및 트래픽을 실시간으로 깔끔하게 모니터링할 수 있습니다
*   **풍부한 설정들**: 고급 사용자를 위한 고급 라우팅 규칙 및 DNS 설정
*   **매끄러운 UX**: 부드러운 애니메이션과 다크 모드 기능을 갖춘 최신 Material Design 3 인터페이스
*   **안정적인 엔진**: 최신 Xray 코어를 기반으로 구축되어 최고의 호환성과 보안을 제공합니다

---

## 📥 다운로드

시작할 준비 되셨나요?

<div style="display: flex; gap: 10px; align-items: center;">
    <a href="https://github.com/Q7DF1/XrayFA/releases">
        <img src="https://raw.githubusercontent.com/rubenpgrady/get-it-on-github/refs/heads/main/get-it-on-github.png" alt="Get it on GitHub" height="60">
    </a>
    <a href="https://f-droid.org/en/packages/com.android.xrayfa/">
        <img src="https://f-droid.org/badge/get-it-on.png" alt="Get it on F-Droid" height="60">
    </a>
</div>

---

## 🔨 소스 코드에서 빌드

###필수 조건
* **Android Studio**: 최신 안정 버전
* **JDK**: 11 이상
* **Go (Golang)**: 1.21 이상 (Xray-core 컴파일에 필요)
* **Git**: 서브모듈 복제용


### 단계별 구성

1.  **저장소를 복제하세요** (하위 모듈 포함):
    `
    git clone --recursive https://github.com/Q7DF1/XrayFA.git
    cd XrayFA
    `
    *하위 모듈이 누락된 경우:* `git submodule update --init --recursive`

2.  **Android Studio에서 열기**:
    `XrayFA` 폴더를 선택하고 Gradle 동기화가 완료될 때까지 기다립니다

3.  **빌드 및 실행**:
    기기를 연결하고 **Shift + F10** 키 를 누르세요

> [!주의]
> 🚨 **중요**: 정확한 성능 테스트를 위해 빌드 구성이 **릴리스(RELEASE)** 로 설정되어 있는지 확인하십시오. [Compose 성능에 대한 링크](https://medium.com/androiddevelopers/why-should-you-always-test-compose-performance-in-release-4168dd0f2c71)
---

## 📖 빠른 시작

1.  **구성 가져오기**:
    *   클립보드에서 가져오려면 **+** 버튼을 클릭하세요 (`vless://`, `vmess://`, 그외 디원하는 다른 프로토콜)
    *   또는 구성 링크에 관한 **QR Code** 를 스캔하세요
2.  **구독 관리**:
    *   **구독 설정** 으로 이동하여 제공업체 URL을 추가하세요
3.  **연결**:
    *   노드를 선택하고 **플로팅 액션 버튼** 을 누르세요
    *   VPN 권한 요청을 수락하는건 필수입니다

---

## 🔗 크레딧 및 감사 인사

XrayFA를 가능하게 해준 다음 프로젝트들에 특별히 감사드립니다
*   [Xray-core](https://github.com/XTLS/Xray-core) - 코어 네트워크 엔진
*   [AndroidLibXrayLite](https://github.com/2dust/AndroidLibXrayLite)
*   [hev-socks5-tunnel](https://github.com/heiher/hev-socks5-tunnel)

🔗 크레딧 및 감사 인사
XrayFA를 가능하게 해준 다음 프로젝트들에 특별히 감사드립니다:

## 📄 라이센스

**Apache-2.0 라이센스** 에 따라 배포됩니다. 자세한 내용은 [라이센스](LICENSE) 파일을 참조하십시오

<div align="center">

### 🌟 스타 히스토리

[![Star History Chart](https://api.star-history.com/svg?repos=q7df1/xrayFA&type=Date)](https://star-history.com/q7df1/xrayFA)

</div>
