https://github.com/2dust/v2rayNG

A V2Ray client for Android, support Xray core and v2fly core
https://github.com/2dust/v2rayNG

android proxy shadowsocks socks5 trojan v2fly v2ray vless vmess vpn xray xtls

Last synced: 24 days ago
JSON representation

A V2Ray client for Android, support Xray core and v2fly core

• Host: GitHub
• URL: https://github.com/2dust/v2rayNG
• Owner: 2dust
• License: gpl-3.0
• Created: 2019-05-15T02:15:31.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2024-04-19T15:41:13.000Z (2 months ago)
• Last Synced: 2024-04-19T20:52:44.700Z (2 months ago)
• Topics: android, proxy, shadowsocks, socks5, trojan, v2fly, v2ray, vless, vmess, vpn, xray, xtls
• Language: Kotlin
• Homepage: https://1.2345345.xyz
• Size: 223 MB
• Stars: 30,364
• Watchers: 515
• Forks: 4,671
• Open Issues: 35
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-stars - 2dust/v2rayNG
• awesome-stars-wjf0214 - 2dust/v2rayNG - A V2Ray client for Android, support Xray core and v2fly core (Kotlin)
• awesome-stars - 2dust/v2rayNG - A V2Ray client for Android, support Xray core and v2fly core (Kotlin)
• awesome-stars - 2dust/v2rayNG - A V2Ray client for Android, support Xray core and v2fly core (Kotlin)
• my-awesome-stars - 2dust/v2rayNG - A V2Ray client for Android, support Xray core and v2fly core (Kotlin)
• awesome-stars - 2dust/v2rayNG - A V2Ray client for Android, support Xray core and v2fly core (Kotlin)
• awesome-stars - 2dust/v2rayNG - A V2Ray client for Android, support Xray core and v2fly core (Kotlin)
• awesome - 2dust/v2rayNG - A V2Ray client for Android, support Xray core and v2fly core (Kotlin)
• stars - 2dust/v2rayNG
• awesome-stars-copy - 2dust/v2rayNG - A V2Ray client for Android, support Xray core and v2fly core (Kotlin)
• awesome-reconsidera-takeaway - v2rayNG - Source Software][oss icon] – Android (工具 / 代理工具)
• awesome-stars-webVueBlog - 2dust/v2rayNG - A V2Ray client for Android, support Xray core and v2fly core (Kotlin / 运维\&DevOps)

README

        
# v2rayNG

A V2Ray client for Android, support [Xray core](https://github.com/XTLS/Xray-core) and [v2fly core](https://github.com/v2fly/v2ray-core)

[![API](https://img.shields.io/badge/API-21%2B-yellow.svg?style=flat)](https://developer.android.com/about/versions/lollipop)

[![Kotlin Version](https://img.shields.io/badge/Kotlin-1.6.21-blue.svg)](https://kotlinlang.org)

[![GitHub commit activity](https://img.shields.io/github/commit-activity/m/2dust/v2rayNG)](https://github.com/2dust/v2rayNG/commits/master)

[![CodeFactor](https://www.codefactor.io/repository/github/2dust/v2rayng/badge)](https://www.codefactor.io/repository/github/2dust/v2rayng)

[![GitHub Releases](https://img.shields.io/github/downloads/2dust/v2rayNG/latest/total?logo=github)](https://github.com/2dust/v2rayNG/releases)

[![Chat on Telegram](https://img.shields.io/badge/Chat%20on-Telegram-brightgreen.svg)](https://t.me/v2rayn)







### Telegram Channel

[github_2dust](https://t.me/github_2dust)

### Usage

#### Geoip and Geosite

- geoip.dat and geosite.dat files are in `Android/data/com.v2ray.ang/files/assets` (path may differ on some Android device)

- download feature will get enhanced version in this [repo](https://github.com/Loyalsoldier/v2ray-rules-dat) (Note it need a working proxy)

- latest official [domain list](https://github.com/v2fly/domain-list-community) and [ip list](https://github.com/v2fly/geoip) can be imported manually

- possible to use third party dat file in the same folder, like [h2y](https://guide.v2fly.org/routing/sitedata.html#%E5%A4%96%E7%BD%AE%E7%9A%84%E5%9F%9F%E5%90%8D%E6%96%87%E4%BB%B6)

### More in our [wiki](https://github.com/2dust/v2rayNG/wiki)

### Development guide

Android project under V2rayNG folder can be compiled directly in Android Studio, or using Gradle wrapper. But the v2ray core inside the aar is (probably) outdated.  

The aar can be compiled from the Golang project [AndroidLibV2rayLite](https://github.com/2dust/AndroidLibV2rayLite) or [AndroidLibXrayLite](https://github.com/2dust/AndroidLibXrayLite).

For a quick start, read guide for [Go Mobile](https://github.com/golang/go/wiki/Mobile) and [Makefiles for Go Developers](https://tutorialedge.net/golang/makefiles-for-go-developers/)

v2rayNG can run on Android Emulators. For WSA, VPN permission need to be granted via

`appops set [package name] ACTIVATE_VPN allow`