Client Downloads · Platforms and Architectures

V2Ray Client Downloadsv2rayN / v2rayNG

Choose your operating system, then select the processor architecture and package format.

Use v2rayN on desktop. On Android, choose v2rayNG for the Xray core or v2flyNG if you need the V2Fly core. All three clients are free and open source; after installation, you’ll need to import a valid subscription or node configuration.

Choose a package Subscription import guide

Installers, Clients, and Subscriptions

The installer provides the software; the subscription provides connection settings.

Check your device details before downloading. After installation, add a subscription group, update the node list, then configure routing and proxy mode. Don’t enter a subscription URL in a download button or try to import an installer as a node. The client version, core capabilities, and node settings must be compatible.

Downloads by Platform

Select your device to see the compatible client and system requirements.

Installer links use the current release manifest. Version details on this page identify the client; use the download link to confirm the actual file name.

v2rayN · Windows

Recommended7.24.1

Desktop uses a newer cross-platform UI, making it a good choice for first-time users and anyone who wants a consistent desktop experience. WPF is the classic edition, with familiar Windows-style controls. Choose the interface you prefer; there’s no need to install both just to import the same subscription.

Desktop Edition · x64

Download Desktop installer

A newer cross-platform interface. A good starting point for first-time users. Download the ZIP, extract all files, then run the installer inside.

Classic WPF Edition · x64

Download WPF installer

The classic Windows interface for users who prefer its familiar workflow. If you’re upgrading from an older version, back up your subscription groups and custom rules first.

Windows x64Manage subscriptions and nodes with a graphical interfaceRouting and system proxy settings

v2rayN setup guide

Windows Requirements and Installation Checks

Check	What to choose	Where to check or what to do
Processor and system	Both downloads on this page are x64 packages	Open Settings → System → About and check System type. Don’t use this page’s x64 packages for other architectures.
Windows version	Use a version of Windows 10 or 11 that still receives updates	Check the current release notes and installer checks for exact minimum requirements. Older systems may lack required interfaces.
Runtime dependencies	Depends on whether the current package includes the required runtime	If prompted to install the .NET desktop runtime, install the required major version for x64 as indicated by the error.
File access and permissions	Make sure the configuration directory is writable; use standard permissions for regular connections	TUN or service features may require additional permissions. Not every startup issue is caused by insufficient permissions.

After downloading, open the saved location in File Explorer and select Extract all. Don’t run the program from inside the archive. Check the installation location when running the installer. If you’re keeping the old version for rollback, avoid sharing configuration directories between versions. After installation, open the main window and confirm the settings load before importing a subscription.

If the app closes immediately after launch, check the system message and client logs. A missing runtime, unreadable configuration, and blocked directory access are different problems with different fixes. Windows system proxy settings and TUN are separate features. For your first connection, test a node using the system proxy, then consider TUN based on which apps need traffic routed through it.

v2rayN · macOS

7.24.1

Open Apple menu → About This Mac and check the Chip or Processor field. Choose Apple Silicon for an Apple M-series chip, or Intel for an Intel processor. Don’t determine the architecture from the macOS version or the device’s purchase year.

Apple Silicon · arm64

Download for Apple Silicon

For Macs with Apple M-series chips. Choose the installer that matches your device’s native architecture to reduce variables when troubleshooting.

Intel · x64

Download for Intel

For Intel-based Macs. The 64 in the package name indicates this download is for x64; it is not a substitute for an arm64 package.

DMG disk imageApple Silicon / IntelDesktop graphical interface

Desktop subscription import steps

macOS Requirements and Installation Checks

Check	What to choose	Where to check or what to do
Processor architecture	Choose arm64 for Apple Silicon or x64 for Intel	Apple menu → About This Mac → Chip or Processor
System environment	Meet the minimum macOS requirements for the current release	Check your macOS version in About This Mac. Older systems may lack features required by the interface or network components.
Installation location	Copy the app to the Applications folder	Launch the app after copying it; don’t keep running it from a read-only disk image
System permissions	Grant the permissions required by your chosen network mode	Opening the app and authorizing network components are separate steps. Check for prompts under Privacy & Security in System Settings.

Open the downloaded DMG and copy the app to Applications as shown in the disk image window. Launch it from that folder. Once the app is no longer running from the image, you can eject it. If macOS blocks the app, verify its source and architecture, then read the specific message under Privacy & Security. Don’t disable system security protections just to launch an app.

The desktop client’s system proxy settings affect apps that follow those settings; they don’t guarantee that every program uses the same connection route. After importing a subscription, select a node and test with the default routing mode or one you understand. If an app still connects directly, check its proxy support and settings rather than repeatedly changing installers.

v2rayNG · Android

Recommended2.2.6

Built on the Xray core, with a graphical interface for importing subscriptions, share links, and QR codes. Choose v2rayNG when you need Xray-specific node features. Support for settings such as VLESS and REALITY depends on compatibility between the client core and server configuration.

arm64 · Recommended for most phones

Download v2rayNG for arm64

Most mainstream phones released since 2015 use arm64. Also confirm that the operating system supports 64-bit apps; processor specifications alone aren’t enough.

Universal · Multiple architectures

Download v2rayNG Universal

Choose this if you’re unsure of the device architecture. The package is usually larger than a single-architecture build and still requires a compatible OS version and installation environment.

Xray coreAPK installerAndroid VPN interface

v2flyNG · Android

Alternative · V2Fly core1.10.31

Choose this client if you need the V2Fly core. The key difference from v2rayNG is the core family, not the installer file extension. A similar interface doesn’t mean both clients support the same protocol fields and security options.

arm64 · 64-bit systems

Download v2flyNG for arm64

For devices that support arm64 apps. If you already have a V2Fly-compatible configuration, test it in a separate configuration environment first.

Universal · Multiple architectures

Download v2flyNG Universal

An alternative when the device architecture is unclear. You’ll still need to add a subscription and check the node’s transport and security settings after installation.

Compare protocol compatibility between Xray and V2Fly

Android Requirements and Installation Checks

Check	What to choose	Where to check or what to do
App architecture	Choose arm64 for 64-bit systems; choose Universal if unsure	Check your device’s system information. Even newer processors may run an OS that supports only a subset of architectures.
Windows version	Meet the minimum Android version declared for the current APK	Settings → About phone. If the installer reports incompatibility, check the version requirements first.
Installation permission	Allow the current browser or file manager to install apps	Grant permission only to the source you’re using. You can revoke it after installation if needed.
Connection permission	Approve the system VPN prompt on the first connection	Other VPN apps may already be using the same interface. Check for active connections before testing.

After downloading, open the APK from the notification shade or file manager. Check the app name and update prompt shown by the installer. If it reports a signature conflict, don’t uninstall and reinstall immediately: export your existing configuration and confirm whether the app came from a different signing channel before deciding how to migrate. Uninstalling usually deletes the app’s local data.

The first time you tap Connect, Android displays a VPN connection request. This permission lets the client handle device traffic; it doesn’t mean the node is already working. Test access after connecting. If the connection drops frequently in the background, check battery optimization, background activity restrictions, and network changes. Don’t disable every battery management feature as a first step.

v2rayN · Linux

7.24.1

First check whether your distribution uses deb or rpm, then choose x64 or arm64. The main downloads below are x64; arm64 users can select the matching package format at the bottom of the card. Package management system and processor architecture are separate requirements, and both must match.

x64 · deb

Download x64 deb package

For distributions that use the deb package system. amd64 in the file name corresponds to x64; it isn’t limited to a particular processor brand.

x64 · rpm

Download x64 rpm package

For distributions that use rpm and have compatible dependencies. Check the build target in the package name and review dependency warnings before installation.

arm64 devices

Download arm64 deb Download arm64 rpm

Desktop environmentx64 / arm64deb / rpm

Desktop client setup guide

Linux Requirements and Installation Checks

Check	What to choose	Where to check or what to do
Package management system	Debian and Ubuntu families generally use deb; Fedora and RHEL families generally use rpm	Check that your distribution or derivative’s installer supports the package format
Processor architecture	Choose x64 for x86_64 / amd64, or arm64 for aarch64	Check the About page in system settings or your hardware information; don’t rely on the distribution name alone
Desktop and dependencies	A graphical desktop environment and all runtime dependencies required by the current package	Let the package manager resolve dependencies; don’t force the installation past missing or conflicting packages
Network permissions	System proxy and TUN have different permission requirements	Test the connection in standard mode first. If you need TUN, follow the client’s permission prompts.

Open the downloaded package in your file manager and install it with your distribution’s package manager. If it reports missing dependencies, check your distribution version and software repositories instead of renaming an rpm to deb or forcing the installation. Changing the file extension doesn’t convert the package format or add missing system components.

After installation, launch v2rayN from the applications menu. Linux desktop environments handle system proxy settings differently, so browsers, desktop apps, and background processes may not use the same settings. Test with an app that explicitly supports the system proxy, then configure other apps as needed. Consider TUN only if you need to route a wider range of traffic.

Configuration Steps After Installation

First confirm the app launches, then set up your subscription and routing and test the connection.

Add a Subscription and Update Nodes

In v2rayN, open Subscription Group Settings, add a group, and enter a label and an optional URL. Save the group, then update the subscription. The group name is for local organization and doesn’t change your server account. Keep all subscription URL parameters intact; removing query parameters may prevent updates.

In v2rayNG, add the URL in Subscription Group Settings and update the subscription. If you have a single share link, use the appropriate import option instead of treating it as a subscription URL. Seeing a node in the list only confirms that its configuration loaded; test the connection to check whether it works.

View subscription import steps

Choose a Mode and Test the Connection

After selecting a node, start with a routing setup you understand. The system proxy mainly affects apps that follow system settings; TUN routes a wider range of traffic and involves additional permissions, routing, and DNS behavior. For your first setup, don’t change the core, DNS, and rules all at once, or it will be difficult to identify the cause of problems.

After connecting, check the client logs and test actual access. A latency figure reflects only a specific test method; it doesn’t measure download speed or guarantee that every app will work. If some addresses fail, identify whether the issue is the node, DNS, or routing rules before changing the relevant settings.

Learn about routing rules

Download and Installation FAQ

Find the issue by installation stage; don’t mistake a configuration problem for an installer issue.

Windows: Should You Download Desktop or WPF?

For a first installation, consider Desktop, which uses a newer cross-platform interface. Choose WPF if you prefer the classic Windows interface. Both downloads are x64 installers; subscription and node settings must still match your server configuration. Back up your settings before switching editions, and avoid running both instances with system proxy control enabled.

Android: Should You Choose arm64 or Universal?

Most mainstream phones released since 2015 will use arm64, but the supported app architecture depends on the operating system. Choose arm64 if your device runs a 64-bit OS. If the architecture is unclear or the installer reports an incompatibility, try the universal version, which includes multiple architectures and is usually larger.

How to Check Whether Your Mac Has Apple Silicon or Intel

Open About This Mac from the Apple menu and check the Chip or Processor field. If it shows an Apple M-series chip, choose Apple Silicon; if it shows an Intel processor, choose Intel. Don’t infer the architecture from the macOS version, device appearance, or purchase date.

Linux: Should You Choose deb or rpm?

Choose the package format used by your distribution: Debian, Ubuntu, and related distributions generally use deb; Fedora, RHEL, and related distributions generally use rpm. You’ll also need to match x64 or arm64. A matching package format alone doesn’t guarantee that your distribution version meets the runtime requirements.

Why Are There No Usable Nodes After Installing the Client?

The client reads configuration and establishes connections; the installer does not include your personal subscription or nodes. Get a valid subscription URL or share link, add it in subscription group settings, update the subscription, and then select a node. Subscription URLs may contain access credentials, so don’t show them in public screenshots or logs.

What Should You Keep Before Updating the Client?

Use the client’s backup or export feature to save your configuration. Note your subscription groups, routing mode, DNS settings, and custom rules, then quit the old instance. After upgrading, confirm the configuration loads before testing subscription updates and connections. Backups may contain sensitive settings; store them securely.