CLIENT EDITIONS / Package Index

V2Ray Client Downloads

Choose v2rayN for desktop, or v2rayNG or v2flyNG for Android. Select your operating system first, then choose a package for your device's architecture and package format.

Platforms
4 operating systems
Clients
3 open-source GUI clients

Windows Client

X64 / ZIP

System Requirements & Package Selection

CheckRequirements
SystemA currently supported 64-bit version of Windows is recommended.
ArchitectureBoth packages are x64. Check System type under Settings → System → About.
FileExtract the ZIP file completely, then run the installer from the extracted folder.

Don't run a program by dragging it out of the ZIP preview window; nearby files may also be required. If you see a missing runtime message at startup, note the component name and version, then follow the system's instructions.

When switching from WPF to the desktop edition, note your subscription groups, routing options, and local ports first. After installing, open the client and check these settings before deciding whether to remove the old version. If both editions try to use the same local port, the one launched second may fail to listen.

PACKAGE NOTES / Before & After Installation

Choosing a Package, Upgrading & First Launch

Make sure the client starts normally before importing settings. Following this order makes it easier to tell installation problems from connection problems.

01 / PACKAGE

Choose a file for the device that will run it

When downloading for another device, choose based on the device that will run the client, not the one you're browsing from. Check three things: whether the target operating system can run the client, whether the package architecture matches the system, and whether the device's package installer can open the file. If any of these don't match, downloading the same file again won't help.

The file extension tells you how to open the file: ZIP archives must be extracted; DMG is a disk image; Android's system installer handles APK files; and deb and rpm belong to different package systems. Renaming an extension doesn't convert a file. If a browser download was interrupted, confirm it finished before blaming the system or processor for an installer error.

Architecture names also depend on the platform. A Windows x64 package and a Linux x64 package are for different operating systems. An Android arm64 APK won't run on macOS, even if both devices use ARM processors. The operating system determines the platform; architecture and package format determine which file to choose within that platform.

02 / UPGRADE

Back up your settings before replacing the app

Before updating, decide what you need to keep: subscription groups, manually added entries, routing rules, local listening ports, and system proxy or startup settings. Use the client's export feature if available; make a local note of anything it doesn't include. Subscription URLs and share links may contain access credentials, so don't include them in public screenshots or shared documents.

Before replacing a desktop client, quit it completely, including instances still running in the system tray or menu bar. This reduces file lock issues and makes it easier to tell which version launches after installation. When switching interfaces or package formats, keep the old settings until you've confirmed the new app can read or import what you need, then remove the old files.

If the installer reports a signature conflict during a mobile update, don't keep retrying. Check where the existing app came from and, if possible, update through the same distribution channel. If you need to switch channels, back up any local data you can export first. Uninstalling may erase app-private storage, and re-importing a subscription may not restore custom groups or edits to individual entries.

03 / LAUNCH

Check the app before troubleshooting the network

On first launch, make sure the app opens to its main screen, can be launched again after quitting, and saves changes to settings. If an error appears before the window opens, note the system message, package name, and steps that triggered it. Changing subscriptions or servers won't usually fix a startup failure—the client hasn't reached the point where it reads its settings yet.

Once the main screen opens normally, follow the Quick Start Guide to import a subscription or individual share link. Check that the expected groups and entries appear, then change one thing at a time—for example, select an entry and check whether the target app uses the system proxy. Don't switch clients, subscriptions, and network modes all at once, or it will be hard to tell what caused the change.

If an entry appears but a protocol or transport setting doesn't work, see the Protocol Handbook to check core and configuration compatibility. When reporting a problem, include the system and app versions, package format, and exact message. Hide subscription URLs, personal server details, and local account information. A specific error message is more useful than simply saying, "It won't connect."

INSTALLATION FAQ / Common Questions

Download & Installation FAQ

Do I need to install both the Windows desktop and classic WPF editions?

Install either one. The desktop edition has a modern cross-platform interface, while the classic WPF edition retains the familiar Windows layout. Back up your settings and quit the running client before switching. Don't enable the system proxy in both editions at the same time.

How do I choose between the Apple Silicon and Intel packages for macOS?

Open About This Mac from the Apple menu. Choose the Apple Silicon package if it shows an Apple M-series chip, or the Intel package if it shows an Intel processor. Choose based on your Mac's processor, not the macOS version name.

Will the Android universal package fix every installation problem?

The universal package supports a wider range of processor architectures, but installation can still fail if your Android version is too old, device management policies block installation, or the old and new packages have different signatures. Check the system message first. If you need to uninstall the old version to switch packages, save your local settings beforehand.

Should I choose deb or rpm for Linux?

Debian- and Ubuntu-based distributions generally use deb; Fedora and RHEL-based distributions generally use rpm. After choosing the right package format, check the architecture, distribution, and dependency versions. The el10 in an rpm filename indicates its build target; it doesn't mean the package installs on every rpm-based system.

Why is my server list empty after installing the client?

The installer provides the client application, not server details. Import server information after installation from an existing subscription or individual share link. First make sure the client opens, then follow the quick-start guide to import your details. If the list is still empty, check that the subscription has refreshed and that its format is supported.

V2Ray Client Download