Choose an installer for your system

V2Ray Client Downloads

For desktop, start with v2rayN; for Android, start with v2rayNG. Choose a package by operating system, CPU architecture, and installer format, then import your existing subscription.

Windows client

One client, v2rayN, with two interface editions. Both downloads are for x64.

v2rayN

Windows · 7.24.1

Recommended

Desktop edition

Modern cross-platform UI

Download Desktop · x64

Classic WPF edition

Classic, proven interface

Download WPF · x64

For your first install, try Desktop, whose layout follows a similar pattern across desktop platforms. WPF keeps the classic Windows workflow and suits users who know where to find the familiar menus and settings. The main difference is the interface branch—not a guarantee that one protocol will be faster.

The download is a ZIP archive. Extract it to a separate folder you can write to, then run the installer inside. Don’t launch it from the archive preview. Back up your settings before switching editions, and test the other edition in a separate folder to avoid two instances competing for local ports or changing the system proxy at the same time.

System requirements and setup

Check	What to choose
Operating system	Use a Windows desktop version that is still supported by Microsoft
Processor architecture	x64; check “Settings → System → About” under System type
Runtime components	Follow the runtime requirements shown by the installer
Permissions	Use standard permissions for a regular proxy; grant authorization for TUN when prompted

After installation, make sure the main window opens before importing a subscription. For your first test, enable only the system proxy and leave TUN off to minimize variables. If your browser works but other apps don’t, first check whether those apps use the system proxy rather than switching installers.

If a port is already in use, quit older instances and other proxy apps, then restart. A missing runtime prevents the app from starting; connection failures are a separate issue involving configuration, routing, or the network.

Next: Import a subscription and set the system proxy →

macOS client

Check About This Mac, then choose the DMG for your processor.

v2rayN

macOS · 7.24.1

Desktop client

Apple Silicon

Apple M-series chip · arm64

Download for Apple Silicon

Intel

Intel processor · x64

Download for Intel

Open About This Mac from the system menu and check the Chip or Processor field. Choose Apple Silicon for an Apple M-series chip, or Intel if it says Intel. Don’t guess based on purchase year or laptop design; the same product line may use different processor architectures.

Open the DMG, drag the app to Applications, then launch it from there. You don’t need to keep the disk image mounted for everyday use. Before updating, quit the running app and back up your settings, then replace it to avoid old and new versions changing the system proxy at the same time.

System requirements and first launch

Check	What to choose
Operating system	Use a supported macOS release. Check the current app’s requirements for the minimum version.
Processor	Apple Silicon requires arm64; Intel requires x64
Installer format	DMG disk image
Network permissions	Approve the permissions macOS requests for your chosen setup

If macOS blocks the first launch, note the alert and check the app’s source and architecture. Only use the one-time open option in System Settings after confirming the app is from a trusted source. Don’t disable macOS security protections entirely just to launch an app.

For your first setup, import a subscription and select a working connection before configuring the system proxy. TUN uses a virtual network interface and requires additional permissions, so set it up separately after the basic connection works. If access fails after waking from sleep, check that the service is running and that the system proxy port matches the client’s.

Read the complete installation and setup guide →

Android clients

Start with v2rayNG. Consider v2flyNG if you need an existing V2Fly configuration.

v2rayNG

Xray core · 2.2.6

Recommended

arm64

For most 64-bit Android devices

Download v2rayNG · arm64

Universal version

Choose if you’re unsure of your architecture

Download v2rayNG · Universal

Use v2rayNG on Android to import subscriptions, configure routing, and set per-app proxy rules. It uses the Xray core; supported protocols and transports depend on the bundled core version. When following setup instructions, check both the client and core—similar-looking settings in the interface don’t guarantee the same support.

Most phones released after 2015 can start with arm64, but some devices may still run a 32-bit-only Android system. Check what your system supports. If you’re unsure of the architecture, choose Universal; it includes more architecture builds and is usually a larger download. Universal does not bypass Android version requirements.

v2flyNG

V2Fly core · 1.10.31

Alternative

arm64

For most 64-bit Android devices

Download v2flyNG · arm64

Universal version

Multi-architecture package

Download v2flyNG · Universal

v2flyNG uses the V2Fly core and suits users who specifically need its configuration behavior. It isn’t just a different skin for v2rayNG; don’t assume both clients support the same protocol extensions, transport settings, or subscription conversion results.

When migrating, keep the original client and subscription. Check configuration fields one by one, then test the connection separately. Don’t change clients, DNS, and routing all at once, or it’ll be hard to tell which change caused the issue. Choose based on configuration compatibility, not similar names or version numbers.

System requirements and architecture

Check	Before installing
Android version	Meet the APK’s minimum Android version; follow the installer’s prompt
Architecture	Choose arm64 for 64-bit app support; if unsure, choose Universal
Install permissions	Grant install permission only to the app you use to open the APK
VPN permission	Approve Android’s VPN request when connecting for the first time

After installing the APK

Open the APK from your downloads, follow Android’s prompts to install it, then import your subscription. On the first connection, Android asks you to approve a VPN request. This lets the client route matching traffic through the system interface; it does not mean a remote connection is already active.

Only one client can establish a VPN connection at a time. If the app disconnects in the background, check battery optimization and background activity restrictions, and adjust them as needed. Don’t enable per-app proxying for every app while troubleshooting a single browser.

If an update reports a signature conflict, don’t uninstall the existing app right away. Save your settings and check that the new installer comes from the right source and matches the app. Uninstalling may erase subscriptions and local settings. See the v2rayNG guide for more steps.

Linux client

Choose a package format for your distribution, then check whether you need x64 or arm64.

v2rayN

Linux · 7.24.1

GUI client

deb package

Debian- and Ubuntu-based distributions · x64

Download deb · x64

rpm package

Distributions that use RPM · x64

Download rpm · x64

Additional arm64 downloads

arm64 · deb arm64 · rpm

deb and rpm are package formats, not separate feature editions. Choose the format supported by your distribution’s package manager; changing a file extension won’t convert a package. In filenames, amd64 and x86_64 usually mean x64, while arm64 and aarch64 refer to a different processor architecture.

Open the downloaded package with your desktop environment’s software installer. Review dependency and compatibility warnings before confirming installation. Some RPM-based distributions may still be incompatible with a package because of system library versions; follow the package manager’s checks instead of forcing installation past dependency errors.

System requirements and desktop environment

Check	What to choose
Desktop environment	A Linux desktop environment that can run GUI apps
Package format	Use deb or rpm, as supported by your distribution
Architecture	Download the x64 and arm64 builds separately; don’t mix them
Dependencies and permissions	Let the package manager check dependencies; TUN requires additional permissions

After installation, launch the app from the application menu and make sure the main window and settings page display correctly. Not every app uses the desktop environment’s system proxy, and command-line tools may not inherit desktop proxy settings. When testing a connection, distinguish between an app that isn’t using the proxy and a configuration that can’t connect.

Don’t run the entire desktop client with elevated privileges just to get the GUI to start. If you need TUN, handle permissions and network interfaces using the method supported by the client. After updating, check that the old service has stopped so the two versions don’t compete for ports.

Next: Configure routing, DNS, and TUN →

JavaScript is required to switch platforms. Windows downloads are shown; enable scripts to view packages for other platforms. For setup and client comparisons, read the guides and client reviews.

After installation: setup and updates

Start with the simplest working connection, then add routing rules and expand which traffic is handled. Confirm installation, service startup, and app access as three separate steps.

01 / Configuration source

Get your own subscription

The installer provides the client app, not a usable subscription. Check that you trust the subscription source and are authorized to use it. Subscription URLs often contain access credentials—don’t share them in public screenshots, chat logs, or support requests. Import one known-good group first, then check that its connection settings appear.

See how to import a subscription →

02 / First connection

Change one setting at a time

On desktop, first check the selected connection and system proxy; on Android, approve the VPN request. Once basic access works, try routing rules, per-app proxying, or TUN. If something breaks, revert the last change and note the error so you don’t confuse an installation problem with a network issue.

Follow the step-by-step guide →

03 / Ongoing maintenance

Back up before updating

Before updating, save subscription groups, manually added configurations, and custom routing and DNS settings. Backups may contain sensitive information, so keep them somewhere secure. Quit the old instance before starting the new version. Then check the listening ports and proxy mode to make sure your usual traffic still works.

Read the maintenance guide →

V2Ray download and installation FAQ

Rule out package format and architecture issues first, then check the client configuration. Expand a question below to read the answer.

Which v2rayN edition should you choose: Desktop or classic WPF?

For a first install, start with Desktop for its modern cross-platform interface. Choose WPF if you prefer the classic layout. Both are v2rayN editions. Back up your settings before updating, and test the other interface branch in a separate folder before switching.

Should you download the arm64 or universal Android version?

Most phones released after 2015 can start with arm64, but confirm that the device supports 64-bit apps. If you’re unsure of the architecture, choose the universal version. If installation fails, check the Android version, download status, and whether the installed app has a conflicting signature.

Can you use the same configuration with v2rayNG and v2flyNG?

They use different cores, so similar client names don’t mean identical features. Whether a subscription works in both depends on protocol, transport, and core support. Keep the original configuration before switching, check each setting after import, and avoid running both clients’ VPN connections at once.

Why can’t you connect right after installing the client?

The client manages connection settings; its installer does not include a usable subscription. You’ll need a subscription or server configuration you’re authorized to use. Import it, select a connection, then set the system proxy or approve Android’s VPN connection request.

What should you save before updating the client?

Save subscription groups, local configurations, custom routing and DNS settings, and note your proxy mode and listening ports. Backups may contain sensitive information, so store them somewhere secure. Quit the client before updating, then check that your settings remain and reconnect.

What should you check if an installer won’t open or reports incompatibility?

Check your operating system, CPU architecture, and package format, then make sure the download completed. Extract Windows ZIP files first; on macOS, choose the Apple Silicon or Intel build; on Linux, match your distribution’s package manager. If the issue persists, note the exact error instead of repeatedly disabling security settings.