Client installers

V2Ray client downloads and platform selection

Choose v2rayN, v2rayNG, or v2flyNG based on your operating system, processor architecture, and workflow preferences. Verify the platform and architecture before downloading to avoid installation failures and duplicate downloads.

Free forever Open source Graphical clients Chinese configuration guides
Downloads by platform

Choose your device platform

Switching platforms displays the corresponding client, installer type, and system requirements. Version text comes from the same-source version list; if network requests are unavailable, the page still retains the current installer entry point.

Windows client

v2rayN Desktop and classic WPF versions

Both installers are v2rayN. The Desktop version uses a newer cross-platform UI with a more consistent layout, while the classic WPF version retains the established Windows workflow. For a first installation, try the Desktop version first; if you prefer the familiar interface, continue with WPF.

v2rayN
Top pick

v2rayN

7.24.1

A graphical client for the Windows desktop with subscription management, routing modes, system proxy, TUN mode, and log viewing. After installation, import servers in bulk with a subscription URL or add an individual configuration manually.

Desktop version

A newer cross-platform UI for first-time installations and users who prefer a consistent interface.

Download Desktop version
Classic WPF version

A familiar Windows interface and menu layout for users comfortable with the traditional workflow.

Download classic WPF version

Windows requirements and selection guide

Check Recommendation Details
Processor architecture x64 For common 64-bit Intel and AMD Windows PCs.
Installation permissions Allow writing to the application directory Managed devices may require administrator approval. Close any older version before installing.
Version choice Desktop version preferred The Desktop version suits new users; the WPF version suits users who prefer the classic Windows interface.
Selection guide

Client, architecture, and package format

These three criteria are independent: the client determines the interface and core path, the processor architecture determines the binary type, and the package format determines how the system installs it. Confirm them in order for a clearer choice.

01

Choose the client for your device first

Use v2rayN on Windows, macOS, and Linux desktops; for regular Android use, choose v2rayNG, and choose v2flyNG when you need the V2Fly core. Do not identify the platform by similar names alone: clients in the same ecosystem target different operating systems and interaction models.

02

Then confirm the processor architecture

x64 is common on Intel and AMD desktop PCs; arm64 is common on Apple M-series Macs, recent Android devices, and some ARM Linux devices. With a mismatched architecture, the installer may refuse to run or the system may report that the app is incompatible with the device.

03

Finally confirm the package format

This page provides compressed installers for Windows, dmg for macOS, apk for Android, and deb or rpm for Linux depending on the distribution. The file format only describes installation; it does not indicate different client features. Core settings remain consistent for the same client.

A simplified choice when unsure

Choose v2rayN Desktop for Windows; v2rayN Apple Silicon for an Apple M-series Mac; v2rayNG arm64 for a recent Android phone; and v2rayN x64 deb for an Ubuntu x64 desktop. If installation fails, return to the device information and verify the architecture and system version.

View the client comparison
After installation

From installer to first connection

Installation is only the first step. Next, import a subscription or individual configuration, update the server list, choose a proxy mode, and check the connection status.

  1. 1

    Finish installation and open the client

    Install the app according to your operating system’s prompts. When updating an older version, exit the running client first to prevent configuration files from being written. On first launch, familiarize yourself with subscriptions, the server list, routing modes, and logs; there is no need to change every advanced setting immediately.

  2. 2

    Import a subscription or individual configuration

    A subscription URL is useful for managing multiple servers in bulk, while an individual share link suits temporary additions. After importing a subscription, update it and confirm that server entries appear in the current group. If the list is empty, check that the subscription URL is complete and review the active filters.

  3. 3

    Choose a server and proxy mode

    Select a target server from the list, then set the system proxy or routing mode for your use case. When starting out, keep the client’s standard routing option; after becoming familiar with the connection flow, adjust bypass rules, per-app proxy, or TUN mode as needed.

  4. 4

    Connect and review the logs

    After starting the connection, watch the status bar and logs. If a webpage does not load as expected, first confirm that the client is running, a server is selected, and the system proxy is active; then review timestamps, network messages, and configuration hints in the logs. Change one setting at a time to make issues easier to isolate.

View the complete quick-start guide Read the system guides
Updates and migration

Keep your configuration and avoid repetitive setup

Client upgrades usually do not require recreating every subscription, but configuration locations and permission handling vary by system. Organize things briefly before updating to make restoration smoother.

Note your subscription groups

Users with multiple subscriptions should confirm each group’s name, update URL, and filter rules. If the server count looks unusual after an upgrade, check the active group and keyword filters before adding the subscription again.

Record the routing mode

System proxy, bypass mainland China, global routing, and custom routes affect the access path used by different apps. Record the current mode before updating; restore it afterward before judging whether connection behavior has changed.

Close the old process

Exit the old client before installing the new version and confirm that its tray process has ended. This prevents application files from being locked and allows the new version to read existing configuration completely at startup.

Common download questions

Choosing an installer and completing first-time setup

These questions cover version selection, processor architecture, Android client differences, and Linux package formats.

Should you choose the v2rayN Desktop or classic WPF version on Windows?

The Desktop version uses a newer cross-platform interface for users who prefer a modern UI and consistent workflows. The classic WPF version retains the familiar Windows interface for users accustomed to traditional menus. Both are v2rayN; choose based on your interface preference.

How do you identify Apple Silicon or Intel on macOS?

Open “About This Mac” from the system menu and check the Chip or Processor section. If it shows an Apple M-series chip, choose the Apple Silicon installer; if it shows Intel, choose the Intel installer.

Should you download the arm64 or universal version on Android?

Most mainstream Android phones released after 2015 should use arm64 first. If you cannot confirm the processor architecture, or the arm64 installer will not install, use the universal version instead.

How should you choose between v2rayNG and v2flyNG?

Android users should generally start with v2rayNG, which uses the Xray core. Choose v2flyNG when you need the V2Fly core or an existing configuration specifically requires its behavior.

Should you choose deb or rpm on Linux?

Debian, Ubuntu, and derivatives generally use deb; Fedora, RHEL, and derivatives generally use rpm. You must also choose x64 or arm64 based on the device processor.

How do you start configuring the client after installation?

Prepare a working subscription URL or individual server configuration, import it into the client, update the list, select a server and proxy mode, then connect. First-time users can continue with the quick-start guide.

Download v2rayN