V2Ray clients · Choose an installer

Download V2Ray clients

v2rayN for desktop, plus Android clients. Choose your operating system, then your processor architecture.

Open-source clients
Free to use
Xray / V2Fly ecosystem

Download v2rayN for Windows

Both installers are x64. Choose the Desktop or classic WPF edition based on the interface you prefer.

Windows GUI client · x64 · ZIP package

Desktop · New-generation cross-platform UI

Download v2rayN Desktop

For a first install, start with Desktop. Its menus and workflow are closer to v2rayN on other desktop systems.

WPF · Classic, stable edition

Download classic WPF

For users familiar with the classic Windows interface, with the familiar workflow for managing servers and subscriptions.

After the download finishes, extract the entire ZIP before running the installer. Don’t launch it from the archive preview.

Windows installation steps

Open Settings → System → About and confirm that your system type is x64.
Extract the ZIP to its own folder, run the installer inside, and follow the setup wizard.
Launch the client, import your subscription, refresh the server list, and select an entry.
Check your system proxy settings, then test the connection in a browser. Adjust routing or TUN settings afterward, if needed.

The Desktop and WPF editions may place controls in different locations. There’s no need to switch versions just to follow a tutorial. If your current client works, note your subscription groups and routing presets before deciding whether to migrate.

Learn about system proxies and connection modes →

Windows system and installation requirements

Check	This installer	Before you install
Processor architecture	x64	Check the system type shown in Windows; the OS name alone doesn’t confirm compatibility with other architectures.
System environment	Windows desktop environment	Follow the installer’s requirements for Windows versions and runtimes, and keep Windows up to date.
File access and permissions	A configuration location you can write to	For a standard connection, start with the system proxy. Grant additional permissions only when a feature requires a virtual network adapter or system-level network changes.

If startup reports a missing runtime, note the component name and architecture in the message, then follow the installer’s instructions. Don’t assume a required runtime is installed just because other apps run on the same computer.

Download v2rayN for macOS

Check About This Mac for your chip, then choose the matching DMG installer.

macOS GUI client · DMG disk image

Apple Silicon · arm64

Download for Apple Silicon

If About This Mac shows an Apple M-series chip, choose the native arm64 package.

Intel · x64

Download for Intel

If the processor is listed as Intel, choose the x64 package. Don’t infer the architecture from the Mac’s appearance or purchase year.

Copy the app to Applications before opening it. Once installation is complete, you can eject the disk image.

macOS installation steps

Open About This Mac from the Apple menu and check the chip or processor details.
Open the matching DMG and copy v2rayN to Applications. Don’t run it from the disk image long-term.
Read the system prompt the first time you open the app. If macOS blocks it, check the specific reason in System Settings.
Import your configuration, enable the required proxy mode, and check whether your browser and other apps use the system proxy.

Apps don’t all handle the system proxy the same way. If a browser can reach the destination but another app can’t connect, check that app’s network settings before blaming the installer’s architecture.

See installation and connection FAQs →

macOS system and installation requirements

Check	What to choose	Before you install
Apple M-series	arm64 DMG	Choose the native app built for your chip whenever possible.
Intel processor	x64 DMG	Check that your macOS version meets the app’s requirements at launch.
System permissions	Grant network permissions as needed	Handle system permission prompts only when you enable the related feature. Keep the exact prompt text for troubleshooting.

Quit the old client before upgrading and back up its configuration. Then replace the app in Applications. If the new and old versions use different configuration folders, migrate using an import method supported by the client; don’t overwrite configuration files you’re unfamiliar with.

Download v2rayNG for Android

For most users, start with v2rayNG. Consider v2flyNG if you have a specific need for V2Fly configurations.

Android · Xray-based · APK

arm64 · Recommended for most devices

Download v2rayNG arm64

Most mainstream phones released after 2015 use arm64, but check which app architectures your device actually supports.

Universal · Multiple architectures

Download v2rayNG Universal

Choose Universal if you’re unsure of your device’s architecture. It supports multiple architectures and is usually a larger download.

For Android users with Xray-based configurations. Check each protocol, transport, and extended setting against the server configuration.

Android · V2Fly-based · APK

arm64 · Recommended for most devices

Download v2flyNG arm64

Use this option if you already work with V2Fly or have a corresponding configuration, after confirming compatibility.

Universal · Multiple architectures

Download v2flyNG Universal

Choose Universal if you’re unsure of the architecture. Switching architecture packages won’t eliminate the differences between the two clients’ cores.

Don’t apply every Xray extension setting to V2Fly. Before migrating, confirm that the target client recognizes the settings you need.

Android system and installation requirements

Check	Requirement	What to do
App architecture	arm64 or Universal	A 64-bit processor doesn’t necessarily mean the system provides the same 64-bit app environment.
Install permission	Allow APK installs from this source	Grant this permission to your browser or file manager only when needed. You can restore the previous setting after installation.
Connection permission	System VPN connection prompt	Read the system prompt when connecting for the first time. Run only one app that takes control of network traffic at a time.

Install and connect on Android

After downloading, open the APK in your system file manager. Check the app name before proceeding. If the installer says “App not installed,” possible causes include an unsupported architecture or Android version, a signing conflict, or insufficient storage. Don’t assume the package is unusable based on that message alone. Expand the error details, check for an older version installed from a different source, and then decide what to do.

Open the client, import your subscription, refresh the list, and select a server. The system VPN permission prompt on first connection is part of the network routing process; make sure it was triggered by the client you just installed. If your device has an always-on VPN or another network tool enabled, check for conflicts first. Test access after the connection is established, rather than repeatedly changing routing modes before importing a configuration.

Some Android systems restrict background activity. If the connection drops when the screen is off, check battery management, background activity, and network restriction settings, then adjust what’s needed. Balance connection stability against power-saving settings; there’s no need to grant every background permission. For more on core differences, see the client and protocol selection guide.

Download v2rayN for Linux

Check your distribution’s package format first, then confirm whether your system is x64 or arm64.

Linux GUI client · deb / rpm packages

Debian / Ubuntu-based · x64

Download v2rayN deb

For compatible desktop distributions that use deb packages. The package manager handles dependencies during installation.

RPM-based distributions · x64

Download v2rayN rpm

For compatible desktop distributions that use rpm packages. Check dependencies against your local system.

For arm64 devices

arm64 deb arm64 rpm

These packages are for the GUI client. Don’t use desktop installation or system proxy instructions on a command-line-only device.

Linux installation steps

Check your distribution and processor architecture in Settings → About or your system’s hardware information.
Download the matching package and open it with your system’s software installer or package manager.
Review how dependencies are handled. If requirements can’t be met, check system compatibility instead of forcing the installation.
Launch v2rayN from your app menu, import your configuration, then check your desktop environment’s network proxy settings.

Desktop environments handle system proxies differently, and some apps need their own proxy settings. A system proxy doesn’t route traffic from every process. Before using TUN, verify that the server configuration works in standard proxy mode, then check virtual network adapter permissions and routing conflicts.

Learn about routing and advanced settings →

Linux system and installation requirements

Check	What to choose	Notes
Package format	deb or rpm	Choose the format for your distribution. Renaming a file extension won’t convert the package.
Processor architecture	x64 / amd64 or arm64 / aarch64	Naming varies across package systems. Check your system information to identify the right architecture.
Runtime environment	Compatible desktop environment and libraries	Being able to install a package format doesn’t guarantee that its dependencies are met. Check the installer output first.

Starting at boot isn’t the same as launching after login. A desktop client usually runs once you sign in to a graphical session. Before enabling autostart, complete a successful connection manually and check that the system proxy is restored as expected when you quit the client.

After installation

From installation to your first connection

Handle installation, configuration, and network testing separately to pinpoint which step needs attention if something goes wrong.

Prepare your configuration

Import first, then choose a connection mode

v2rayN, v2rayNG, and v2flyNG are GUI clients; installing one doesn’t automatically provide a server. Get a subscription URL or share link, import it, refresh the list, and confirm that your entries appear. Name subscription groups by source to avoid mixing them up when you update later.

Select a server, then enable the system proxy or the client’s connection mode. A desktop system proxy affects only apps that follow that setting; TUN routes more network traffic and requires additional permissions. For your first connection, verify the configuration in a basic proxy mode, then add routing, DNS, and TUN settings as needed.

Follow the steps to configure your client →

Manage updates

Save your settings before updating the client

Updating the client and updating a subscription are separate tasks. A client update replaces the app; a subscription update refreshes server entries. Updating the app won’t necessarily restore a subscription, and refreshing a subscription won’t change the installed client. If you can’t connect, identify which layer is failing before choosing what to update.

Before updating, note your subscription groups, routing presets, local ports, and custom settings. Use the client’s backup or export feature to save your configuration. Backups may contain subscription credentials, so store them somewhere you control. After updating, check that your settings are intact before resuming normal use.

Read about subscriptions and advanced settings →

Download and installation FAQ

Installer FAQs

Check architecture, installation source, and configuration compatibility before switching packages.

Which v2rayN version should you choose for Windows: Desktop or classic WPF?

The Desktop edition uses a newer cross-platform UI and is a good starting point for first-time installs or anyone who prefers a workflow similar to v2rayN on other desktop systems. WPF is the classic, stable edition for users who prefer the familiar Windows interface. Check that your system supports x64 before installing either version, back up your settings before updating, and avoid enabling the system proxy in both clients at once.

Should you download the arm64 or Universal version for Android?

Most mainstream phones released after 2015 can use arm64, but check which app architectures your device actually supports. If you’re unsure, choose Universal; it supports multiple architectures but is usually a larger download. If installation reports an incompatibility, check the Android version and supported architecture instead of repeatedly installing the same package.

Can you use the same configuration in v2rayNG and v2flyNG?

The two Android clients primarily use the Xray and V2Fly cores, respectively, so supported protocols, transports, and extended settings may differ. Some common share links can be imported, but that doesn’t mean every configuration is compatible. If your current setup works, keep the original client and check the target client’s support against your server settings before switching.

Why can’t you connect to a server after installing a client?

The client installer provides configuration management and connection features; it does not include a subscription or server. You’ll need a valid subscription URL or server share link. Import it into the client, refresh the list, select an entry, and then configure the system proxy or connection mode using the relevant documentation. Keep subscription credentials secure.

Do you need to uninstall the old version before updating a client?

As a rule, update with a package for the same client and architecture, obtained from a compatible installation source. Whether you need to uninstall first depends on how the app was installed and its signing identity. Back up subscription groups, custom routing, and other settings, then quit the running client before updating. If you encounter a signing conflict, check the original installation source before uninstalling and risking local configuration loss.

What should you check first if a download won’t open or installation fails?

Make sure the download finished, the file extension matches your platform, and your processor architecture, available storage, and OS are supported. Fully extract ZIP files on Windows; open the DMG and copy the app on macOS; use your distribution’s package manager on Linux; and check the installer’s exact error on Android. Keep the original error message for troubleshooting.

Need help with connections, DNS, or routing? Browse the FAQs or read the advanced guide.