Packages & System Requirements

V2Ray Client Downloads

Choose v2rayN for desktop and v2rayNG for Android. Select your operating system first, then choose a package for your device architecture or Linux distribution.

Choose a Package by Platform

Windows Package

v2rayN

v2rayN

Recommended7.24.1

Desktop is the desktop edition with a newer cross-platform interface. WPF is the stable edition that retains the classic Windows interface. Both downloads are ZIP files. Extract the entire archive before running the installer inside.

Go to Settings → System → About to check your system type. Use this package only if both your system and processor are x64. If your device has an ARM processor, “64-bit” alone doesn’t confirm compatibility.

CheckRequirements and Recommendations
System and architectureA supported 64-bit version of Windows 11 is recommended. Both packages are x64.
RuntimeIf startup reports that a .NET runtime is missing, check the required version and architecture, and whether the desktop runtime is needed.
Extraction folderExtract the entire ZIP archive to a writable folder on your computer. Don’t run the program from the archive preview window.

Installation, Upgrades and Configuration Migration

The installer, subscription contents and system proxy are separate. When something goes wrong, identify which step failed before choosing a different package.

First install: make sure the client opens

After installation, open the main window and check that the settings page loads before importing a configuration. Re-entering a subscription URL won’t help if the main window won’t open. On desktop, check the runtime environment or installation message; on mobile, distinguish an installer error from an app startup error. When asking for help, include the system version, architecture, downloaded filename and full error message. Keep screenshots limited to what’s needed for troubleshooting.

Once the client opens, choose an import method based on your configuration source. Add a full subscription under subscription groups; import an individual share link using the share-link option. An empty list doesn’t necessarily indicate an installation problem: the URL may not have refreshed, the format may be unsupported, or a filter may be showing a different group.

Installation and subscription import guide →

Before upgrading: back up your local configuration

Refreshing a subscription downloads remote configuration; it doesn’t back up your local settings. Connections you added manually, custom groups, routing rules and proxy modes may need to be saved separately. Use the client’s backup or export feature if available, and store the backup outside the installation folder so an update can’t overwrite it.

After upgrading, open the app and check your groups and custom rules, then test a connection that worked before. Don’t change the core, routing settings and subscription all at once, or it’ll be hard to identify the cause of a problem. If you roll back, first check whether the older version can read the newer configuration. Then decide whether to restore an older backup or import the configuration again.

Configuration and maintenance guide →

Download and Installation FAQs

Do I need to install both the Desktop and WPF editions of v2rayN?

No. Choose Desktop for a first installation, or WPF if you prefer the classic Windows interface. Before switching, quit the old version and back up your configuration to prevent both instances from changing the system proxy.

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

Open About This Mac from the Apple menu. If it says Apple chip, choose Apple Silicon; if it says Intel processor, choose Intel. Don’t decide based on the model’s appearance or purchase year.

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

The arm64 package is for systems that support arm64-v8a; the universal package includes multiple architectures. Choose arm64 if your system explicitly supports arm64-v8a. If you’re unsure, try the universal package, but make sure your Android version meets the minimum requirement.

Do I need a subscription URL after downloading the client?

The client package doesn’t include a subscription. Import an existing subscription URL or individual share link, or configure the client manually. Subscription URLs may contain access credentials, so don’t post them publicly or include them in screenshots.

What should I do if an upgrade won’t install over the existing version?

First, confirm both packages come from the same release channel, then check the architecture and version. If Android reports a signature conflict, update through the original channel if possible. If you must uninstall, back up your configuration first and make sure you can restore it.