Choose your operating system, then select the processor and package format.
Use v2rayN on desktop. On Android, v2rayNG is the recommended choice; use v2flyNG if you need its core. The buttons below link directly to the installers. For subscription import and proxy settings after installation, see the Getting Started guide.
Free foreverOpen sourceGraphical configuration
Choose a platform
Switch platforms to see the available clients. Match both the package format and processor architecture; don’t choose based on the file extension alone.
v2rayN
Windows · 7.24.1
Recommended
Desktop
A newer cross-platform interface— a good place to start for a first install.
The main differences are the interface technology and layout, not subscription tiers. Both Desktop and WPF require a valid configuration. If you already use v2rayN, note your subscription groups, routing mode, and ports before switching versions. Most new users only need to install one; running both at once may cause port conflicts.
After downloading, find the ZIP file in File Explorer and select Extract All. Open the extracted folder and run the installer—don’t launch it from the ZIP preview. Install to a folder with normal read and write permissions, and use a consistent location for future updates so you can find your configuration and logs.
Windows requirements and installation
Check
Download option
How to choose
Processor architecture
x64
Go to Settings → System → About and check System type to confirm it matches the x64 package.
Installation
Extract, then run the installer
Extract the archive first, then follow the installer prompts for runtime requirements and installation location.
Runtime requirements
Check the installer’s current requirements
If Windows is outdated or reports a missing runtime, address that first. Reinstalling or changing subscriptions won’t fix it.
Network permissions
Grant permissions for the mode you use
System proxy and TUN have different permission requirements. Finish the basic setup before enabling advanced modes.
After the first launch, import your subscription and confirm the server list. Then select “Set system proxy automatically.” Start by checking the “Bypass mainland China” routing mode. The system proxy only affects apps that follow system proxy settings. If an app isn’t using the proxy, check its own network settings before reinstalling the client.
Open the Apple menu in the top-left corner and select About This Mac. If Chip shows an Apple M-series processor, choose Apple Silicon. If Processor shows Intel, choose Intel. Macs with similar designs may use different chips, so don’t rely on the model name or year alone.
Open the DMG and copy the app to the Applications folder, then launch it from there. Don’t run it from the disk image long-term. If macOS shows a first-launch warning, read it carefully. If needed, check System Settings → Privacy & Security for an option to allow the app. Don’t disable system-wide security for a single app.
macOS requirements and installation
Check
Available packages
Check before installing
Chip type
ARM64 / x64
Check the chip or processor in About This Mac.
Install location
Applications folder
After copying the app, launch it from Applications, then eject the disk image.
macOS compatibility
Check the app’s current requirements
If you see a compatibility warning at launch, check your macOS version and selected architecture first.
Network configuration permissions
Grant permissions for the features you use
System proxy and TUN are configured separately. When prompted, confirm which app is requesting access and why.
After launching the client, import your subscription, then configure the system proxy and routing. If your browser still uses your regular connection, check the proxy status in macOS network settings and see whether the browser has its own proxy configuration. After waking from sleep, switching Wi-Fi networks, or using another network tool, confirm that the proxy is still active.
v2rayNG
Android · Xray core · 2.2.6
Recommended
arm64
Most phones released since 2015 should use arm64, but check the app architectures supported by your system.
v2rayNG uses the Xray core and is the recommended Android client on this page. Your client must support the protocols, transport methods, and additional parameters in your subscription. A successful import only means the configuration was read; it doesn’t confirm that the server is working. Select a server and connect, then test access in the apps you use.
v2flyNG
Android · V2Fly core · 1.10.31
Alternative
arm64
For devices that need the V2Fly core and support ARM64 apps.
v2flyNG is an alternative client that uses the V2Fly core, not an architecture patch for v2rayNG. Check configuration compatibility separately for each client, and don’t assume that parameters intended for Xray will work as-is. Choose this option if your existing configuration specifically requires V2Fly.
Android requirements and installation
Check
What to choose
What to check
App architecture
arm64 / Universal
Match both your device’s processor and the app architectures supported by your system. Don’t rely on the processor specs alone.
Installation permissions
The app you’re installing
If prompted, allow the browser or file manager to install unknown apps.
Connection permission
System VPN connection request
On the first connection, confirm the request comes from the client you selected before allowing it.
Background activity
Adjust your device’s battery settings
If the connection drops when the screen locks, check battery optimization and background activity restrictions.
If you see “App not installed” while installing an APK, check available storage, supported app architectures, and where the existing app came from. Apps from different sources may have different signatures and can’t always be installed over one another. Back up your subscription URL and important settings first. Don’t start by uninstalling—the local configuration may be removed too.
You usually only need one of the two clients. If you’ve installed both to compare configurations, stop the other client’s connection before testing this one. After approving the connection request, check per-app proxy rules as needed. Excluded apps may connect differently from your browser.
v2rayN
Linux · 7.24.1
deb · x64
For Debian- and Ubuntu-based distributions. Check your system architecture first.
Choose deb or rpm for your distribution, then select x64 or ARM64 for your hardware. amd64 and x86_64 both refer to the common x64 desktop architecture; arm64 and aarch64 refer to ARM64. A matching file extension doesn’t guarantee that all system dependencies are met, especially on older distributions. Check the package installer’s dependency warnings.
After downloading, open the package in your file manager and install it with your system’s package manager. Once installed, launch v2rayN from the applications menu. If the installer reports missing dependencies, check your distribution version and architecture; don’t force the installation by bypassing dependency checks. Desktop environments also differ in where network settings are managed, which can affect how system proxy settings apply.
Linux requirements and installation
Check
Available options
Where to check
Package format
deb / rpm
Check your distribution on the system’s About page, then use its package manager.
Processor architecture
x64 / ARM64
Check System Information for x86_64 or aarch64 and choose the matching download.
Desktop environment
Desktop session
This page provides a graphical client. After installation, launch it from your desktop’s applications menu.
System dependencies
Check the package requirements
If the installer reports missing dependencies, check distribution compatibility and package repository status first.
For your first setup, test the configuration with the standard proxy mode before trying TUN. Whether system proxy settings are honored depends on your desktop environment and the app. If a browser works but other programs don’t, check those programs’ proxy settings. TUN requires additional network permissions and routing changes, so test it separately from other virtual network tools. See Advanced Usage.
Setup after installation
The installer gets the client running. Subscriptions, proxy settings, and routing must be configured separately after launch. Checking them in order makes problems easier to diagnose.
Import a subscription or server configuration
In v2rayN, open Subscription Group, add a group, enter the subscription URL, and update it. In v2rayNG, add the URL in Subscription Settings, then update the subscription. A single share link isn’t the same as a subscription URL, so use the appropriate import option. After importing, confirm the server list contains an entry and select a server. The client doesn’t include servers, and installing it won’t create a subscription.
Confirm traffic is routed through the client
On desktop, check the system proxy settings. On Android, approve the system connection request the first time you connect. System proxy and routing are separate settings: the proxy determines whether an app sends traffic to the client; routing determines how that traffic is handled. For initial testing, don’t run multiple proxy tools or change the system proxy, TUN, and custom routing at the same time—it makes it harder to identify the cause of a problem.
Test access, then save your settings
Select a server and connect, then test with a browser and the apps you actually need. A connection icon alone doesn’t mean every app is using the proxy; check access in each target app. Once everything works, note your proxy mode, routing, and subscription group. Keep these working settings before changing DNS or TUN so you can restore them if something goes wrong.
First, identify whether the problem is with downloading, installing, launching, or connecting. An installer that won’t open and a subscription that won’t connect are usually different issues. Troubleshoot the relevant stage instead of downloading the same file again.
Keep a working configuration before updating
Record your subscription URL, group names, and any important custom settings. Subscription URLs may contain personal access credentials—don’t include them in public screenshots or share them with others. Close the running client before updating, and use an installer for the same client and architecture. Before switching versions or download sources, check whether your configuration can be migrated; don’t assume all settings will carry over automatically.
Troubleshoot installation and connection errors separately
If the system reports an architecture mismatch, missing dependencies, or a conflict with the installation source, fix the installation requirements first. If the client launches but subscription updates fail, check the subscription URL and your current network. If the subscription updates but apps can’t connect, check the selected server, proxy settings, and routing. There’s no need to uninstall right away. Keep the exact error message when troubleshooting; it’s more useful than just saying “it doesn’t work.”
Download buttons and file locations
After clicking Download, check your browser’s downloads list to see whether the transfer has started. The save location depends on your browser settings; you can usually open the containing folder from the downloads list. If no file appears, check the browser’s download prompts and your network, then try the same download again. Don’t open an incomplete download with the installer or try to install it by changing the file extension.
V2Ray client download FAQs
Common questions about package selection and first-time installation. Expand a question to see the answer.
Which v2rayN version should you choose for Windows: Desktop or WPF?
For a first install, try Desktop, which uses a newer cross-platform interface. WPF is the classic, stable Windows version for users who prefer the familiar layout. Both downloads are x64; most users only need one.
Which macOS package should you choose: Apple Silicon or Intel?
Open About This Mac from the Apple menu. Choose Apple Silicon if Chip shows an Apple M-series processor; choose Intel if Processor shows Intel. Check your chip type before installing—don’t judge by your Mac’s appearance.
What’s the difference between the arm64 and universal Android versions?
Most phones released since 2015 should use arm64, but check which app architectures your system supports. The universal version supports multiple architectures and is useful if you’re unsure or the arm64 package won’t install. It’s usually a larger download.
Do I need to install both v2rayNG and v2flyNG?
Usually, one is enough. v2rayNG uses the Xray core and is the recommended Android option here. v2flyNG uses the V2Fly core for configurations that require it. Check protocol and configuration compatibility for each, and avoid running both connections at the same time.
Should I download the deb or rpm package for Linux?
Choose the package format for your distribution, then select the processor architecture. Debian- and Ubuntu-based systems generally use deb; Fedora- and RHEL-based systems generally use rpm. x86_64 corresponds to x64, and aarch64 to ARM64. Check package dependencies with your system’s installer.
Can I connect right after downloading and installing the client?
You’ll also need to import a valid subscription or server configuration, select a server, and configure the proxy and routing. The client doesn’t include servers. For your first setup, import the subscription, check system proxy settings or connection permissions, then test access in the apps you use.
