Client Downloads · Choose by Platform

Download V2Ray clients

Choose your platform first, then the architecture. Use v2rayN on desktop and start with v2rayNG on Android.

Find installation options for three graphical clients here. Subscription URLs and server details must be prepared separately. For your first install, identify your device type; there's no need to install multiple clients.

First time here? Read the guide Compare the three clients →

Windows Downloads

Confirm your system is x64, then choose the interface you prefer. These are two interface versions of the same client; choose either one to get started.

v2rayN

Recommended 7.24.1

Desktop uses a newer cross-platform UI. The classic WPF version offers a stable experience with familiar Windows interactions. Subscription, proxy mode, and routing work on similar principles, though menus and runtime requirements may differ.

Desktop

Download Desktop · x64

A good starting point for a fresh install. Its cross-platform interface offers a consistent experience across desktop operating systems.

Classic WPF

Download WPF · x64

For users who prefer a classic desktop layout. Back up subscription groups and custom settings before reusing an existing configuration.

Archive format: ZIP Processor: x64 Desktop vs. WPF

System Requirements and Installation Prep

Check	What to look for	Tip
System and architecture	Windows x64	Check Settings → System → About for your system type. The downloads here aren't dedicated builds for other architectures.
Runtime	Check the selected package's requirements	If you see a missing runtime warning, install the required desktop runtime. Re-extracting the package won't fix it.
File location	A local folder you can read and write	Extract the entire package to its own folder, then run the installer inside. Don't launch it from the archive preview.
Proxy permissions	Standard proxy and TUN have different requirements	Test the system proxy first. If enabling TUN, grant the permissions required by the client.

After installation, add and update your subscription, then select a configuration. Switch to “Automatically configure system proxy” and test with an app that supports the system proxy. Before exiting, clear the system proxy to prevent apps from trying to use a local port that's no longer available. For the full walkthrough, see the Windows setup guide.

macOS Downloads

Open About This Mac from the Apple menu. If it lists an Apple chip, choose Apple Silicon; if it lists an Intel processor, choose Intel.

v2rayN

Desktop client 7.24.1

The macOS client uses a cross-platform desktop interface. The two packages are for different processors, but proxy setup is similar. Check your Mac's hardware details rather than guessing based on its age or appearance.

Apple Silicon

Download for Apple Silicon

An arm64 package for Macs with Apple chips. Choose the native architecture that matches your processor.

Intel

Download for Intel

An x64 package for Intel processors. If you see an incompatibility warning, check About This Mac to confirm your chip.

Disk image: DMGInterface: Desktop

System Requirements and Installation Prep

Check	What to look for	Tip
Chip architecture	Apple Silicon or Intel	Choose based on the chip or processor listed in About This Mac. Don't mix up the two packages.
System compatibility	Meets the selected package's requirements	For older systems, check the app's startup message. Back up important data before upgrading macOS.
Install location	Applications folder	Open the DMG and copy the app to Applications. Launch it from that folder after copying.
System permissions	Allow network configuration when prompted	If macOS shows a security warning, check the file's source and the warning details. Don't disable system security features wholesale.

On first launch, import your subscription before setting up the system proxy. If your browser works but other apps don't, check whether those apps use the system proxy before switching chip versions. TUN requires a virtual network interface and additional permissions; configure it separately after verifying a basic connection. See the cross-platform user guide for details.

Android Downloads

We recommend starting with v2rayNG. Most phones released since 2015 use arm64, but check which app architectures your device actually supports. If you're unsure, consider the universal version.

v2rayNG

Recommended 2.2.6

An Android graphical client using the Xray core. A good starting point for a first install; import configurations using a subscription URL or share link. Available protocols and transport options depend on the client version and server settings.

arm64

Download v2rayNG · arm64

Recommended for most 64-bit Android devices. Check your device information or system documentation to confirm its architecture.

Universal

Download v2rayNG · Universal

Supports more architectures. Try this if you're unsure which one your device uses; it won't resolve an outdated OS or signature conflict.

Package format: APKCore: Xray

v2flyNG

Alternative 1.10.31

An alternative Android client using the v2fly core. Consider it if your existing configuration depends on features of that core or you prefer its configuration behavior. Before switching from v2rayNG, confirm that the target version supports your protocols, transports, and security settings.

arm64

Download v2flyNG · arm64

For devices that support arm64 apps. You can add your existing subscription again; there's no need to copy server details by hand.

Universal

Download v2flyNG · Universal

An alternative if you're unsure of your device's architecture. After installation, import a configuration and allow permission to establish a local VPN connection.

Package format: APKCore: V2Fly

System Requirements and Installation Prep

Check	What to look for	Tip
App architecture	arm64 or Universal	A 64-bit processor doesn't necessarily mean the system supports every 64-bit app. Check which architectures your device actually supports.
System compatibility	Meets the package's stated requirements	If parsing fails, check that the download completed, the architecture matches, and the OS isn't too old.
Installation permission	Allow only the current installation source	Follow the system prompt to allow your browser or file manager to install apps. You can turn off permission for that source after installation.
Permissions at runtime	Local VPN and background activity	Confirm the system VPN prompt when connecting. If the connection drops when the screen locks, check battery optimization and background restrictions.

Usually, only one VPN app can run at a time. If another network tool is using the VPN connection, stop it before testing. Background restrictions can interrupt ongoing connections, but don't grant every permission upfront. Import a subscription, select a configuration, and connect first; then adjust settings based on what actually happens. See Getting Started for setup steps.

Linux Downloads

First check whether your distribution uses deb or rpm packages, then confirm whether your processor is x64 or arm64. Package format and processor architecture are separate requirements; both must match.

v2rayN

Desktop client 7.24.1

The Linux client uses a cross-platform desktop interface and requires a working graphical desktop environment. The main downloads below are for x64; arm64 packages are linked in smaller text. Don't choose based on the file extension alone.

deb package

Download deb · x64

For distributions that use deb packages, such as Debian and Ubuntu. Check compatibility with your system's dependencies.

arm64 devices: Download deb package →

rpm package

Download rpm · x64

For distributions that use rpm packages. A distribution label in the filename doesn't mean it will install on every rpm-based system.

arm64 devices: Download rpm package →

Common x64 labels: amd64 / x86_64Common arm64 label: aarch64

System Requirements and Installation Prep

Check	What to look for	Tip
Distribution package format	deb or rpm	Check your system information and package manager. Renaming a file extension doesn't convert a package.
Processor architecture	x64 or arm64	Check the processor and system type on your system's About page, then choose the matching architecture.
Desktop and dependencies	A graphical environment and compatible system libraries	Open the package with your system's software installer. Read dependency errors carefully; don't force installation by ignoring them.
Proxy and permissions	Configure for your desktop environment	Apps handle proxy settings differently. TUN requires device permissions, so verify the standard proxy first.

A successful installation doesn't mean every app will automatically use the proxy. Desktop environments, browsers, and standalone apps may each have different proxy settings. Import a configuration and start the client, then check the target app's proxy settings. To cover more apps, read the platform setup instructions in the user guide and configure TUN with the required permissions.

Version labels and download links are updated from the download list. Select a package to download it; this page lists the full package links. Check the client after installation to see the version actually installed.

Three Things to Check Before and After Installation

Choosing a download answers “Which package should I install?” A working connection also depends on your configuration, proxy settings, and system permissions.

Before installation

Check your architecture and existing settings

Check your device's system information before choosing a package. Before upgrading, note the installation location and save your subscription groups, custom routing, and any settings you need to migrate. Don't keep your only backup in a folder you're about to overwrite or delete.

If installation fails, read the error first: architecture mismatch, a missing runtime, and insufficient permissions are different problems. Repeatedly downloading the same package usually won't change your system setup.

First launch

Import a subscription or share link

A subscription URL is an updateable source of configurations; a single share link usually contains just one configuration. Copy the complete link, import it through the appropriate option in your client, and confirm the configuration appears in the list.

If a subscription update fails, check that the URL is complete and hasn't expired, and check the network path used for the update request. URLs may contain credentials, so hide sensitive details in screenshots and support requests.

Share links vs. subscription URLs →

Test the connection

Start with the system proxy; use TUN if needed

On desktop, test the system proxy with an app that supports it. On Android, allow the local VPN connection when prompted. Once the basic connection works, adjust advanced settings such as routing, background restrictions, or TUN.

TUN isn't a switch you have to turn on when a connection fails. Change one setting at a time to identify whether the issue is with the installation environment, subscription settings, or the target app's proxy behavior.

View the complete setup guide →

Download and Installation FAQ

First choose the right package, then troubleshoot configuration and connection issues. Expand a question to see the answer.

Which should you choose: the Windows Desktop or WPF version?

If this is your first time, start with Desktop, which features a newer cross-platform interface. If you prefer the classic Windows interface, choose the stable WPF version. Both require a correctly imported configuration; switching interfaces won't fix subscription or network issues.

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

Most phones released since 2015 will use arm64, but check which app architectures your device actually supports. If you're unsure or see an incompatibility message, try the universal version. It supports more architectures, but doesn't improve connection performance.

Do I need a subscription URL after downloading the client?

The client manages configuration and connections; the download doesn't include a ready-to-use subscription service. You'll need a subscription URL, share link, or server details that you're authorized to use, then import them into the client. Subscription URLs may contain credentials, so don't share them publicly.

How do I keep my existing settings when updating the client?

Exit the client first. Note its installation location, subscription groups, custom routing, and proxy settings, then use the client's export or backup feature to save your configuration. It may contain sensitive information, so store it securely. Remove the old directory only after confirming the new version starts and imports successfully.

Why don't the version number and the number in the download filename match?

The version label and package URL are separate fields in the download list, so they may be updated at different times. The number in a filename also doesn't necessarily reflect the version shown in the client. Check About or Version Information after installation, and don't edit numbers in download URLs yourself.

Can't connect after installation. Should I try a different package?

If the client starts normally, first check that the subscription imported successfully, a configuration is selected, the system clock is correct, and the target app uses the system proxy. TUN also requires the relevant permissions and components. Check the package first only if you see an architecture mismatch, installation failure, or startup error.