Clients, packages, and architectures

V2Ray client downloads

Choose v2rayN for desktop or v2rayNG for Android.

Select your operating system, then check the processor architecture and package format. Separate downloads are available for desktop interface versions, chip types, and universal packages. Install the download using the steps for your operating system.

First-time setup: read the getting started guide Compare the three clients

Windows downloads

v2rayN · x64 · Desktop / WPF

v2rayN

Recommended

7.24.1 Windows x64 GUI configuration and subscription management

Desktop version

A newer cross-platform UI. A good place to start for a first install.

Download v2rayN Desktop

x64 · ZIP archive

Classic WPF version

A classic, stable interface for users who prefer the traditional desktop workflow.

Download v2rayN WPF

x64 · ZIP archive

The main difference between these downloads is the interface technology and layout. Desktop and WPF are not different proxy protocols. Whether a subscription works depends on the node parameters, selected core, and transport settings. For your first session, import a configuration and test the connection before adjusting routing, DNS, or shortcuts.

After downloading, extract the entire ZIP archive to a writable folder using your system’s extraction tool. Then open the installer from the extracted folder and follow the prompts. Don’t run it from the archive preview. If a required runtime is missing, follow the installer’s instructions for the named component. Check the installer for supported Windows versions, required runtimes, and installation path details.

To migrate from an existing version, back up your configuration and close the old client first. The new interface may place familiar settings elsewhere. After importing, check the selected server, listening port, and system proxy status. Run only one client that manages the system proxy while testing, to prevent an old process from holding a port or overwriting proxy settings.

Windows system and installation requirements

Check	Requirement	Where to check or notes
Operating system	Windows desktop environment	Open Settings → System → About and check your Windows version.
Processor architecture	x64	Check System type. Both Windows packages on this page are x64.
Package format	Installer included in ZIP	Extract the entire archive before running the installer; don’t pull out a single dependency file.
Runtime requirements	Writable folder and required runtimes	Follow the installer’s prompts for dependencies. Standard system proxy use and TUN mode have different permission requirements.

If your device runs an ARM-based operating system, don’t choose this x64 package based on the system name alone. First check system compatibility and client support.

macOS downloads

v2rayN · Apple Silicon / Intel · DMG

v2rayN

Desktop client

7.24.1 macOS Choose by chip

Apple Silicon

For devices listed with an Apple M-series chip in About This Mac.

Download v2rayN · arm64

Apple Silicon · DMG disk image

Intel

For devices listed with an Intel processor in About This Mac.

Download v2rayN · Intel

x64 · DMG disk image

Check the chip in System Information; don’t infer it from the model name or purchase year. Open the Apple menu and choose About This Mac. If it lists Chip followed by an Apple M-series name, choose arm64. If it lists Processor followed by an Intel name, choose x64. Matching the package to your processor helps avoid differences caused by compatibility layers.

Open the downloaded DMG and drag the app into Applications. Launch it from that folder. Don’t keep running the app from the mounted disk image, as its location and update path may not work as expected. Eject the disk image after copying. Before updating an existing app, quit it and back up your configuration.

If you see a system warning on first launch, check the file’s source and the reason for the warning. Then review the available options under System Settings → Privacy & Security. Don’t disable system protections globally for a single app. Once the app is allowed to open, test the imported configuration with the standard system proxy before trying other proxy modes.

macOS system and installation requirements

Check	How to choose	Installation notes
Chip type	Apple Silicon / Intel	Apple menu → About This Mac. Choose based on the chip or processor shown.
Package format	DMG	Mount the disk image, copy the app to Applications, and launch it from there.
System compatibility	Check the current app requirements	Check your macOS version. If the app won’t launch, start with the system warning.
Permissions	App launch and proxy settings permissions	Grant permissions as prompted. Additional network-routing modes may require elevated permissions.

Android downloads

Start with v2rayNG; consider v2flyNG if your configuration calls for it.

v2rayNG

Recommended · Xray core

2.2.6 Android APK package

arm64

Usually the first choice for mainstream phones released after 2015. Check your system architecture before downloading.

Download v2rayNG · arm64

arm64-v8a · architecture-specific package

Universal version

Choose the universal version if you’re unsure of your architecture or the arm64 package isn’t compatible.

Download v2rayNG · Universal

Universal · multi-architecture package

v2rayNG is an Android GUI client powered by the Xray core. Use it to manage subscriptions, import configurations, and switch servers on your phone. Compatibility depends on the protocol and transport parameters in your configuration. A successful import only means the client can read the entry; it doesn’t guarantee that the remote server is reachable. If a protocol isn’t working, first check the instructions provided with the configuration.

After downloading the APK, open it from your browser’s downloads or a file manager. If Android asks you to allow installs from this source, grant the permission only to the browser or file manager you’re using. You can revoke it after installation. When you launch the client and connect for the first time, Android will prompt you to authorize a VPN connection. Check the app name before granting access.

v2flyNG

Alternative · V2Fly core

1.10.31 Android APK package

arm64

For devices that support 64-bit ARM apps. Check your system’s actual capabilities.

Download v2flyNG · arm64

arm64-v8a · architecture-specific package

Universal version

Supports multiple architectures, making it a suitable choice when you’re unsure which app architecture your device uses.

Download v2flyNG · Universal

Universal · multi-architecture package

v2flyNG uses the V2Fly core and is an alternative when your configuration is specifically intended for that core. It isn’t simply the same app under a different name as v2rayNG; core features and supported parameters may differ. In particular, don’t assume a shared link will work the same way in both clients if it uses core-specific extensions.

You can keep configurations in both apps, but stop the VPN session in one before connecting with the other. Android’s active VPN affects how network traffic is routed, and switching back and forth can make troubleshooting harder. If background connections keep dropping, check your system’s battery restrictions for the client and make sure another VPN app isn’t controlling the connection.

Android system and installation requirements

Check	How to choose	What to check
App architecture	arm64 or universal	A 64-bit processor doesn’t necessarily mean the system can install every 64-bit app.
Package format	APK	Allow installs from this source and check the installer’s specific prompts.
System version	Check the requirements for the current APK	Open Settings → About phone to check your Android version.
Network permissions	Android VPN permission	Approve the system prompt on first connection. Keep only the VPN connection you need active.
Update requirements	Package name, signature, and version must be compatible	If Android says the app can’t be installed over the existing version, back up your configuration first. Uninstalling could erase it.

The version shown on the download card and the actual filename come from different manifest fields. If they differ, check the app details shown by the installer to determine whether an update is compatible. Don’t uninstall the existing app based on the card text alone.

Linux downloads

v2rayN · deb / rpm · x64 is the primary option

v2rayN

Desktop GUI

7.24.1 Linux x64 / arm64

deb package

For desktop environments that use deb packages. Check your distribution’s dependencies first.

Download v2rayN · x64 deb ARM devices: download arm64 deb

rpm package

For desktop environments that use rpm packages. Note the el10 tag on this package.

Download v2rayN · x64 rpm ARM devices: download arm64 rpm

On Linux, check both the architecture and package management system. Most 64-bit Intel and AMD desktop processors use x64, listed as amd64 or x86_64 in filenames. For 64-bit ARM systems, choose arm64, sometimes listed as aarch64. These names refer to the processor platform the package targets, not different app features.

The distribution’s package management system determines whether you need deb or rpm; changing the file extension won’t convert one to the other. Open the download with your system’s software installer. Review the architecture, dependency, and conflict warnings before confirming. The current rpm filename includes an el10 tag, but that doesn’t mean it will install on every rpm-based distribution. If required system libraries are missing or incompatible, stop and check your environment.

This is a desktop GUI client, not a deployment package for headless servers. After installation, launch it from the app menu, import your configuration, and check the local listener before setting up the desktop proxy. Desktop environments and apps may handle proxy settings differently. If a browser works but other programs don’t, check whether those programs follow the system proxy settings.

Linux system and installation requirements

Check	Requirement	Check before installing
Runtime environment	Linux desktop environment	Requires a desktop session that can launch apps and the relevant runtime dependencies.
Processor architecture	x64 / arm64	Check the architecture under About or in your system’s hardware information.
Package management system	deb / rpm	Choose the package for your distribution; changing the file extension won’t convert it.
Dependencies	Check the software installer’s result	The rpm package has an el10 tag. Check your distribution and system library compatibility.
Installation permissions	System software installation permissions	The installer may ask you to authenticate. During normal use, grant permissions for the proxy mode you need.

After installation

Import a configuration and make your first connection

The package installs the app; subscriptions and node details determine where it connects. Check each step in order instead of changing multiple settings at once.

01 / Configuration source

Get subscription or node details

The client doesn’t provide a server account. First get a subscription link, share link, or complete connection details that you’re authorized to use. Add them through the client’s subscription manager, clipboard import, or another available option. Subscription links may include account identifiers or access credentials. When copying one, leave out any accompanying instructions, and never post the full link in a public forum.

After importing, check that the group appears and the number of entries looks right, then select a server. A failed subscription update and a failed server connection are different problems: for the former, check the link, network, and format; for the latter, check the protocol, time, and transport settings. Reinstalling the app repeatedly won’t fix a subscription format issue.

02 / Traffic entry point

Set up the system proxy or VPN

On desktop, the system proxy determines whether apps send requests to the local listening port. The routing mode determines which outbound route handles requests that reach the client. These are separate settings. Make sure the client is running, then enable automatic system proxy configuration. Importing a configuration alone doesn’t ensure your browser will use the proxy.

On Android, you must authorize the system VPN when you first connect. If another VPN app is active, decide which connection to keep first. Don’t start by layering on complex DNS settings, app-based routing, and custom rules. Establish a connection with basic settings that you can verify, then add features as needed.

03 / Verify the connection

Test first, then adjust routing

Open a familiar website and check that the page loads and domain names resolve. Then review the client log for specific errors. If one app can’t connect, first check whether it uses the system proxy instead of immediately changing the package. If nothing can connect, check the selected server, local port conflicts, device time, and subscription details in that order.

Before stopping, clear the system proxy on desktop and then exit the client, so apps don’t keep sending requests to a closed local port. Check the proxy status again after an update or migration. For step-by-step instructions, see the getting started guide. For details on how inbounds, routing, and dns fields work together, read the JSON configuration manual.

Download and installation FAQ

Common installation questions

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

For a first-time install, start with the Desktop version, which uses a newer cross-platform interface. Choose the classic, stable WPF version if you prefer the traditional desktop workflow. Both downloads are x64 packages. Back up your configuration before switching versions, and don’t let both instances manage the system proxy at the same time.

Which macOS download should you choose: Apple Silicon or Intel?

Open About This Mac from the Apple menu. If Chip shows an Apple M-series name, choose Apple Silicon (arm64). If Processor shows Intel, choose Intel (x64). Choose based on the actual processor, not the computer’s purchase year.

What’s the difference between the Android arm64 and universal versions?

The arm64 package is for 64-bit ARM devices and is usually the first choice for mainstream phones released after 2015. The universal version supports multiple architectures and suits devices with an unknown architecture or where the dedicated package isn’t compatible. Newer processors may also run systems with different bitness, so check which app architectures your device actually supports.

Can I connect as soon as the client is installed?

The client manages configurations and connections, but the installer doesn’t include a usable server configuration. You’ll need a subscription link or node details that you’re authorized to use. Import them, select a server, then configure the system proxy or grant Android VPN permission. Subscription links may contain access credentials, so don’t share them publicly.

What should I back up before updating the client?

First note the client name and where its configuration is stored. Use the client’s backup or export feature to save your settings, subscription groups, and custom routing rules. Close the running client before updating. Afterward, check your subscriptions, listening ports, and proxy mode. Don’t delete your existing configuration just to troubleshoot a routine update.

What should I do if Linux reports missing dependencies during installation?

Check the distribution’s package format and processor architecture, then review the specific dependencies listed by the system installer. You can’t convert deb to rpm, or vice versa, by simply changing the file extension. Even rpm-based distributions may require different dependency versions. The rpm file offered here includes an el10 tag; make sure your distribution meets its requirements before installing.