v2rayN · v2rayNG · v2flyNG

Download V2Ray clients

Choose v2rayN for desktop and v2rayNG for Android.
Check your operating system and architecture before downloading.

Free forever Open source Subscription setup guide →

Downloads are listed by platform below. You will still need a valid subscription or a manual configuration after installing the client.

01 / PACKAGEConfirm your platform and architecture

Desktop / WPF · arm64 / x64

02 / CONFIGAdd and update a subscription

Subscription group · Select a configuration

03 / MODEEnable the proxy as needed

System proxy · VPN mode · TUN

Choose a package by platform

You do not need to download every architecture build of the same client. Select your operating system, then check the architecture listed on the card. Install only when both the package format and system architecture match.

Windows · v2rayN

v2rayN

Recommended 7.24.1

Windows x64 downloads. For a first install, choose Desktop. Choose WPF if you prefer the classic Windows interface.

Download Desktop · x64

A modern cross-platform UI for first-time installs and users who want a consistent desktop experience.

Download classic WPF · x64

A stable classic edition with the familiar Windows interface. Choose it if you prefer the traditional workflow.

Choosing between Desktop and WPF; where to install

Desktop and WPF mainly differ in their interface technology and layout. They do not deliver different network performance when using the same subscription. Whether a subscription works depends on its configuration, core support, and network conditions. If you already have a working setup, back it up before trying the other edition. This keeps interface migration separate from subscription troubleshooting.

The download is a ZIP archive. Extract all files to a writable folder, then run the installer or client included in the package. Do not launch it from your archive utility's temporary folder. If Windows reports a missing runtime dependency, install the required component as prompted. Avoid moving individual program files, as other files in the same folder may be needed.

Windows system and installation requirements

Check	Selection and requirements
System architecture	Both downloads on this page are x64. Check your system type in Windows Settings.
Windows version	Check the current release's system support notes before installing. Older Windows versions may also require specific runtime components.
Install location	Extract all files, preserve the folder structure, and make sure the configuration folder is writable.
Proxy connection	For browser use, start by configuring the system proxy. Enable TUN only if needed; it may require administrator privileges.

After installing, import and update a subscription, select a configuration, then enable “Set system proxy automatically.” If the core has not started successfully, changing the system proxy setting alone will not create a working connection. Restore the system proxy before quitting to prevent your browser from pointing to a stopped local service.

View Windows setup instructions →

macOS · v2rayN

v2rayN

7.24.1

Check the chip in About This Mac: choose Apple Silicon if an Apple chip is listed, or Intel if an Intel processor is listed.

Download Apple Silicon · arm64

For Apple Silicon devices. Choose the native architecture build that matches your chip.

Download Intel · x64

For Intel-based devices. Do not identify your processor based only on the computer's appearance or purchase year.

Installing from a disk image and first launch

Open the DMG and move the app to the Applications folder before launching it. Avoid running the client from the mounted disk image, as updates, file paths, and permissions may behave differently. If macOS blocks the first launch, read the alert and confirm the app's source before following the prompts in Privacy & Security. Do not disable system protections entirely.

After importing a subscription, make sure the client can start its service before configuring the system proxy. The system proxy directs apps that use that setting to a local port; it does not automatically cover every app. If you need to route more app traffic, learn how TUN permissions and routing work. You usually do not need multiple connection methods for ordinary browser use.

macOS system and installation requirements

Check	Selection and requirements
Processor	Choose arm64 for Apple Silicon and x64 for Intel.
Windows version	Check that the current release supports your macOS version. A matching architecture alone does not guarantee compatibility with older systems.
Installation	Open the DMG, copy the app to Applications, then launch it.
System permissions	Follow system prompts for proxy settings and TUN-related actions. Check what each requested permission is for before approving it.

If the interface opens but the service will not start, check the client logs instead of immediately trying a different chip version. Architecture mismatches, OS version restrictions, and invalid configuration fields are separate issues. Save the original error message and narrow down the cause one step at a time.

View macOS setup instructions →

Android · v2rayNG / v2flyNG

v2rayNG

Recommended 2.2.6

Android GUI client powered by the Xray core. Choose arm64 for most devices; consider the universal build if you cannot confirm your architecture.

Download v2rayNG · arm64

The usual choice for mainstream phones released since 2015, provided the OS supports 64-bit apps.

Download v2rayNG · Universal

Supports multiple processor architectures. Use it if your device architecture is unclear or the specific build is incompatible.

Installation permissions and subscription setup

Open the downloaded APK with the system installer. If prompted to allow installs from this source, grant permission only to the browser or file manager you are using. You can revoke it after installation. If Android says “App not installed,” check that the download completed, the architecture matches, and no app with the same name but a different signing key is already installed.

To import a v2rayNG subscription, add its link to a subscription group and update it. For a single configuration, use the client's clipboard import option if available. Do not paste a full subscription link into a public converter site or include it in screenshots shared for support. Approve the system VPN connection prompt when starting the client, choose a suitable routing mode, and check background activity restrictions if needed.

v2flyNG

Alternative 1.10.31

An alternative Android client powered by the V2Fly core. Choose it if you specifically need this core and your configuration is compatible.

Download v2flyNG · arm64

The same selection rule applies: first confirm that your device OS supports arm64 apps.

Download v2flyNG · Universal

For devices that need multi-architecture support. Check available storage before installing.

Core compatibility and switching clients

v2flyNG and v2rayNG have similar interfaces, but that does not mean they support exactly the same configuration fields. For features such as REALITY, check support in the relevant core. Reimporting an incompatible configuration or changing only the APK architecture usually will not resolve a protocol support issue.

Before switching Android clients, stop the current VPN service, then start the other client. Android generally allows only one standard VPN service to be active at a time. If another VPN app is handling the connection, stop its service first. Keep a record of your subscription source and routing settings; moving them over one at a time makes issues easier to diagnose than running multiple clients at once.

Android system and installation requirements

Check	Selection and requirements
App architecture	Choose arm64 on systems that support 64-bit apps; consider the universal build if you are unsure.
OS compatibility	Check the minimum OS version required by the APK. If the installer reports incompatibility, verify your Android version first.
Required permissions	Install-source permission allows the APK to be installed; VPN permission lets the client start its proxy service.
Background activity	If the connection drops when the screen turns off, check battery optimization, background activity restrictions, and whether another VPN app is in use.

Check the processor model, OS bitness, and the client's minimum OS version separately. Even a newer processor may run a restricted OS environment, so a recent phone model is only a guide, not a substitute for checking actual compatibility.

View Android setup instructions →

Linux · v2rayN

v2rayN

7.24.1

Linux GUI client. Check your distribution's package format and processor architecture. The main downloads below are x64.

Download deb · x64

For distributions that use the deb package system, including Debian- and Ubuntu-based desktop systems.

Download rpm · x64

For rpm-based systems that meet the package's dependencies. Review the package manager's messages before installing.

arm64 device downloads

Download deb · arm64 → Download rpm · arm64 →

Matching package format does not guarantee compatible dependencies

deb and rpm identify package formats; they are not universal labels for every Linux distribution. Even rpm-based systems may differ in their base libraries, desktop components, or release versions, which can prevent installation. Open the package with your system's software installer or package manager and review the dependency results. Changing a file extension will not convert one package format into another.

The GUI client requires a working desktop session. After installation, launch it from the application menu, import your configuration, and check the core logs before choosing the system proxy or TUN. Desktop environments differ in how they handle system proxy settings, and some apps have their own network settings. For TUN, check the required permissions and routing policy. Avoid running the entire desktop client with elevated privileges indefinitely.

Linux system and installation requirements

Check	Selection and requirements
Processor architecture	Common names for x64 include amd64 and x86_64; arm64 is often called aarch64.
Package management	Choose deb or rpm based on your distribution, and check the package's specific dependencies.
Runtime environment	A working graphical desktop session, plus the runtime components and system libraries required by the package.
Network connection	First confirm the local service starts, then configure the desktop proxy. Set up TUN according to its permission and routing requirements.

If the app does not appear in the application menu, check that installation completed and the package was installed successfully. If the interface works but the connection fails, investigate the configuration, ports, and routes instead of reinstalling the package repeatedly.

View Linux setup instructions →

After installation: subscriptions and proxy modes

Installing the client gives you a tool for managing configurations and starting a service. Subscriptions, routing rules, and how traffic connects to the system still need to be set up separately.

View the subscription and connection guide →

Subscription group: Add link → Update subscription
System proxy: Set system proxy automatically
TUN mode: Enable if required by your apps
Android: Approve the VPN connection

First install and update checklist

Check installation, configuration, and traffic routing separately. Confirm each step before moving on to make issues easier to pinpoint than changing several settings at once.

First install: configure first, then route traffic

Get a valid V2Ray subscription link, add it to a subscription group, and update the group. Subscription links and single-configuration links serve different purposes, so use the appropriate import option. If no entries appear after updating, check the link type, access requirements, and client logs. Repeatedly enabling global proxy will not fix an import problem.

Select a configuration and make sure the service starts normally. Then set up the system proxy or VPN mode for your platform. Browsers and other apps may use different network settings, so access in one app does not mean all apps follow the same route. If you need to change traffic routing, note the current rules and adjust them one at a time.

View the complete getting started guide →

Updating the client: keep settings you can restore

Before updating, back up subscription groups, manual configurations, custom routes, and DNS settings, and note the local listening ports. Stop the service and quit the old client before installing or replacing it. After updating, check that your configurations load and the core starts before restoring the system proxy or other connection modes.

Updating the client and updating a subscription are separate tasks: the first replaces the program and related components, while the second refreshes configuration entries. If a subscription update fails, check the source and error message rather than assuming the installer is outdated. Logs and screenshots may contain configuration credentials; remove sensitive details before sharing.

View installation and update troubleshooting →

Download and installation FAQs

Windows Desktop or classic WPF: which should you choose?

For a first install, try Desktop, which uses a modern cross-platform interface. Classic WPF retains the familiar Windows workflow and may suit users accustomed to it. Both editions require a valid configuration. Back up subscription groups and routing settings before switching, and avoid having both clients manage the system proxy at the same time.

For Android, should you download arm64 or the universal version?

Most mainstream phones released since 2015 can use arm64, but make sure the operating system supports 64-bit apps. A 64-bit processor does not guarantee 64-bit OS support. Choose the universal build if you cannot confirm the device architecture or arm64 is reported as incompatible. It supports multiple architectures and is usually larger.

Why is there no usable configuration after installing the client?

The client imports configurations, runs the proxy, and manages routing; the installer does not include a subscription service. Add and update a subscription link you manage or are authorized to use, then select a configuration. On desktop, enable the system proxy if needed; on Android, approve the system VPN connection.

What if the architecture shown on the download button does not match my system?

Use your operating system's architecture and package format as your guide. On macOS, check About This Mac to distinguish Apple Silicon from Intel. On Linux, confirm x64 or arm64 and whether your distribution uses deb or rpm packages. The Windows downloads on this page are x64 and are not native installers for other architectures.

Which settings should I keep before updating the client?

Back up subscription groups, manual configurations, custom routes, and DNS settings. Then stop the service and quit the old client. After upgrading, check that your configurations are still available and that the core starts correctly. Never share backups publicly if they contain subscription links or identity details.

What should I check if a download fails or the file will not install?

Make sure the download is complete, there is enough disk space, and the package matches your system. On Android, check the architecture, permission to install from the selected source, and any signing conflict with an existing app. On desktop, review system alerts and runtime dependencies. If a download link is temporarily unavailable, try again later; changing the file extension will not fix an installation problem.