Choose your operating system, then check the processor architecture. Use v2rayN on desktop. For Android, v2rayNG is the recommended choice; choose v2flyNG if you need the V2Fly core ecosystem.
The stable edition with the classic Windows interface. Choose it if you're familiar with the original menus, subscription groups, and settings, and prefer not to switch interfaces.
Extract the entire archive before running the installer. Both links provide ZIP files. Don't launch the installer from the archive preview. Extract the files to a location you can read and write to, then follow the included installer's instructions. The editions share an app name, but that doesn't mean they can safely overwrite the same data folder.
After installation, open v2rayN as a standard user and check that the main window displays correctly. If Windows reports a missing runtime component, install the required dependency as prompted by the installer or system. Don't leave security settings disabled to fix a startup issue. On a managed device, check that you're allowed to install software first.
For your first setup, import a subscription, choose a server, and then enable automatic system proxy settings. TUN handles more of your traffic and may require additional permissions. First make sure the regular system proxy works, then configure TUN if needed. Clear the system proxy before exiting the client to avoid losing internet access when its proxy port stops.
Windows Requirements and Installation Checks
Check
What to look for
Processor and system
Both installers on this page are x64. Check your system type in Settings > System > About. The x64 package isn't compatible with every architecture.
Windows compatibility
Use a Windows version that still receives security updates from Microsoft where possible. Support on older systems depends on the client release and its runtime requirements; follow the installer's prompts.
Installation and file permissions
The extraction folder must be writable. Installation, creating a network adapter, or enabling TUN may require administrator approval.
Before you start
Have a trusted subscription or complete server details ready. Check that your system clock is correct and that no other program is using the local proxy port.
For Macs with Intel processors. Check About This Mac; devices bought in the same year may have different chips.
After opening the DMG, move the app to Applications. Launch it from Applications once copying is complete, rather than running it from the disk image. Before updating an existing installation, quit v2rayN. If macOS says the app is still in use, check the menu bar and background processes before replacing it.
You may see a security prompt the first time you launch the app. Check the download source and app name, then follow the relevant instructions in macOS Privacy & Security settings. Don't use Terminal commands that disable system protections. If macOS reports that the app is damaged, the architecture is incompatible, or your system version is unsupported, check the package and your device before proceeding.
After importing a subscription, check that the system proxy is enabled for your current network service. Wi-Fi and Ethernet may use different proxy settings, so check again after switching networks. If you only need to proxy browser traffic, start with the system proxy. For other apps, review the TUN permissions and routing instructions.
macOS Requirements and Installation Checks
Check
What to look for
Chip architecture
Choose arm64 for Apple M-series chips and x64 for Intel processors. Use the package that matches your Mac's architecture.
Windows compatibility
Check the installer for the app's current minimum macOS version. Verify your system version before installing; a DMG mounting successfully doesn't mean the app is compatible.
Installation location
Use a writable Applications folder. On managed devices, follow your organization's app installation policies.
Network permissions
Grant permission when prompted to change system proxy settings or use TUN. If other network tools are running, check for conflicts first.
Most mainstream phones released after 2015 can start with arm64. Some devices have a 64-bit processor but only support 32-bit apps, so check your system information.
Choose this if you're unsure of your architecture or the arm64 package won't install. The universal build supports multiple architectures and is usually larger. You don't need to install it alongside the arm64 build.
When you open the APK, Android may ask you to allow your browser or file manager to install apps. Grant permission only to the trusted source you're using, and revoke it in Settings after installation if you like. If you see a conflict with an existing app, check its source and signature first; don't uninstall it without considering whether you'll lose its settings.
v2rayNG uses Android's VPN service to route traffic. The first time you connect, you'll need to approve the system VPN prompt; this doesn't provide a server subscription. Import a subscription and select a configuration before connecting. If the connection drops in the background, check battery optimization and background limits rather than repeatedly reinstalling the app.
v2flyNG
Alternative · V2Fly core1.10.31
Android · For V2Fly core users and compatible configurations
An alternative if you're unsure of your device's architecture. Before switching clients, check that the protocols, transports, and security settings in your subscription are supported by the core.
v2flyNG and v2rayNG are different clients; a similar interface doesn't guarantee configuration compatibility. V2Fly and Xray share an ecosystem background, but their features evolve independently. Settings specific to one core may not transfer directly. If an import reports unsupported parameters, check the protocol and transport combination rather than deleting essential fields to force it to run.
The two apps can store settings separately, but usually only one can use Android's VPN connection at a time. Stop the other app's connection before testing an alternative to avoid mistaking a replaced VPN authorization for an invalid subscription. Check per-app proxy settings again in the new client.
Android Requirements and Installation Checks
Check
What to look for
Device architecture
Choose arm64 for most devices; consider the universal build if you're unsure of the architecture. Check which app architectures the system supports rather than relying only on the processor's advertised specs.
Windows compatibility
Your Android version must meet the APK's requirements. If the system installer reports incompatibility, check the Android version and package architecture first.
Install permission
Allow the browser or file manager you use to open the APK to install apps. Managed devices may block installations from outside approved sources.
Connection and background use
Connecting requires VPN permission. For ongoing use, adjust battery optimization as needed and make sure another VPN app isn't handling the connection.
v2rayN
7.24.1
Linux desktop · x64 primary downloads / arm64 alternatives
For distributions that use RPM packages and meet this package's dependencies. Sharing a package format doesn't guarantee compatibility with every release of a distribution.
Check the package format first, then the processor architecture.DEB and RPM are different package formats and can't be swapped by changing a file extension. On desktop PCs, x86_64 corresponds to x64 here, and aarch64 to arm64. Check your hardware and OS version in your distribution's system information or About screen.
Open the downloaded file with your system's graphical software installer. Review the dependency, package source, and permission prompts before installing. If dependencies are missing, install them through your distribution's package sources rather than forcing the installation. This download is intended for graphical desktops; it isn't suitable for servers with only a command-line environment.
After starting v2rayN, whether the system proxy works depends on your desktop environment and whether apps honor proxy settings. Terminal programs and background services usually need their own configuration, so a working browser doesn't mean all apps are covered. For TUN, check permissions, routing, and DNS. Avoid running the desktop client with elevated privileges all the time.
Linux Requirements and Installation Checks
Check
What to look for
Package format
Choose DEB or RPM for your distribution. Check your package manager for specific dependencies and distribution compatibility.
Processor architecture
Use the x64 package for x86_64 and the arm64 package for aarch64. Don't install a package for a different architecture.
Desktop and dependencies
You need a working graphical desktop and the runtime dependencies required by the release. A matching package format alone doesn't guarantee the app will start.
Traffic routing
System proxy support depends on your desktop environment and apps. TUN needs appropriate permissions and should be checked alongside existing routing and firewall settings.
After installation
From installer to working configuration
Start with a minimal working configuration, then add routing and DNS settings one at a time. Change one type of setting at a time to make issues easier to diagnose.
Get your subscription and server details ready
Make sure your subscription comes from a trusted source and that you're authorized to use it. Subscription URLs may contain credentials; don't share them in public screenshots or online parsing tools. When adding a server manually, enter the full protocol, address, port, authentication, and transport settings—not just the server hostname.
On desktop, start with the system proxy. On Android, grant VPN permission when prompted. Check permissions and network conflicts before using TUN. The system proxy, client routing, and server selection do different things; importing a subscription doesn't configure them automatically.
Check your browser and the specific apps you need to use to make sure traffic is handled as expected. Once your setup is stable, back up your subscription groups and custom rules. Before updating, note any changes to ports, routing, and DNS; afterward, check each one to distinguish configuration changes from installation problems.
Should I download Desktop or the classic WPF edition for Windows?
For a first install, try Desktop, which uses a newer cross-platform interface. If you prefer the familiar Windows layout, choose the stable classic WPF edition. Both are v2rayN; make sure your device runs x64 Windows before downloading. Back up your settings before switching editions, and don't overwrite the existing folder.
How do I choose between Apple Silicon and Intel for macOS?
Open About This Mac from the Apple menu. Choose Apple Silicon arm64 if the Chip section shows an Apple M-series chip, or Intel x64 if the Processor section shows Intel. Follow the information on your Mac rather than choosing based on its purchase year.
What's the difference between Android arm64 and universal builds?
Most mainstream phones released after 2015 can start with arm64, but check that the system supports 64-bit apps. The universal build supports multiple architectures and is a good option if you're unsure of your device's architecture or the arm64 package won't install. Both builds are for the same client, so you don't need to install both.
Does the client include a ready-to-use subscription?
The client manages configurations and connections but doesn't include a subscription. You'll need a subscription URL or server details from a trusted source that you're authorized to use. After importing them, select a server and configure the system proxy or grant VPN access, depending on your platform.
How can I keep my settings when updating?
Use the client's backup or export feature first, and note your system proxy, local ports, routing mode, and custom rules. Exit the client before updating, then check that your subscription groups and rules are still there. Don't share backups publicly if they contain subscription URLs or credentials.
What if the download filename doesn't match the version shown on the card?
The version shown on a card and releases for specific architectures may follow different schedules. Use the version text as a release-status reference; don't edit the download URL based on it. Before installing, check the app name and version in the system installer. If you see a downgrade or signature conflict warning, cancel first, back up your settings, and then decide how to proceed.
