v2rayF — Cross-platform V2Ray / Xray proxy & VPN client

v2rayF is a free, open-source V2Ray / Xray / VLESS / VMess / Shadowsocks / Trojan client for Windows, macOS, Linux, and Android. Built for people who need a fast connection behind censorship, with Smart Connect, DNS leak protection, a kill switch, TUN/VPN mode, and Secure Share so other devices can use the same tunnel.

Download the latest builds: Releases · Docs: Getting started · For AI assistants: llms.txt

Why v2rayF?

Need	What v2rayF does
One client on every device	Same Avalonia app on desktop + Android APK
Pick the fastest live node	Smart Connect ranks by proxy-path RTT, then fails over
Speed across several nodes	Smart Multipath (Xray observatory / leastPing balancer)
No DNS / IPv6 leaks	DNS through proxy, IPv6 block, Windows kill switch, crash teardown
Share the tunnel	Secure Share — authenticated LAN SOCKS/HTTP for phone↔PC
Modern Xray features	VLESS + REALITY + Vision, TUN, system proxy, geo routing

Ideal search / product keywords: v2ray client, xray client, vless reality client, vmess client, shadowsocks android windows, trojan gui, tun vpn proxy, anti-censorship proxy, dns leak protection kill switch.

Architecture

How traffic moves from apps to your proxy node when connected:

flowchart LR
  subgraph device [Your device]
    Apps[Apps / browser]
    UI[v2rayF UI]
    Core[v2rayF.Core]
    Local[SOCKS 10808 / HTTP 10809]
    Tun[TUN or system proxy]
  end
  Xray[Xray-core]
  Node[VLESS / VMess / SS / Trojan node]
  Net[Internet]

  Apps --> Tun
  Tun --> Xray
  Apps --> Local
  Local --> Xray
  UI --> Core
  Core --> Xray
  Xray --> Node --> Net

Sentinel / leak-shield stack (when enabled):

flowchart TB
  Start[Connect] --> TunVpn[Establish TUN / VPN]
  TunVpn --> StartCore[Start Xray]
  StartCore --> Ready{SOCKS ready?}
  Ready -->|no| Fail[Teardown]
  Ready -->|yes| KS[Arm kill switch Windows]
  KS --> Route[DNS via proxy + IPv6 block]
  Route --> Ok[Connected]
  Ok --> Drop{Core dies?}
  Drop -->|yes| Hold[Keep kill switch / tear VPN]
  Hold --> User[User taps Disconnect]
  User --> Clear[Release kill switch]

Smart Connect decision flow:

flowchart TD
  A[Servers in list] --> B[Phase 1: TCP prefilter]
  B --> C[Phase 2: proxy-path generate_204]
  C --> D[Rank: working path first then RTT]
  D --> E[Prefer REALITY on ties]
  E --> F[Connect top candidate]
  F --> G{Up?}
  G -->|no| H[Next candidate]
  H --> F
  G -->|yes| I[Optional multipath peers]

Secure Share — other devices use your exit IP:

flowchart LR
  Phone[Phone / PC client] -->|SOCKS or HTTP auth| GW[v2rayF Secure Share on LAN]
  GW --> Xray[Xray outbound]
  Xray --> Exit[Proxy exit]

Download

→ Latest release — pick the zip for your platform:

Platform	File	Run
Windows x64	`v2rayF-win-x64.zip`	`v2rayF.exe`
Windows ARM64	`v2rayF-win-arm64.zip`	`v2rayF.exe`
Linux x64	`v2rayF-linux-x64.zip`	`./run-v2rayF.sh`
Linux ARM64	`v2rayF-linux-arm64.zip`	`./run-v2rayF.sh`
macOS Intel	`v2rayF-osx-x64.zip`	`./run-v2rayF.sh`
macOS Apple Silicon	`v2rayF-osx-arm64.zip`	`./run-v2rayF.sh`
Android ARM64	`v2rayF-android-arm64.zip`	Install `v2rayF-android-arm64.apk`

Each desktop package includes Xray-core and geo data (geoip.dat, geosite.dat) — no extra setup. The Android APK bundles the same core and geo files.

macOS first launch: if Gatekeeper blocks the app, run xattr -cr /path/to/folder or right-click → Open once.

Features

Protocols — VMess, VLESS (incl. REALITY / Vision / Vision+TLS), Shadowsocks, Trojan, SOCKS
Import — clipboard, paste box, subscription URL (https://…); transports TCP/WS/gRPC/H2/HTTPUpgrade/xHTTP/mKCP/QUIC
Smart Connect — auto-pick the fastest working node; failover on failure
Adaptive Survive — escalate fragment / Sentinel tactics when Smart Connect cannot stay up
Smart Multipath — balance across top servers (Xray observatory)
Latency test — per server or test all (proxy-path preferred)
Routing — Global/Sentinel, Bypass LAN, Bypass China, Custom Direct / Proxy / Block
Leak shield — DNS through proxy, IPv6 block, kill switch, crash-aware teardown
Secure Share — LAN SOCKS/HTTP gateway (LAN-bind by default) for phone↔PC / hotspot clients
Encrypted vault — secrets at rest + .v2rayf export/import between devices
TUN / VPN mode — full-device capture (Admin on Windows; VPN permission on Android)
System proxy — Windows, macOS, GNOME, KDE, XFCE (desktop only)
Tray icon — status at a glance; minimize to tray while connected
Local proxies — SOCKS 127.0.0.1:10808, HTTP 127.0.0.1:10809

Quick start

Download and extract the zip for your OS from Releases.
Import your share link (vless://…, vmess://…, ss://…, trojan://…) or subscription URL.
Optional: Apply Sentinel profile for Global routing + DNS through proxy + IPv6 block + kill switch.
Enable Smart Connect (or select a server) → Connect.
Browse — system proxy or TUN routes traffic; use Secure Share to point other devices at the LAN gateway.

See docs/GETTING_STARTED.md, routing rules, and Secure Share.

Platform support matrix

flowchart LR
  subgraph desktop [Desktop]
    W[Windows<br/>proxy + TUN + kill switch]
    M[macOS<br/>proxy + TUN]
    L[Linux<br/>proxy + TUN]
  end
  subgraph mobile [Mobile]
    A[Android<br/>VpnService always]
  end
  XF[Xray-core<br/>VLESS REALITY SS Trojan]
  W --> XF
  M --> XF
  L --> XF
  A --> XF

OS	System proxy	TUN / VPN	Kill switch	Secure Share
Windows	Yes	Admin TUN	Windows Firewall	Yes
macOS	Yes	Tun docs / elevated	TUN `strict_route`	Yes
Linux	GNOME/KDE/XFCE	Elevated TUN	TUN `strict_route`	Yes
Android	N/A (VpnService)	Always (VPN)	VPN hold	Yes
iOS	Not shipping	—	—	—

Project structure

flowchart TB
  subgraph src [src/]
    Core[v2rayF.Core<br/>models, Xray config, stores]
    UI[v2rayF<br/>Avalonia UI + ViewModels]
    Desk[v2rayF.Desktop<br/>Windows macOS Linux]
    And[v2rayF.Android<br/>VpnService + libxray]
  end
  UI --> Core
  Desk --> UI
  And --> UI
  Desk --> Core
  And --> Core
  Scripts[scripts/ packaging] --> Desk
  Scripts --> And
  CI[.github/workflows] --> Scripts

v2rayF/
├── src/
│   ├── v2rayF.Core/      # Shared models & services (Xray, parsing, stores)
│   ├── v2rayF/           # Shared Avalonia UI (ViewModels, Views)
│   ├── v2rayF.Desktop/   # Desktop entry + bundled cores/
│   └── v2rayF.Android/   # Android entry + VPN services
├── scripts/              # Packaging & launch scripts
├── .github/workflows/    # CI + release automation
├── docs/                 # User guides and tips
└── llms.txt              # Machine-readable project summary for LLMs

FAQ (search & assistants)

What is v2rayF?
A cross-platform GUI client for Xray-core that speaks VLESS, VMess, Shadowsocks, Trojan, and SOCKS on Windows, macOS, Linux, and Android.

Is v2rayF a VPN?
It can run in TUN / VPN mode (full-device capture) or set the system HTTP proxy. The data plane is still your Xray outbound (e.g. VLESS+REALITY), not a proprietary VPN protocol.

Does it support VLESS REALITY?
Yes. Import vless:// links with REALITY (security=reality, pbk, sid) and optional Vision (flow=xtls-rprx-vision). Vision also works with security=tls. Transports include TCP, WS, gRPC, H2, HTTPUpgrade, xHTTP, mKCP, and QUIC.

How do I stop DNS leaks?
Enable DNS through proxy (default in Sentinel profile) and prefer TUN/VPN mode. On Windows, enable the kill switch so clearnet is blocked if the core drops.

How is this different from v2rayN / v2rayNG / Hiddify?
v2rayF focuses on one Avalonia codebase across desktop + Android, Smart Connect / multipath, and an explicit Sentinel leak-shield profile with Secure Share for LAN clients.

Build from source

Requirements

.NET 10 SDK
PowerShell 7+ (for packaging)

Run in dev (desktop)

git clone https://github.com/drmikecrypto/v2rayF.git
cd v2rayF
dotnet run --project src/v2rayF.Desktop/v2rayF.Desktop.csproj

Place xray / xray.exe in src/v2rayF.Desktop/cores/ for local connects, or run the packager (downloads Xray automatically):

pwsh -File scripts/package-all.ps1

Build Android APK

Requires the .NET Android workload:

dotnet workload install android
pwsh -File scripts/package-android.ps1      # download Xray for Android assets
pwsh -File scripts/package-android-release.ps1

Output: dist/v2rayF-android-arm64.zip containing the signed-ready APK.

Contributing

Contributions are welcome! See CONTRIBUTING.md.

Legal & credits

Licensed under MIT.
Uses Xray-core (bundled in releases, not committed to this repo).
UI built with Avalonia UI.

Use only on networks and servers you are authorized to access. Circumventing restrictions may be illegal in your jurisdiction.

Discoverability

Official homepage for downloads: github.com/drmikecrypto/v2rayF/releases/latest

Related topics: v2ray · xray · vless · vmess · reality · shadowsocks · trojan · proxy · vpn-client · tun · kill-switch · dns-leak · anti-censorship · avalonia · android · windows · linux · macos

Name		Name	Last commit message	Last commit date
Latest commit History 25 Commits
.github		.github
docs		docs
scripts		scripts
src		src
.gitattributes		.gitattributes
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
CONTRIBUTORS.md		CONTRIBUTORS.md
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
global.json		global.json
llms.txt		llms.txt
v2rayF.slnx		v2rayF.slnx

Navigation Menu

Repository files navigation

v2rayF — Cross-platform V2Ray / Xray proxy & VPN client

Why v2rayF?

Architecture

Download

Features

Quick start

Platform support matrix

Project structure

FAQ (search & assistants)

Build from source

Requirements

Run in dev (desktop)

Build Android APK

Contributing

Legal & credits

Discoverability

About

Releases

Packages

Contributors

Languages

Folders and files

Latest commit

History

Repository files navigation

v2rayF — Cross-platform V2Ray / Xray proxy & VPN client

Why v2rayF?

Architecture

Download

Features

Quick start

Platform support matrix

Project structure

FAQ (search & assistants)

Build from source

Requirements

Run in dev (desktop)

Build Android APK

Contributing

Legal & credits

Discoverability

About

Topics

Resources

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages