V2Ray Client Downloads

Choose your device's operating system, then check its processor architecture. Use v2rayN on desktop. For Android, start with v2rayNG, or choose v2flyNG if your existing configuration requires it.

Windows downloads

v2rayN 7.24.1

Recommended

Desktop uses a modern cross-platform interface and is a good choice for a first install. WPF is the classic, stable edition with the familiar Windows layout. Choose one; there's no need to install both for the same subscription.

The download is a ZIP archive. In File Explorer, select “Extract All” before opening the extracted folder and running the installer. Don't run it directly from the archive preview. Seeing the installer in the ZIP window doesn't mean the other files have been extracted alongside it.

Windows requirements

CheckHow to check before installing
System and architectureOpen Settings → System → About and check that “System type” says “64-bit operating system, x64-based processor.” Seeing “64-bit” alone isn't enough; check the processor type too.
Runtime dependenciesFollow the prompts for the version you've chosen. If a runtime is missing, note its full name and architecture. Desktop and WPF have different interfaces, so the fact that one launches doesn't prove the other has all its dependencies.

Check these three things before installing

You don't need to decipher the entire filename. Check the package format, system architecture, and purpose to avoid most download mistakes.

Know the difference between archives and installers

ZIP is an archive that must be extracted before installation. DMG is a mountable disk image; APK is an Android app package; DEB and RPM packages must be opened with a compatible system package installer. “Download complete” in your browser only means the file was saved, not installed.

If double-clicking opens an archive utility or text editor, return to your downloads folder and check the full file extension and your system's default app. Changing the extension doesn't change the file format or make a package for another platform work.

Check the system architecture, not just the chip specs

“64-bit” isn't specific enough: x64 and arm64 are both 64-bit architectures, but they're not interchangeable. When installing in a virtual machine, check the system running the client—not the host machine's model.

A universal package doesn't work on every system. It lets one Android APK support multiple app architectures, but the minimum Android version, app signature, and device management policies can still prevent installation.

First installs and upgrades

For a first install, choose a package that matches your platform and import your configuration after launching the app. Before upgrading over an existing install, check which client you have, where it came from, and where its configuration is stored. Desktop and Classic WPF are separate editions, not simply newer and older versions of the same installation.

Before switching packages, disconnect normally and quit the client. After restarting, check your subscription groups and selected server, then confirm that the system proxy or connection status is as expected. Once everything checks out, remove the old installation directory.

Troubleshoot installation and connection separately

A client that launches but can't connect is a different problem from an installer that won't open. Start with the first step that failed; there's no need to rebuild your entire configuration.

The client won't open

Note where the error occurs: download, extraction, installer, or first launch. Your browser's downloads list can show whether a download is still in progress. Installer messages are more useful for identifying architecture, dependency, or permission issues.

On a work device, your organization may control installation permissions. If you hit a restriction, give your device administrator the client name, package format, and error message rather than changing system policies yourself. For an upgrade, back up your configuration before resolving version or source conflicts.

The client opens, but the server list is empty

First, check whether you have a subscription URL or a single server configuration. For a subscription, add the group or URL, then update it manually. Import a single configuration through the import option. If an update fails, check the logs to distinguish a timeout, unexpected response, or parsing error. Don't delete the existing group just because the list is empty.

If servers appear but websites won't load, change one thing at a time. Check the selected server first, then confirm which connection mode the client is using. Hide subscription URLs, account details, and server credentials in screenshots; keep the error message and steps that triggered it.

Getting Started: Import a subscription and test your connection Installation guides: Follow the steps for your system Compare three clients

V2Ray download and installation FAQs

Do I need to install both the Desktop and WPF versions on Windows?

Install either version, not both. For a first install, start with Desktop, which uses a cross-platform interface. If you already know the classic interface, choose WPF. Before trying the other version, quit the current client to avoid both instances competing for the same local port.

What should I do if an Android APK is incompatible with my device?

Check your Android version and the app architectures supported by your system. If you downloaded the arm64 APK but your system can't run 64-bit apps, try the universal APK for the same client. If that still won't install, note the full error and check whether the Android version is too old, the download is incomplete, or the app signature conflicts with an existing install.

Do I need a subscription URL after installing the client?

The client installer and connection configuration are separate. After installing, use an existing subscription URL or import a single server configuration. Subscriptions usually need to be updated after import before the client can display the servers they contain.

How do I keep my settings when upgrading?

Note which client and installation method you're using, then export settings with the client's built-in feature or back up the configuration directory in use. Backups may contain subscription URLs or server credentials, so store them somewhere you control. Delete old files only after confirming the new version can read your settings.

A website won't load after installation. Should I download the client again?

If the client launches, there's usually no need to download it again. Check that a server has been imported and selected, then review the logs. On desktop, make sure the required proxy mode is enabled. On Android, check that the system has allowed the client to establish a VPN connection.