Repolode
Submit
2dust

2dust/v2rayNG

An Android client for the V2Ray proxy platform, supporting both Xray core and v2fly core.

Open-source alternative to:Shadowrocket

View on GitHubWebsite
Stars
64,360
Forks
8,348
Open issues
38
Last commit
yesterday

What is it?

v2rayNG is a proxy client for Android built on the V2Ray network platform. It lets users configure and run connections using protocols such as VMess, VLESS, Trojan and Shadowsocks, with SOCKS5 as a local proxy interface.

The app can run on either Xray core or v2fly core. Routing decisions depend on geoip and geosite data files, which can be updated from a community rules repository or imported manually, and third-party dat files can be placed in the same folder.

The project is Kotlin-based and targets Android 7.0 (API 24) and later. Developers can build the Android project in Android Studio or Gradle, and the bundled core library can be rebuilt from the separate AndroidLibXrayLite or AndroidLibV2rayLite Go projects. Desktop users are directed to the separate v2rayN project.

Key features

  • 01Supports VMess, VLESS, Trojan, Shadowsocks and SOCKS5 protocols.
  • 02Runs on either Xray core or v2fly core.
  • 03Routing uses geoip and geosite rule files that can be updated or imported manually.
  • 04Supports third-party dat rule files placed in the app's assets folder.
  • 05Can be built from source in Android Studio or with Gradle.

Use cases

  • Connecting an Android phone to a self-hosted or subscribed V2Ray/Xray server.
  • Splitting traffic by domain or IP so that some sites use the proxy and others connect directly.
  • Studying or modifying an Android VPN client built on the V2Ray core.

Quick start

  1. 1

    Download the latest release from the GitHub releases page

  2. 2

    Compile the Android project in Android Studio or with the Gradle wrapper

Things to know

  • The Android core inside the aar may be outdated, according to the README.
  • Building the aar requires Go Mobile and a separate Go project.

Topics

#android#proxy#v2ray#xray#vless#vmess#trojan#shadowsocks#kotlin#socks5

FAQ

What is v2rayNG?
An Android client for the V2Ray proxy platform, supporting both Xray core and v2fly core. v2rayNG is a proxy client for Android built on the V2Ray network platform. It lets users configure and run connections using protocols such as VMess, VLESS, Trojan and Shadowsocks, with SOCKS5 as a local proxy interface.
Is v2rayNG free to use? What license does it have?
v2rayNG is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is v2rayNG still maintained?
Actively maintained. The last commit to v2rayNG was on Oct 19, 2026.
What can I use v2rayNG for?
Connecting an Android phone to a self-hosted or subscribed V2Ray/Xray server. Splitting traffic by domain or IP so that some sites use the proxy and others connect directly. Studying or modifying an Android VPN client built on the V2Ray core.
How do I install v2rayNG?
Download the latest release from the GitHub releases page Compile the Android project in Android Studio or with the Gradle wrapper
Where can I get v2rayNG?
The source code and installation instructions are on GitHub: https://github.com/2dust/v2rayNG

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects