CLIENT PACKAGES / CHOOSE A PLATFORM

V2Ray Client Downloads

v2rayN for desktop, v2rayNG and v2flyNG for Android.
Check your operating system and CPU architecture before choosing a package.

Free to use Open source Visual configuration interface

The package installs the client; you'll also need an authorized subscription or server configuration to connect. For your first setup, follow the user guide.

Platforms and Packages

Switch platforms to see the available downloads. macOS is expanded by default; links from other pages open the corresponding platform section.

v2rayN · Windows

Recommended

Latest release 7.24.1

Desktop · x64

Download v2rayN Desktop

A newer cross-platform UI. A good starting point for new users, with unified access to subscriptions, servers, and settings.

Classic WPF · x64

Download v2rayN WPF

The classic, stable version with a traditional Windows interface. Choose this if you're already familiar with WPF.

Both files are ZIP archives. Download and fully extract the archive to a writable local folder, then open the installer and follow the prompts. Don't launch it from the archive preview, and keep the installation folder separate from configuration backups and temporary files.

Windows Requirements and Installation Checks

Check	What to look for	What to do
CPU architecture	This page provides x64 downloads	Check your device architecture under System type in Windows Settings.
Operating system and runtime	Requirements vary by release package	If the installer reports a missing runtime component, check the package notes and Windows update status first.
File access	A writable installation or configuration location is required	Extract the archive fully first. On managed devices, follow your organization's policies.
Proxy access	System proxy and TUN require different permissions	Start by verifying the system proxy, then configure TUN if needed.

Desktop and WPF mainly differ in interface technology and layout, not subscription service levels. Don't migrate an existing setup by copying program files alone. Export or back up your subscriptions, routing rules, and personal settings, then confirm the new version can read them before removing the old folder. Use only one client at a time to manage the system proxy, so one app doesn't clear settings needed by the other when it exits.

After launching for the first time, import and update a subscription. Confirm that servers appear in the list, then choose one. Enabling the system proxy only sets a proxy address in the operating system; it doesn't confirm that a remote connection works. If your browser still can't connect, check the subscription, selected server, client logs, and whether the browser uses the system proxy.

v2rayN · macOS

Recommended

Latest release 7.24.1

Apple Silicon · arm64

Download v2rayN · Apple Silicon

For Macs with Apple M-series chips. Open Apple menu → About This Mac and check the Chip field.

Intel · x64

Download v2rayN · Intel

For Macs that show an Intel processor in About This Mac. Don't infer the architecture from the model name or purchase year.

Open the DMG and drag the app into the Applications folder, then launch it from there. Once installation is complete, you can eject the disk image. Installing the app locally makes updates, system permissions, and the app location easier to manage, and avoids running it from Downloads or a mounted image.

macOS Requirements and Installation Checks

Check	What to look for	What to do
Chip type	Apple Silicon or Intel	Choose based on the chip shown in About This Mac; don't rely on compatibility translation to run the wrong build.
macOS version	Must meet the selected release package's minimum requirements	If macOS is too old, check the package notes instead of repeatedly trying different architecture builds.
Installation location	Applications folder	After copying the app, launch it from Applications, then eject the DMG.
System permissions	Grant permissions as prompted for the selected proxy mode	Configure system proxy and TUN separately. Don't grant broad permissions just to troubleshoot.

If macOS blocks the app on first launch, check the download source, make sure the file finished downloading, and confirm the app was copied to your Mac. Look for the relevant notice in System Settings under Privacy & Security, then follow the instructions macOS provides. Don't disable system-wide security to run a single app. An “app is damaged” warning, an architecture mismatch, and an incompatible macOS version are different issues; troubleshoot each based on the exact message.

After launching v2rayN, add a subscription group and update it, then choose a server. For basic use, start with Set system proxy automatically. Clear system proxy removes the current system proxy settings; Do not change system proxy leaves them as they are. Note your existing settings before making changes, especially on a work network or a device with a manually configured proxy.

The system proxy mainly affects apps that follow that setting. If an app still connects directly, check its own network settings before assuming the client is broken. For broader traffic routing, see the macOS setup and configuration guide for the permissions, DNS, and routing requirements of TUN.

v2rayNG

Recommended · Xray Core

Latest release 2.2.6

arm64 · Recommended

Download v2rayNG · arm64

Most mainstream phones released after 2015 can use arm64. Some devices have different processor capabilities and Android system architectures, so check what your device actually supports.

Universal · Compatibility option

Download v2rayNG · Universal

Choose the universal package if you're unsure of your device's architecture. If the installer reports incompatibility, check the Android version and any existing installation rather than downloading the same package repeatedly.

v2rayNG uses Xray Core and is a good starting point for Android. After installing, add a link under Subscription group settings, save and update the subscription, then select a configuration from the main screen. The first time you connect, Android will show a VPN connection request. Check the app name and request before approving it.

v2flyNG

Alternative · v2fly Core

Latest release 1.10.31

arm64

Download v2flyNG · arm64

For devices that need v2fly Core and support 64-bit ARM. Before choosing this client, confirm that your service configuration supports its protocols and transport options.

Universal

Download v2flyNG · Universal

For devices with an unknown architecture or those that need a universal package. Similar interfaces don't guarantee that advanced settings work the same way in both clients.

v2flyNG is an alternative with a different core; it isn't an add-on for v2rayNG. In most cases, install and run only the client that supports your configuration. To compare their behavior, disconnect the other client first so the two connection services don't replace each other.

Android Requirements and Installation Checks

Check	What to look for	What to do
Architecture	arm64 or universal	For newer mainstream devices, choose arm64 first. If you're unsure, use the universal package.
macOS version	Must meet the selected APK's installation requirements	If you see “There was a problem parsing the package,” check both system compatibility and download status.
Installation permissions	Allow app installs from the current source	Grant permission only to the browser or file manager you're using, and only when needed.
Connection and background activity	VPN permission and background operation requirements	If the connection drops frequently, check battery optimization, background restrictions, and any existing VPN connection.

The Android installer checks package architecture, system requirements, and signatures. If you see “App not installed,” preserve your existing data and check for an app with the same name, as well as whether the old and new packages are from the same distribution channel. Don't uninstall and retry right away; uninstalling may delete subscriptions and custom rules. Export or back up your data in the existing app first.

If the client opens but disconnects when the screen locks, check background restrictions and battery management first. If it connects but only some apps work, review per-app proxy settings, routing rules, and DNS. Troubleshooting installation separately from connection issues is more effective than repeatedly switching clients.

v2rayN · Linux

Recommended

Latest release 7.24.1

deb · x64

Download v2rayN · deb

Debian- and Ubuntu-based distributions generally use deb. The main download here is for x64, often labeled amd64.

ARM devices: Download arm64 deb →

rpm · x64

Download v2rayN · rpm

Fedora- and RHEL-based distributions generally use rpm. Before installing, check that your system meets the package's dependencies.

ARM devices: Download arm64 rpm →

Check your distribution's package format first, then confirm the CPU architecture. Open the downloaded file with your system's software installer to review dependencies and the installation location, then launch the app from your applications menu. Changing a file extension doesn't convert its package format; don't force an installation when dependencies are unmet.

Linux Requirements and Installation Checks

Check	What to look for	What to do
Package format	deb or rpm	Check your distribution's software center and package management system; don't judge by the desktop's appearance.
CPU architecture	CPU architecture	x64 is commonly labeled amd64 or x86_64; arm64 is commonly labeled aarch64.
Desktop and dependencies	A graphical desktop and required system libraries	This page provides a graphical client. The installer must be able to resolve the package's dependencies.
System proxy	Behavior depends on the desktop environment and the app	Check your desktop's network settings. Configure apps that don't use the system proxy separately.

Distributions using the same rpm or deb format may still have different versions of system libraries. An installer recognizing the file doesn't mean it's compatible with your system. If a dependency version is missing, identify it first. Then decide whether to update the system or use a package built for your distribution. Don't install system libraries one by one from unknown sources.

After installation, launch the graphical client as a regular user and import your subscription. Desktop environments handle system proxy settings differently, and not all apps use them. If your browser works but other apps don't, check their individual proxy settings. TUN also involves network permissions, routing, and DNS. Configure it separately after confirming the basic connection to keep troubleshooting manageable.

AFTER INSTALLATION

Setup Steps After Installation

Get a subscription or shared link

Make sure the link comes from a service you're authorized to use. Subscription URLs and individual shared configuration links are different. The client doesn't include a working remote server. A full subscription URL may contain credentials, so store it separately from ordinary web bookmarks.

Import and update the configuration

Add the URL under subscription groups, save it, then update the subscription. Saving the URL alone doesn't retrieve the configuration. Check the server list after the update. If it's empty, review the update result and link format before changing ports or reinstalling the client.

Choose a server and proxy mode

Select a server, then set the system proxy on desktop or the connection mode on Android. Test access using one traffic-routing method before adjusting routing rules. If you need TUN, check the permissions and DNS requirements separately. Turning on a setting doesn't prove the connection works.

Understand the client, core, and server configuration

v2rayN, v2rayNG, and v2flyNG are graphical clients that organize subscriptions, routing, and connection options. Project V is the starting point for the related technology ecosystem; V2Fly and Xray are common core implementations. Similar client names don't guarantee identical protocol, transport, or extension support. If importing a configuration fails, check its required features against the client's capabilities rather than comparing app names alone.

Open source describes the code and its license; free to use describes the cost of the client itself. Whether a remote service charges a fee, how many devices it allows, and when a subscription expires depend on that service's terms. Updating the client generally won't change your subscription status or fix an invalid remote configuration. Distinguish app, configuration, and network issues before troubleshooting to avoid unnecessary reinstalls.

Change one setting at a time during initial testing

Keep the default routing and DNS settings at first. Choose a known working server and test basic access. If something goes wrong, note the server, routing mode, and relevant log details. Remove subscription URLs, credentials, and personal network information before sharing. Change one setting at a time to identify what affects the result.

After confirming the basic connection, add features such as per-app proxying, domain-based routing, or TUN one at a time. The system proxy doesn't force every app to use the same settings, and TUN doesn't guarantee that every protocol and app will work on every network. For menu locations and step-by-step instructions, see the user guide. For platform permissions, traffic routing, and common errors, see the complete documentation.

DOWNLOAD / FAQ

Download and Installation FAQ

Should I download the Apple Silicon or Intel package for my Mac?

Open About This Mac from the Apple menu. If the Chip field shows an Apple M-series chip, choose Apple Silicon; if it shows an Intel processor, choose Intel. Use the package that matches your chip rather than relying on the computer's purchase year.

Which should I choose: Desktop or the classic WPF version for Windows?

Desktop uses a newer cross-platform interface. WPF is the classic, stable version for users who prefer the traditional Windows layout. Both manage proxy configurations. If you're new, start with Desktop. Export or back up your configuration before switching, and don't run both versions at the same time to manage the system proxy.

What's the difference between arm64 and universal Android packages?

arm64 is for 64-bit ARM devices. Most mainstream phones released after 2015 can use this package, but check your device's supported architecture. Choose the universal package if you're unsure or see an incompatibility warning. Installation failures can also be caused by the Android version or a signature conflict with an existing app.

Should I choose deb or rpm on Linux?

Check your distribution's package management system first. Debian- and Ubuntu-based distributions generally use deb; Fedora- and RHEL-based distributions generally use rpm. Then check whether your system is x64 or arm64. A compatible package format doesn't guarantee that dependencies are met, so review any missing-library or system-version warnings.

Can I connect as soon as I download the client?

The client reads configuration and routes traffic, but it doesn't include a working server configuration. You'll need an authorized subscription URL or shared configuration link. Import and update it, choose a server, then set the system proxy or connection mode. Subscription URLs may contain access credentials; don't share screenshots or forward them to people who don't need access.

Do I need to uninstall the old version before updating the client?

Don't uninstall it right away. Back up your subscriptions, routing rules, and custom settings, then quit the running client and follow the installer's update instructions. Different distribution channels for the same client may use different signatures or configuration folders. If you can't install over the existing version, confirm how to migrate first to avoid losing app data.

CONFIGURATION BACKUP

Keep your configuration before updating, then verify the connection

A backup is more than a copy of the installer

Keep your subscription groups, personal routing rules, and DNS settings, and note the proxy mode you're using. Different interface versions, distribution channels, or system accounts may store data in different folders. Confirm the new version can read your existing configuration before removing old files.

Test first, then restore launch at login

During an update, quit the old process first. After installing, launch the client manually and check your subscriptions, selected server, and system proxy status. Restore options such as launch at login after confirming access works. To compare the three clients and see when to use each, see Client Comparison.