CLIENT PACKAGES / V2RAY

V2Ray Client Downloads.

Use v2rayN on desktop and v2rayNG on Android. Check your operating system and CPU architecture before downloading the right package.

Free, open-source clients Desktop and mobile downloads Setup guide →

SELECT YOUR SYSTEM

Choose a package by operating system

A client may be available in multiple editions, CPU architectures, and package formats. The recommended option is listed first, with alternatives below. Follow the platform-specific instructions after downloading.

Windows · v2rayN

This section offers x64 packages. Check your processor architecture under System type in Settings, then choose the desktop or classic WPF edition. You don’t need to install both.

v2rayN

7.24.1

Recommended

The desktop edition uses a next-generation cross-platform UI. The classic WPF edition retains the familiar Windows layout. If this is your first installation, start with the desktop edition.

Download Desktop · x64 Download Classic WPF · x64

Choosing an edition: The desktop edition is a good fit if you want a consistent experience across desktop operating systems. Choose WPF if you’re already familiar with the classic menus, server list, and settings layout. A different interface doesn’t mean server configurations are interchangeable. Keep your original subscription and any custom rules when switching.

Installation: After downloading the ZIP file, extract it fully to a separate folder, then run the installer inside. Don’t launch it from within the archive or overwrite a running installation. Follow the setup wizard, then launch the client from the Start menu or its installation folder.

Before updating: If you have existing settings, export or back them up first, then quit the old instance from the system tray. Running both versions at once can cause port conflicts, repeated changes to the system proxy, or confusion over where settings are saved. Once you’ve confirmed the new version can read your configuration, remove any old folders you no longer need.

Windows system and installation checks

Windows package selection and system checks
Check	Requirement and guidance
Processor	Both downloads on this page are x64. Check System Information rather than judging by the device’s appearance.
System	Use a supported version of Windows. Check the release’s installation prompts for exact OS and runtime requirements.
Installation files	Extract the ZIP before running the installer, and keep the configuration location writable.
Permissions and traffic routing	Standard system proxy and TUN have different permission requirements. Verify a standard connection first.

Continue to the v2rayN user guide →

macOS · v2rayN

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. The same macOS version doesn’t mean the packages use the same architecture.

v2rayN

7.24.1

Choose the DMG for your processor: arm64 for Apple Silicon and x64 for Intel. Prefer the build that matches your device’s native architecture.

Download Apple Silicon · arm64 Download Intel · x64

Install location: Open the DMG and follow the window’s instructions to move the app to the Applications folder. Launch it from there. Running the app from a mounted disk image can make updates, file paths, and launch locations confusing. Eject the disk image once copying is complete.

First launch: If macOS blocks the app, verify its download source and review the system alert, then follow the supported steps under Privacy & Security. Don’t disable security protections system-wide or paste commands from untrusted sources into Terminal. If macOS reports that the app is incompatible, check your processor and system version first.

Before connecting: After installation, import a subscription, select a working server, and then enable the system proxy. The system proxy affects only apps that honor that setting; a working browser connection doesn’t mean every app uses the same route. If you need TUN, review the separate guidance on permissions, routing, and DNS.

macOS system and installation checks

macOS package selection and system checks
Check	Requirement and guidance
Apple Silicon	If About This Mac lists an Apple chip, choose the arm64 DMG.
Intel	If About This Mac lists an Intel processor, choose the x64 DMG.
System version	Check the release notes and system installer prompts for minimum requirements. Verify compatibility before installing on an older system.
Permissions	Make sure the app can save its configuration. Grant permissions as prompted when enabling system-level traffic routing.

See proxy, routing, and DNS configuration guidance →

Android · Android clients

For most users, v2rayNG with the Xray core is the recommended choice. Consider v2flyNG if you already rely on V2Fly configurations. Each app manages its own settings, so save your subscriptions and anything else you need before switching; don’t assume one app can read the other’s data.

v2rayNG

2.2.6

Recommended

Android client with the Xray core. Most mainstream phones released after 2015 are best served by the arm64 build. If you’re unsure of your device’s architecture, choose universal.

Download v2rayNG · arm64 Download v2rayNG · Universal

Choosing an architecture: The arm64 package is for devices that support this app architecture. The universal build includes multiple architectures and is a good fallback if you’re unsure about your device. A phone’s release year is only a rough guide; check its processor support and the architectures enabled by its system. The universal build doesn’t bypass Android version requirements.

Installation and permissions: Open the downloaded APK and follow Android’s prompts to allow your browser or file manager to install apps. Grant the required permission only to the source you’re using, and revoke it after installation if you wish. The first time you connect, Android will ask for VPN permission. This system prompt is required for the client to route traffic on your device.

About version details: The version label comes from the manifest’s latest version field, while the file URL comes from the platform download field. If the numbers differ, use the provided download URL as-is; don’t change the filename manually. Check the app’s About page to see the installed version.

v2flyNG

1.10.31

Alternative · V2Fly core

For users already set up with V2Fly configurations. Check that the server protocol and configuration fields are supported by the current core before switching clients.

Download v2flyNG · arm64 Download v2flyNG · Universal

Compatibility: Similar interfaces don’t guarantee identical core capabilities. A link that imports in one client may not preserve every transport parameter in another. If a protocol field isn’t recognized, check the configuration reference instead of repeatedly switching installation packages.

Switching clients: Disconnect in the current client before launching the new one and importing your configuration again. Android typically allows only one standard VPN service to be active at a time, so other VPN apps may interfere with traffic routing. Keep the old app’s data until you’ve verified the new configuration, then decide whether to remove it.

Android system and installation checks

Android package selection and system checks
Check	Requirement and guidance
App architecture	Choose arm64 for devices that support it; if you’re unsure, choose universal.
System compatibility	Check the minimum system requirements and installation prompts for your version. The universal build isn’t a compatibility fix for older systems.
Installation source	If needed, allow the app downloading or opening the APK to install apps.
Background operation	If the connection drops when the screen locks, check battery optimization, background restrictions, and VPN service status.

See how to import subscriptions and connect with v2rayNG →

Linux · v2rayN

First check which package format your distribution uses, then confirm your processor architecture. deb and rpm are different package formats. amd64 and x86_64 usually indicate x64 architecture; arm64 and aarch64 are the corresponding labels for a different architecture.

v2rayN

7.24.1

Desktop GUI client with x64 packages as the main option. Debian, Ubuntu, and similar distributions typically use deb. Choose rpm for RPM-based distributions, and check that your distribution is supported.

Download deb · x64 Download rpm · x64

arm64 devices: Download deb · arm64 Download rpm · arm64

Installation: Open the package with your distribution’s software installer, then review its dependencies and installation results. The same file extension doesn’t guarantee compatibility with every distribution. Pay particular attention to the build environment, system library versions, and desktop requirements. If the installer reports missing dependencies, don’t force the installation.

Runtime environment: These packages are for systems with a graphical desktop session. After installation, launch the app from the applications menu and check that the main window, tray icon, and logs work as expected. Desktop environments handle system proxies differently, so check whether your browser and other apps use the system proxy settings.

Routing traffic: Test your server configuration with a standard proxy before trying TUN. Virtual interfaces, permissions, DNS, and routing rules are runtime settings; choosing deb or rpm won’t configure them for you. Before enabling a different routing mode, stop other proxy apps that modify the default route to avoid hard-to-diagnose conflicts.

Linux system and installation checks

Linux package selection and system checks
Check	Requirement and guidance
Package format	Choose deb or rpm for your distribution. Renaming a file extension does not convert its package format.
Processor architecture	For x64, use amd64 or x86_64 packages; for arm64, use arm64 or aarch64 packages.
Desktop dependencies	A working graphical desktop and the required dependencies are needed. Check your package manager and the distribution’s release notes for details.
Installation permissions	Grant installation permissions as required by your system. Handle permissions for running the app and using TUN separately.

See inbound listening and routing configuration guidance →

AFTER INSTALLATION

Setup steps after installation

Downloading gets the app on your device, but connecting also depends on server configuration, proxy mode, and app behavior. Testing each part separately is usually more effective than reinstalling repeatedly.

Keep your configuration source safe

Use a subscription URL or share link that you obtained yourself and are authorized to use, and make sure it’s complete. Subscription URLs may contain credentials, so store them securely. Don’t share the full URL in screenshots, logs, or support requests. The client download does not include a server.
Import a configuration and choose a server

Add the configuration from the client’s subscription or import menu. After updating, check that the server list contains a usable entry. A successful import only means the client read the configuration; it doesn’t guarantee the server is reachable. Select a server, then run the connection test provided by the client.
Enable a mode and test your apps

On desktop, start with the system proxy. On Android, approve the VPN permission prompt. Then test access in the app you want to use and check the logs. Consider the test results, browser behavior, and actual traffic route together; a changed connection button alone isn’t proof of success.

Read the complete user guide Browse configuration fields

DOWNLOAD QUESTIONS

Download and update FAQ

Identify whether the issue is with installation, configuration, or network connectivity before deciding what to check next.

Can I connect right after downloading the client?

The client reads configurations and forwards traffic; the installation package does not include a usable server. After installation, import a subscription URL or server configuration you obtained yourself and are authorized to use, then select a server and enable the appropriate proxy mode.

Which should I choose: the Windows desktop edition or classic WPF edition?

If you’re new to v2rayN, start with the desktop edition’s next-generation cross-platform interface. Choose the WPF edition if you prefer the familiar classic Windows layout. Both are v2rayN. Back up your configuration before switching, and don’t run both instances with system proxy control enabled or the same ports in use.

Should I download the arm64 or universal version for Android?

Most mainstream phones released after 2015 will generally use arm64, but check the device’s processor and the app architectures supported by its system. If you’re unsure, choose the universal build. If installation fails, also check system compatibility, available storage, and the signature of any existing app; architecture may not be the cause.

Do I need to uninstall the old version before updating?

As a rule, back up first, then update using the same client, release source, and installation method. Quit the desktop app before updating. On Android, an in-place update usually works if the signing key matches. If you encounter a signature conflict, don’t uninstall right away; export your configuration and confirm how to restore it first.

Why doesn’t the version label match the number in the installer filename?

The version label on a client card comes from the manifest’s latest field, while the download URL comes from that platform’s download field. These are independent values. If the numbers differ, don’t edit the filename or construct a URL yourself. Check the installed version in the client’s About page.

The client installed, but won’t connect. Should I download it again?

First make sure the client starts normally. Then check for subscription updates, the selected server, system time, proxy mode, and logs. Troubleshoot installation and connection issues separately. Revisit the installation steps and system compatibility only if the installer won’t open or the app fails to start.

For help troubleshooting subscriptions, connections, or logs, visit the FAQ, or look up individual fields in the configuration reference.

V2Ray Client Downloads.

Choose a package by operating system

Windows · v2rayN

v2rayN

Windows system and installation checks

macOS · v2rayN

v2rayN

macOS system and installation checks

Android · Android clients

v2rayNG

v2flyNG

Android system and installation checks

Linux · v2rayN

v2rayN

Linux system and installation checks

Setup steps after installation

Keep your configuration source safe

Import a configuration and choose a server

Enable a mode and test your apps

Download and update FAQ