CLIENT PACKAGES

V2Ray Client Download and platform installers

Choose a package by operating system, processor architecture, and interface type. Use v2rayN on desktop platforms; on Android, choose between v2rayNG and v2flyNG based on the required core.

Four platforms Free forever Open source Chinese configuration guides

PLATFORM SELECTOR

Choose an operating system

Switch platforms first, then compare the device architecture and package format. The page preserves the platform anchor, so refreshing or sharing the link still returns to the selected tab.

Windows installers

v2rayN offers a Desktop version and a classic WPF version. Both target x64 and mainly differ in interface technology and layout.

v2rayN

v2rayN Recommended

Windows · x64 · 7.24.1

Desktop version: Uses a modern cross-platform interface with a structure, settings navigation, and overall experience more consistent with other desktop systems. It suits first-time v2rayN users and those who prefer the current desktop direction.

Classic WPF version: Retains the traditional Windows client layout. Navigation for server lists, subscription groups, system proxy, and routing settings follows familiar older workflows, making it suitable for users accustomed to the classic interface.

Both options target 64-bit Windows. If the device runs current Windows desktop apps normally, start with the Desktop version. If existing tutorials, configuration steps, or habits rely on the WPF interface, the classic WPF version makes menu locations easier to follow.

Windows requirements and selection criteria

Check Details Recommended choice
Processor architecture Both installers on this page target 64-bit x86 processors. x64
Interface type The Desktop version uses a cross-platform interface; the WPF version uses the classic Windows interface. Desktop version for new users
Installation format After downloading the ZIP file, extract it completely before running the installer from the extracted folder. Do not launch it inside the archive
Permissions A standard system proxy normally runs under a regular user account. System-level network changes may prompt for administrator approval. Grant permissions when prompted

PACKAGE DECISIONS

Architecture and format in the package name

When installation fails, first check the platform, processor architecture, and file format. They answer three separate questions: which system will run it, which processor instruction set is used, and which installer handles the package.

01

x64, amd64, and x86_64

On this page, all three names refer to common 64-bit x86 desktop processor environments. Windows buttons use x64, Debian packages usually use amd64, and RPM packages usually use x86_64. The names come from different platforms and package systems; they do not represent three incompatible processor families.

02

arm64, aarch64, and arm64-v8a

All three names relate to 64-bit ARM architectures, but they are used in different contexts. macOS and deb packages commonly use arm64, RPM packages use aarch64, and Android APKs use arm64-v8a. Choose from the download option for the current platform; do not cross-install a file from another platform merely because the architecture matches.

03

DMG, APK, deb, and rpm

DMG is a macOS disk image, APK is handled by the Android installation process, and deb and rpm serve different Linux package systems. The file extension determines the installation method, while the architecture determines whether the program can run on the processor. Both must match.

04

arm64 versus universal

Android arm64 packages contain only the program components required by the target architecture and suit most mainstream phones. The universal version covers more architectures and is useful when the architecture is unknown or the same installer must be kept across devices. If the device is confirmed to be 64-bit ARM, prefer arm64.

AFTER DOWNLOAD

Installation and first-time setup

Completing installation does not establish a connection. The client still needs a subscription or share link, a selected server, and proxy mode settings.

  1. Confirm the platform, architecture, and package format

    First check that the downloaded file matches the current platform tab. Choose an x64 ZIP for Windows, a chip-matched DMG for macOS, an arm64 or universal APK for Android, and both the distribution package format and processor architecture for Linux. If the system cannot handle the file type, recheck the platform or package format instead of repeatedly opening the same installer.

  2. Complete the system installation

    Extract the Windows ZIP completely first; open the macOS DMG and install through the system interface; open the Android APK and confirm the installation source when prompted; use the distribution’s package tool for deb or rpm on Linux. System-level network settings may request permission, which is normal when proxy mode writes network configuration.

  3. Import a subscription or individual share link

    After launching the client, add a valid subscription URL in the subscription group and update it, or import an individual vmess:// or vless:// share link from the clipboard. A subscription maintains a refreshable set of server entries, while a share link usually describes one entry. If the list is empty after import, update the subscription manually and check the URL format and network access.

  4. Select a server and proxy mode

    Choose the active configuration from the server list, then enable system proxy or TUN mode as needed. System proxy mainly affects applications that follow the operating system proxy settings. TUN mode uses a virtual network interface to handle a broader range of connections and usually requires extra system permission. For first-time setup, start with system proxy, verify that the configuration loads correctly, then adjust routing and TUN.

DOWNLOAD FAQ

Common installer questions

Concise answers about version selection, processor architectures, client differences, and first launch.

Should you download the v2rayN Desktop or WPF version for Windows?

The Desktop version uses a modern cross-platform interface and suits first-time installs or users who want a consistent desktop experience. The WPF version retains the classic Windows interface and workflow for users familiar with the older layout. Both use x64 packages, and the core concepts for subscriptions and servers are the same, but menus and interface organization differ.

How do you choose between the Apple Silicon and Intel installer on macOS?

Open About This Mac from the system menu and check the chip or processor entry. Choose the Apple Silicon arm64 version for an Apple M-series chip, or the Intel x64 version for an Intel processor. A mismatched architecture commonly causes the app not to launch or the system to report incompatibility.

Should you download the arm64 or universal Android version?

Most mainstream Android phones released after 2015 should use the arm64-v8a package first because it targets common processor architectures. Use the universal version if the architecture is unknown, the device is older, or the arm64 package cannot be installed. Universal does not add features; it supports more processor architectures.

How should you choose between v2rayNG and v2flyNG?

v2rayNG uses the Xray core and supports a broad range of protocols and transport options, making it the recommended Android choice. v2flyNG uses the V2Fly core and suits users with existing V2Fly configurations or a need to preserve its behavior. Base the choice on subscription parameters, protocol type, and required transport features; there is no need to run both clients long-term on one device.

Should you download a deb or rpm package for Linux?

Choose deb for Debian, Ubuntu, and derivatives; choose rpm for Fedora, RHEL, Rocky Linux, AlmaLinux, and other RPM-based distributions. Then run uname -m to identify the architecture: x86_64 maps to amd64 deb or x86_64 rpm, while aarch64 maps to arm64 deb or aarch64 rpm.

Why can’t a connection be established immediately after installing the client?

The installer provides only the graphical interface and runtime components. After the first launch, import a valid subscription or individual share link, update the server list, select a server, and enable system proxy or TUN mode as needed. If the server entry is already imported but no connection is established, check the selected entry, system time, proxy mode, and routing settings.

NEXT STEP

Continue configuring the client

After installation, open Getting Started for complete steps covering subscription import, server selection, system proxy, TUN mode, and connection verification. To compare VMess, VLESS, Trojan, Shadowsocks, or REALITY configurations, consult the protocol manual and choose based on authentication, transport combinations, compatibility, and resource usage.