explaingit

2dust/v2rayng

🔥 Hot56,347KotlinAudience · developerComplexity · 3/5ActiveLicenseSetup · hard

TLDR

Android app that routes your device's internet traffic through V2Ray proxy servers, supporting multiple protocols and intelligent routing rules.

Mindmap

mindmap
  root((repo))
    What it does
      Routes Android traffic
      Supports multiple protocols
      Intelligent routing rules
      Geoip and geosite filtering
    Protocols supported
      VMESS and VLESS
      Shadowsocks
      Trojan
      SOCKS5
    Use cases
      Bypass network restrictions
      Privacy and anonymity
      Route traffic selectively
      Access geo-restricted content
    Tech stack
      Kotlin for Android
      Go proxy core
      Android 7.0 and up
    Who uses it
      Tech-savvy Android users
      Privacy-conscious users
      Users with proxy servers

Things people build with this

USE CASE 1

Route Android device traffic through a V2Ray proxy server to bypass network restrictions or access geo-blocked content.

USE CASE 2

Set up intelligent routing rules using geoip and geosite databases to send different traffic types through different proxy paths.

USE CASE 3

Add a privacy layer to your Android browsing by tunneling traffic through a remote server you control or trust.

USE CASE 4

Connect to multiple proxy protocols (VMESS, VLESS, Shadowsocks, Trojan, SOCKS5) from a single Android app.

Tech stack

KotlinAndroidGoV2RayXray

Getting it running

Difficulty · hard Time to first run · 1day+

Requires Android SDK, NDK for native compilation, V2Ray/Xray binary building, and device/emulator setup with proper permissions.

Use it freely, but any project you distribute that includes this code must also be GPL-licensed and open source.

In plain English

v2rayNG is an Android application that acts as a client for the V2Ray network proxy system. V2Ray is a platform for building tunneled internet connections, commonly used to route traffic through servers in different locations, bypass network restrictions, or add a layer of privacy to internet browsing. Think of it as a more advanced and configurable alternative to a VPN, supporting multiple protocols and routing rules. The app works by connecting to a V2Ray or Xray server that you control or have access to. It supports several proxy protocols including V2Ray's own VMESS and VLESS formats, as well as Shadowsocks, Trojan, and SOCKS5. Once configured, all or selected internet traffic from your Android device is routed through that server. The app also supports geoip and geosite files, which are databases of IP address ranges and domain names grouped by country or category, letting you set up intelligent routing rules that send different types of traffic through different paths. You would use v2rayNG if you are an Android user who needs to route your device's internet traffic through a V2Ray-compatible proxy server. It requires you to already have access to a compatible server, the app only provides the client side. It is targeted at technically inclined users who understand proxy configurations. The application is built in Kotlin for Android (requiring API level 24 or higher, meaning Android 7.0+), and the underlying proxy core is written in Go.

Copy-paste prompts

Prompt 1
How do I configure v2rayNG to route only certain apps through my V2Ray proxy server while keeping others on direct connection?
Prompt 2
Show me how to set up geoip-based routing in v2rayNG so that traffic to Chinese domains goes through one server and everything else through another.
Prompt 3
What are the differences between VMESS, VLESS, and Shadowsocks protocols in v2rayNG, and which should I use for my setup?
Prompt 4
Help me import a V2Ray subscription URL into v2rayNG and test the connection to make sure it's working.
Prompt 5
How do I use v2rayNG with a self-hosted Xray server on my Android phone?
Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.