Client downloads · Choose by operating system

V2Ray Download

v2rayN、v2rayNG、v2flyNG

For desktop, choose v2rayN. For Android, v2rayNG is the first choice, with v2flyNG as an alternative using the V2Fly core. Check your operating system before choosing a package architecture.

Free to use Open source Configuration guides

Choose a package

Downloads by operating system

Select a platform to see its client. Package format, architecture, and installation notes are grouped together so you can check them before downloading.

Windows · v2rayN

x64 package. Choose Desktop or WPF; Desktop is a good starting point for a first install.

v2rayN

7.24.1Windows x64

Recommended

Desktop uses a newer cross-platform UI; WPF is the classic, stable edition. Both let you manage subscriptions, choose nodes, and configure a proxy. Pick the interface that suits you.

Download v2rayN · Desktop Download classic WPF

The download is a ZIP archive. Extract all files before running the installer; don't launch it from the archive preview.

Choosing between Desktop and WPF

New users can start with Desktop; users familiar with the traditional Windows interface may prefer WPF. Different interfaces don't mean different subscription contents, and protocol support depends on the configuration and what the client supports. Before switching editions, export or note your existing groups, routing rules, and local settings. Don't copy the entire old configuration directly into the new folder.

First checks after installation

Install the program in a location your account can write to. If startup reports a missing runtime, install the component named in the error. If security software blocks the app, check which file was flagged and why. Ordinary system proxy use generally doesn't require running as administrator. Grant permissions when prompted for network features such as TUN.

Windows requirements and installation checks

Check	What to look for	Installation notes
System architecture	This page provides an x64 package	Check System > About for your system type. Don't confuse x64 with arm64.
System environment	Use a supported Windows desktop environment	Check the installer for the exact minimum OS version and runtime requirements.
File permissions	Installation and configuration folders are writable	Quit the client before updating to prevent files from being locked by a running process.

If the client starts but your browser still isn't using the proxy, check the system proxy setting, then see whether another network tool has changed it. This is a connection configuration issue; reinstalling repeatedly won't help. See the v2rayN setup guide.

macOS · v2rayN

Download the DMG for your chip. Choose arm64 for Apple Silicon or x64 for Intel.

v2rayN

7.24.1macOS · DMG

Desktop client

Check your chip in Apple menu > About This Mac. Choose Apple Silicon if an Apple chip is listed, or the Intel package if it shows an Intel processor.

Download v2rayN · Apple Silicon Download for Intel

Open the DMG and follow the prompt to move the app to Applications, then launch it from there. Don't run it long-term from the mounted disk image.

Check both chip and system requirements

Your chip architecture determines which package to choose; your OS version determines whether the app has the runtime it needs. Both must be compatible. Even if your system offers a compatibility layer, the native architecture is usually the best choice. If the app says your OS version is unsupported, check the specific error rather than repeatedly trying both architectures.

Startup approval and proxy permissions

If macOS blocks the app on first launch, check the message under System Settings > Privacy & Security. Make sure it refers to the app you just downloaded, then follow the system's instructions. Don't disable system protection globally just to open one app. System proxy and TUN handle traffic differently, and TUN may need extra permissions. For your first connection, follow the guide to test one mode.

macOS requirements and installation checks

Check	What to look for	Installation notes
Apple Silicon	arm64 DMG	Use the chip information in About This Mac.
Intel	x64 DMG	Don't rely on the computer's appearance or purchase year alone.
System and permissions	Meets the app's actual runtime requirements	Keep system security checks enabled and grant access only when prompted.

Quit the old app before updating, then replace the corresponding item in Applications. After installation, make sure you're launching the new app, not an old copy pinned in the Dock. Existing subscriptions may need to be refreshed in the client; updating the app doesn't extend a subscription's validity.

Android · Two clients

Start with v2rayNG. Consider v2flyNG if your configuration requires the V2Fly core.

v2rayNG

2.2.6Android · Xray core

Recommended

Import subscriptions, choose nodes, and connect through a proxy on your phone. Most mainstream phones released after 2015 can start with arm64, but the device's supported app architecture is the deciding factor.

Download v2rayNG · arm64 Download universal

Grant install permission temporarily to the browser or file manager opening the APK. Revoke it after installation. When you connect for the first time, confirm the system VPN permission.

arm64 or universal

The arm64 package is for devices that support that architecture. The universal build supports more architectures and is a good option if you're unsure of your device's architecture, but the file is usually larger. If installation fails, identify whether the issue is incompatibility, a signature conflict, or low storage. Switching packages may help only if the architecture is wrong; not every installation error is an architecture problem.

If the connection drops after the phone has been locked for a while, check battery optimization and background activity limits. Adjust these only for clients that need it. Other VPN apps on your phone may use the same connection slot; close them while testing to avoid confusing results when apps replace each other's connection.

v2flyNG

1.10.31Android · V2Fly core

Alternative

For configurations that specifically require the V2Fly core. Before switching, confirm that the subscription's protocols and transport settings are supported.

Download v2flyNG · arm64 Download universal

Each Android client manages its own settings. Installing another app won't copy your existing groups or routing rules.

Check configuration compatibility before switching

Similar app names don't guarantee identical core features or configuration fields. Being able to import a subscription doesn't mean every node in it will work. Keep the original client installed, import the same subscription you're authorized to use into the alternative, and check its protocols, transport, and security settings. Test the connection before deciding whether to switch.

Android requirements and installation checks

Check	What to look for	Installation notes
App architecture	arm64 or universal	The architecture support provided by the OS is a more reliable guide than processor marketing specs.
OS version	Meets the APK's stated minimum requirements	A universal build can't bypass the minimum OS version.
Update installation	App signature matches the existing installation	If signatures conflict, back up your settings first; don't uninstall and risk losing them.
Connection permissions	System VPN permission	Start the permission request from the current client and verify the app name.

After installation, update your subscription and choose a node to connect. The VPN icon in the status bar only indicates that a tunnel is active; it doesn't guarantee the server is reachable. Check with a real connection test, the exit IP, and actual browsing results.

Linux · v2rayN

Check the package format for your distribution first, then choose x64 or arm64.

v2rayN

7.24.1Linux · deb / rpm

Desktop client

Debian- and Ubuntu-based systems usually use deb; distributions with RPM package management use rpm. The two main downloads below are x64; use the additional links for arm64 devices.

Download v2rayN · x64 deb Download x64 rpm

Additional arm64 packages arm64 deb arm64 rpm

A matching package format doesn't guarantee that every distribution meets the dependencies. Review the package manager's dependency report before installing.

Choose package format and architecture separately

deb and rpm describe package management formats; x64 and arm64 describe processor and runtime architectures. Neither replaces the other. amd64 and x86_64 commonly refer to the same x64 architecture; aarch64 commonly refers to arm64. Don't rename a file extension to convert a package, and don't ignore architecture mismatch warnings from the package manager.

Desktop environment and network permissions

v2rayN is a graphical client and requires a working desktop session and runtime dependencies. Installation permissions don't mean you need to use an elevated account for everyday use. Whether apps follow the system proxy depends on the desktop environment and each app's settings. For TUN, configure the required permissions as documented. When troubleshooting, test browser access first, then other apps to help distinguish node issues from traffic-routing issues.

Linux requirements and installation checks

Check	What to look for	Installation notes
Package format	deb or rpm	Check which formats your distribution's software installer supports.
Runtime architecture	x64 or arm64	Check the system architecture; don't rely on the device brand alone.
Runtime dependencies	Graphical desktop and compatible system libraries	Resolve missing dependencies shown in the report; don't force installation past errors.

When updating, stick with the same package management method where possible to avoid duplicate installs and confusing menu entries. If the app won't start after an upgrade, keep the error details and check for changed dependencies. Don't delete the configuration directory right away.

Downloads for other platforms

Platform switching requires JavaScript. You can download the Windows package now; to choose another platform, enable JavaScript and select its tab.

After installation

Import a subscription and make your first connection

Downloading is just the first step. Check your settings, connection mode, and real-world access in sequence to make issues easier to diagnose.

Prepare your configuration

Import a subscription group

Use a subscription URL you are authorized to access. Create a group in the client and update it. Subscription URLs may contain account credentials, so don't share the full URL in public screenshots or forums. If an update fails, check that the URL is valid and the subscription hasn't expired, then review the network path used for the request.

Node display names are just labels. Check the configuration and provider's documentation for the region, protocol, and transport settings; don't assume the actual exit location from a name alone. After importing, test one clearly available node first. There's no need to change all your routing and DNS settings at once.

View the subscription import guide →

Route your traffic

Choose a connection mode

On desktop, system proxy settings affect apps that follow the system proxy. TUN uses a virtual network interface to route eligible traffic. These aren't speed settings, and you don't need to enable both for more complete coverage. Choose one based on the apps you use and check the client's status.

On Android, the system VPN permission establishes the connection. Per-app proxy settings, routing rules, and DNS can still affect how individual apps connect. Disconnect the existing client before switching to avoid mistaking the old VPN connection for the new one.

View connection mode and routing guide →

Verify the result

Test the actual connection

Run the client's real connection test, then use a browser to check your exit IP and access to actual pages. A latency test only shows that its test path received a response; it doesn't prove that every site or app can connect.

If the browser works but another app doesn't, check whether that app follows the system proxy and whether routing rules send it direct. If all requests fail, try a known-good node, then check the subscription and network. Change one setting at a time and keep the original so you can revert and compare.

Quick guide to proxy and routing concepts →

Download FAQs

Package and update questions

Check package choice, installation environment, and connection settings separately instead of treating every issue as a download failure.

v2rayN Desktop or WPF: which should you choose?

For a first install, try Desktop, which uses a newer cross-platform interface. WPF is the classic, stable edition for users familiar with the traditional Windows interface. Menus may differ between the two. Back up subscription groups and custom settings before switching, and avoid running both versions with system proxy control enabled at the same time.

Should I download the arm64 or universal Android version?

Most mainstream phones released after 2015 can start with arm64, but the device's supported app architecture is the deciding factor. If you don't know the architecture or see an incompatibility error, try the universal build. It supports more architectures, but won't fix an outdated OS, low storage, or a signature conflict.

The client is free. Do I still need a subscription?

All three clients are free to use, but the client itself doesn't provide a connection service. Before using one, obtain a subscription URL or server configuration you're authorized to use. Provider plans, data limits, and expiration dates are separate from installing the client. This site does not provide nodes or subscriptions.

What should I check first if the download won't open?

First, make sure the package matches your OS and device architecture, then extract or install it as required. On Windows, check the runtime and folder permissions indicated by the error. On macOS, review the specific message under Privacy & Security. On Android, check install permissions and signature conflicts. On Linux, review dependency issues reported by the package manager. Don't disable system security features outright.

Do I need to uninstall the old version before updating?

Back up subscription groups, routing rules, and custom settings, then quit the old client. For the same client installed the same way, follow the installer’s update instructions; whether settings are retained depends on its prompts. If changing interface editions, package sources, or signatures, don't overwrite the configuration directory or uninstall before making a backup.

How can I confirm the connection is working after installation?

Import and update your subscription, choose an available node, and connect. On desktop, make sure system proxy or TUN mode is enabled as needed. On Android, confirm the system VPN permission. Then run a real connection test and check the exit IP and actual browsing results. A latency test alone doesn't mean every app is using the proxy.