Installation guides for three clients across four platforms

V2Ray All-Platform Downloads and v2rayN Configuration Resources

A focused collection of the v2rayN desktop client, the Android clients, and Xray and V2Fly core resources, with step-by-step guidance from package selection and subscription imports to connection mode settings.

Free forever Open source Chinese documentation Subscription and routing guides
04 Supported platforms 03 Graphical clients CORE Xray · V2Fly DOCS Installation · Subscriptions · Routing

CLIENT WORKFLOW

From package selection to routing configuration

The homepage presents four core capabilities in the order they are typically needed. Each section defines its scope first, then points to the relevant guide, making it easier to distinguish clients, cores, protocols, and subscriptions.

Choose the right file by system, processor, and package format

v2rayN is the main desktop entry point, but each operating system still has its own packaging requirements. Windows users can choose between the newer desktop interface and the classic WPF interface; macOS users should confirm their processor architecture first; Linux users should select deb or rpm according to their distribution. On Android, v2rayNG is the primary client, while v2flyNG with the V2Fly core is available as an alternative. The download page presents these differences within each platform panel, so users do not need to understand the entire ecosystem first.

View the client list

Turn subscription URLs into a manageable server list

Importing a subscription is more than pasting a URL. The client first needs a subscription group, then an explicit content update, after which you can choose the active connection from the server list. When multiple providers are involved, organize entries with group names, inclusion keywords, and exclusion keywords so you do not have to filter the list again after every update. The guide also distinguishes subscription URLs, individual share links, and native configuration files, explaining how they differ for bulk updates, migration, and manual editing.

View the subscription import steps

Distinguish protocols from execution cores in the client settings

VMess, VLESS, Trojan, Shadowsocks, and REALITY describe different protocols or transport combinations, while Xray and V2Fly are core families that read configuration and establish connections. These concepts are not interchangeable. When choosing, first check the protocol specified by the service configuration, then confirm that the selected client core supports the relevant fields. The technical reference compares them by connection overhead, resource usage, configuration compatibility, and mobile use cases rather than applying one answer to every situation.

Compare protocols and cores

Keep the system proxy, rule-based routing, and direct-connection scope aligned

A connected status only means that the core and local proxy port are running. Whether browsers and other applications use that port also depends on the system proxy, application-specific proxy settings, and routing rules. New users can start with the client's standard system-proxy mode to verify the connection, then gradually add domain, address-range, and process rules. If some applications behave differently, check their settings, the local port, and routing order layer by layer instead of repeatedly changing subscriptions.

View connection mode details

Current guidance

Identify the device first, then choose the interface

Processor architecture determines whether a package can run directly, while interface type affects how the client feels to use; these are separate choices. If you are unsure about a desktop device, check the processor and system type on the system settings “About” page. Android devices generally use arm64 builds first; when the architecture is unclear, choose a universal build. Move on to subscription and connection settings after installation.

PLATFORM DOWNLOADS

Client entry points for four platforms

Each platform entry opens the corresponding panel on the download page. That page lists processor architectures, package types, and client differences; the homepage does not distribute installation files directly.

DESKTOP / 01

Windows

Use v2rayN as the desktop client, choosing between the newer cross-platform interface and the classic WPF interface according to your workflow. x64 is the usual system choice; confirm your Windows version and processor architecture before installation.

Go to Windows downloads

DESKTOP / 02

macOS

Use the macOS build of v2rayN. Choose arm64 for Apple Silicon and x64 for Intel processors. Check the chip name in System Information before opening the matching download entry.

Go to macOS downloads

MOBILE / 03

Android

The primary client is v2rayNG with the Xray core; v2flyNG with the V2Fly core is also available. Most recent devices use arm64, while a universal build is suitable when the device architecture is unclear.

Go to Android downloads

DESKTOP / 04

Linux

Use the v2rayN desktop client, selecting a deb or rpm package for your distribution and choosing between x64 and arm64. After installation, launch it from the application menu, then import subscriptions and configure the system proxy using the desktop guide.

Go to Linux downloads

OPEN SOURCE ECOSYSTEM

How Project V, V2Fly, and Xray relate

Clients, cores, and protocols operate at different layers. Once you understand the relationship, choose a client by device, select protocols by configuration fields, and narrow compatibility issues down to the specific core.

The tool and protocol ecosystem shaped by Project V

Project V initially built a composable network toolkit around the V2Ray core program, configuration structures, and several proxy protocols. Common configurations include inbound, outbound, routing, DNS, logging, and transport layers. Graphical clients do not change these fundamentals; they organize frequently used fields into forms, menus, and subscription management screens to centralize installation, updates, and switching.

In the ecosystem, “V2Ray” is often used to refer to the core program, configuration methods, and a category of clients at the same time, which can blur the concepts. A more precise view is that v2rayN, v2rayNG, and v2flyNG are graphical clients operated directly by users; V2Fly and Xray are core families that execute configurations; and VMess, VLESS, Trojan, Shadowsocks, and others are protocol types visible in client configurations.

The V2Fly and Xray core branches

V2Fly continues the community maintenance direction of V2Ray Core, preserving the mature JSON configuration system while maintaining common inbound, outbound, routing, and transport features. Xray extends some protocol and transport capabilities on a similar configuration foundation. The two share similar structures across many basic fields, but structural similarity does not mean every field can be exchanged directly.

When using subscriptions, the client typically converts share links or subscription content into a configuration that the core can read. If the configuration contains extension fields, the selected client core and its supported field range affect the import result. When an entry cannot be recognized, first confirm its protocol type, transport method, and core support before deciding that the subscription format is at fault.

Open-source licensing and community maintenance

v2rayN, v2rayNG, v2flyNG, and the related cores are maintained through public code and open-source licenses. These licenses define the boundaries for using, modifying, and redistributing code, while enabling configuration formats, protocol implementations, and fixes to receive ongoing review. Each project releases updates through its own maintainers, so client and core release schedules do not always align.

Client updates typically cover the interface, subscription parsing, system-proxy control, route editing, and core integration. Core updates focus more on protocol implementations, configuration fields, transport layers, and runtime behavior. The download page shows current client release information, while the technical reference explains functional differences. Users do not need to chase every change, but before importing newer protocol configurations, they should confirm that the client and core remain within mutually compatible maintenance ranges.

The role of each client

v2rayN targets Windows, macOS, and Linux desktops, offering subscription groups, server lists, system proxy controls, routing rules, and multi-core management. It is the primary choice for desktop devices. The configuration logic is broadly similar across desktop systems, but package formats, system-proxy permissions, and launch behavior vary by platform.

v2rayNG targets Android and is commonly used with the Xray core, making it suitable for mobile devices using common configuration types such as VLESS, VMess, and Trojan. It supports subscription updates, individual share-link imports, QR code scanning, and per-app proxying; available fields depend on the client and core support range.

v2flyNG also targets Android and follows the V2Fly core path. It is suitable when you need V2Fly configuration semantics or want consistency with existing V2Fly configurations. The two Android clients differ in interface and core focus, so base your choice on subscription content and configuration compatibility.

COMMON QUESTIONS

Featured frequently asked questions

Why are there no servers after importing a subscription?

First confirm that the subscription group was saved and updated, then check the URL format, network route, and client support range. Adding a group without updating it will not populate the server list automatically.

View subscription troubleshooting

Which client should desktop users choose?

For Windows, macOS, and Linux, start with v2rayN. After identifying the operating system, choose the processor architecture and package type; there is no need to select a client by protocol name first.

View installation troubleshooting

Why does the browser still use the original network path after connecting?

Check that the system proxy is enabled and that the browser has not overridden the system setting. In rule mode, also check whether the destination was classified as a direct connection by the routing rules.

View connection steps

Are VLESS and Xray the same type?

No. VLESS is a protocol type, while Xray is a core family that executes configurations. The client edits and manages the configuration; the core interprets its fields and establishes the actual connection.

View protocol details

RECENT ARTICLES

Subscription and client guides

Recent articles focus on subscription groups, LAN sharing, and update failures. Each article explains the feature's scope first, then provides the in-client workflow and troubleshooting order.

Advanced

LAN connection settings guide: Share the proxy with other devices on the same network

Explains the LAN connection switches in v2rayN and v2rayNG, how to enter the gateway and port for devices on the same network, and how to manage sharing scope, access control, and when to disable it.

Read the full article
Advanced

Multi-provider subscription management: v2rayN groups and server keyword filters

Learn how to manage multiple service sources in v2rayN and v2rayNG with subscription groups, then organize server lists using inclusion and exclusion keywords to reduce filtering after updates.

Read the full article
Getting Started

What to do when v2rayN subscription updates fail: Five common causes and automatic update settings

Troubleshoot URL validity, network route, proxy port, format compatibility, and system time, with an explanation of automatic update intervals versus manual updates.

Read the full article