Project V clients and setup resources

v2flyNG Download
V2Ray Client Guides

Organized v2rayN desktop and v2rayNG and v2flyNG Android client download links, with real settings explained for subscription groups, system proxy, TUN mode, routing rules, and core selection. Covers the full path from first import to protocol selection.

Free forever Open source Xray · V2Fly English documentation

CLIENT SETTINGS

Understand client features through real settings

System proxy, subscription groups, routing rules, and cores are not independent switches. Understand the layer each one controls, then configure them for your device and use case to avoid successful imports followed by unexpected connection behavior.

PROXY MODE

Use system proxy and TUN mode at different layers

System proxy mainly affects browsers and desktop apps that read the operating system's proxy settings. When enabled, the client writes the proxy address for the current user. TUN mode operates closer to the network interface and can handle apps without proxy settings. More is not always better: start with system proxy for regular web browsing and developer tools; enable TUN only when a specific app ignores system settings, after checking permissions, DNS, and routing. After switching modes, confirm that the intended server is active so an enabled switch does not leave you without a usable outbound.

  • Start with system proxy to verify the basic connection
  • TUN mode requires attention to both permissions and DNS
  • Global, rule-based, and direct modes determine the final traffic path

PLATFORM ENTRIES

Choose the client package for your operating system

v2rayN is the primary choice for desktop platforms. On Android, choose between v2rayNG and v2flyNG based on core requirements. Platform links open the matching tab on the download page, where package types, architecture options, and system requirements are listed.

Windows

v2rayN · Desktop / WPF

Windows offers the v2rayN desktop edition and the classic WPF edition. The desktop edition uses a cross-platform interface for standard installations, while WPF retains the traditional Windows layout. Choose based on your environment and preferences; there is no need to install both interfaces.

Go to downloads

macOS

v2rayN · ARM64 / x64

On macOS, use the v2rayN desktop client. Packages are split between Apple Silicon and Intel processors. The architecture must match your device; if unsure, check the chip name in System Information, then choose the corresponding ARM64 or x64 package.

Go to downloads

Android

v2rayNG · v2flyNG

On Android, v2rayNG with the Xray core is the usual choice; choose v2flyNG when you need the V2Fly implementation. Most newer phones use ARM64 packages, while the universal package is intended for devices with an unclear architecture or broader compatibility needs.

Go to downloads

Linux

v2rayN · deb / rpm

Linux offers v2rayN deb and rpm packages for x64 and ARM64. Debian and Ubuntu-based systems generally use deb, while Fedora and RHEL-based systems generally use rpm. Before installing, also confirm the desktop environment and processor architecture.

Go to downloads

QUICK START

Three steps from installation to a working connection

You do not need to change every advanced option during first-time setup. Import, select, and connect first; add TUN, routing, and protocol settings based on the apps you actually use. This keeps troubleshooting focused.

  1. 01

    Install the client and verify the environment

    Open the download page for your platform and choose a package by operating system and processor architecture. On Windows, choose between the desktop and WPF editions; on macOS and Linux, verify the architecture; on Android, choose v2rayNG or v2flyNG according to the required core. After the first launch, confirm that the main interface, tray entry, or background service appears normally before importing a configuration.

  2. 02

    Import a subscription or a single share link

    Add a subscription URL to a subscription group, then run one manual update. Single vmess://, vless://, or trojan:// links can be imported from the clipboard. After importing, check that entries appear, the protocol name matches, and filters have not hidden the server. QR codes and the clipboard are only input methods; the client ultimately converts them into readable configuration fields.

  3. 03

    Select a server and set the proxy mode

    Select a configuration from the list as the active server, then start with system proxy for a basic test. Once browsers and common apps behave normally, decide whether you need rule-based, global, or TUN mode. If the connection does not work as expected, check separately that the server is active, proxy mode is effective, the system clock is accurate, and protocol and transport parameters match as a set.

View the complete guide →

OPEN ECOSYSTEM

The relationship between Project V, V2Fly, and Xray

Understanding the roles of the client, core, and protocol matters more than memorizing where a button is. The interface manages settings, the core executes them, and subscriptions deliver configurations.

From Project V to the community core family

Project V established a tool ecosystem centered on configuration-driven design, multiple inbounds and outbounds, and composable transports. As community maintenance evolved, V2Fly continued the general proxy core and configuration model, while Xray extended a similar model with additional protocol and transport capabilities. Both share concepts such as inbounds, outbounds, routing, and DNS, but the selected core's capabilities determine the available fields, transports, and extensions.

This family relationship explains why different clients can show similar server fields without supporting exactly the same options. Client forms only convert user input into core configuration. When a feature belongs to a specific core extension, another core may recognize the base protocol but still be unable to process the corresponding security layer or flow-control parameters.

v2rayN: a desktop interface for multi-core configuration

v2rayN targets Windows, macOS, and Linux desktops, handling subscriptions, server editing, system proxy, TUN, routing rules, and core execution. It suits users who manage multiple subscription groups, inspect runtime logs, switch routing modes, and tune protocol details. Because the desktop interface is separate from the underlying core, upgrading the client interface, switching cores, and updating subscriptions are three different actions, not one combined operation.

v2rayNG and v2flyNG: choosing a core behind a similar interface

v2rayNG is a widely used Android client built around the Xray core, suitable for configurations using Xray capabilities such as VLESS, REALITY, and XTLS Vision. v2flyNG uses the V2Fly core and serves configurations from that ecosystem. Both support subscriptions, share-link imports, routing, and connection controls, but their different cores mean different extension support. Choose according to the protocol, transport, security type, and flow-control parameters specified by the configuration source, not just the interface name.

Open-source licensing and community updates

The three clients and their cores are maintained by open-source communities. Code changes, fixes, and feature development follow each project's chosen open-source license. Open source makes configuration structures and implementation logic available for public discussion, allowing different clients to build their own interfaces around shared protocol concepts. For users, the practical approach is to check release notes, core compatibility, and migration guidance rather than treating client updates, core updates, and subscription updates as the same thing.

Client updates usually change the interface, platform support, and management features. Core updates mainly affect protocol implementations, transport behavior, and runtime stability. Subscription updates only refresh the server configuration list. When something goes wrong, identify the responsible layer before deciding what to update or roll back; this avoids changing several variables before the cause is known.

COMMON QUESTIONS

Common first-time setup questions

These questions focus on subscription imports, proxy modes, and protocol matching. Follow the step-by-step Getting Started guide for the full process.

Why is the list empty after importing a subscription?

Run a manual update in the subscription group first and check whether the client reports a format or network error. Then verify that the URL actually returns subscription data and has not been excluded by filters. Do not mistake a web page describing the subscription for the subscription data URL.

View the subscription import steps →

Should I use system proxy or TUN mode?

Start with system proxy for a basic check; it works well for apps that read the operating system's proxy settings. Enable TUN only when a specific app ignores the system proxy, and only after checking its permission, DNS, and routing requirements.

View proxy mode details →

Why can the configuration be imported but not connect?

Successful import only means the format can be parsed; it does not mean the protocol parameters match completely. Check the protocol, address, port, user ID, transport, security type, SNI, flow control, and related fields, and confirm that the system clock is accurate.

View the protocol handbook →

How should I choose between VMess, VLESS, and Trojan?

The choice depends on the protocol and transport combination provided by the server; the client cannot convert it without server-side support. VLESS is often paired with modern transports and Xray extensions, VMess is Project V's classic protocol, and Trojan uses a different authentication model.

View the protocol comparison →

TECH NOTES

Client and protocol technical notes

From installation details and subscription formats to protocol handshake flows, these articles address specific questions and are useful after basic setup is complete.