Client downloads

V2Ray client downloads

Download v2rayN for desktop; on Android, choose v2rayNG or v2flyNG to match your configuration. Check your operating system first, then choose the interface edition or processor architecture.

Installers

Choose an operating system

Switch platforms, then choose a package from the client card. Check the system requirements in the same panel before installing.

Windows client and system requirements

v2rayN

v2rayN

Recommended7.24.1

Desktop is the newer cross-platform interface and the recommended choice for a first install. WPF keeps the classic interface for those who prefer its familiar menus and system tray controls. Both are Windows desktop clients; there’s no need to install both.

Both downloads are ZIP files containing an installer. Extract the archive before running it. When upgrading, stick with the interface edition you already use. To switch editions, first save your subscriptions, routing rules, and custom settings, and note where the current client stores its data.

Windows system requirements

CheckRequirement
Operating systemWindows 10 or 11. Use a version that still receives system updates.
ArchitectureCheck Settings → System → About and choose the x64-based system package.
Runtime componentsInstall any missing dependencies indicated by the installer or startup message.

If your system type says ARM, don’t assume the x64 package will work just because the system is 64-bit. If the app won’t start, first determine whether a runtime component is missing or the client has opened but cannot connect—these require different troubleshooting steps.

Checklist

Install, upgrade, and launch for the first time

Treat the wrong package, installation errors, and connection failures as separate issues. Change one thing at a time and check the result.

Check your device before downloading

Check the operating system and processor on the device where you’ll install the client. If you download from another computer, use the target device’s details. File types don’t always map directly to operating systems: Windows ZIP files need to be extracted, macOS DMG files need to be opened, and Linux packages must match your distribution’s package manager. If there are two download options, rule out incompatible packages using these details first.

The client stores installation files and connection settings separately. Before installing for the first time, make sure you have a subscription URL or individual connection configuration ready to import. If the setup instructions specify a core or protocol, use that to choose a client. You can launch the app to check its interface before you have a configuration, but an empty connection list doesn’t mean the installation failed.

Record your existing settings before upgrading

Note the current client version, interface edition, and installation source, then export any subscriptions and settings you can. Custom routes, DNS, and local ports may not be included in a subscription. If the app has no single export option, record each changed setting and its original value. Keep backups outside the client’s installation folder so they won’t be lost if you uninstall the app or replace that folder.

If the desktop client is using the system proxy, clear any proxy settings it applied before quitting the old app, then make sure no process remains in the system tray. On mobile, disconnect any active connection first. After upgrading, check that your groups and selections are still there. Don’t recreate multiple subscriptions with the same name just because the list looks empty—first check whether you launched a different copy of the app or opened a different data directory.

Verify the launch first, then the connection

After installation, make sure the client’s main window opens and the About page shows the expected version. Don’t adjust DNS, routing, or virtual network adapters yet. Import a known-good configuration, select a connection, then enable the system proxy or grant connection permission as required by your platform. Retry the service you intended to access in the same app and check whether the client logs the request.

If the client logs nothing, first check whether the request is going through it—for example, whether the app you’re testing uses the system proxy. If the request is logged but the connection fails, check the selected connection and the specific error in the logs. When you’re done testing, turn off the connection or clear the system proxy in the client before quitting. This prevents the system from sending requests to a local listening port that is no longer running.

See how to import a configuration, choose a mode, and test a connection
Download FAQs

Common installation questions

The Windows download is a ZIP. Can I run the installer from inside the archive?

Extract the entire ZIP to a local folder, then run the installer from the extracted directory. Don’t drag the EXE out by itself—the installer may need files in the same folder. After installation, launch the client from the Start menu or its installation directory.

How do I check which processor my Mac has?

Open About This Mac from the Apple menu. If it says Apple chip, choose Apple Silicon; if it says Intel processor, choose Intel. Even if an existing app runs through translation, choose the new package based on your Mac’s chip.

Will switching to the universal Android version fix an installation conflict?

The universal version addresses ABI selection; it won’t fix a signature mismatch, a downgrade, or an incompatible Android version. If an update fails, keep the existing app and check the error first. If you must uninstall before reinstalling, export and safely store your current configuration beforehand.

My Linux system is 64-bit. Should I choose x64 or arm64?

Run uname -m. Choose x64 if the output is x86_64, or arm64 if it’s aarch64. Then select DEB or RPM based on your distribution’s package manager. A matching architecture doesn’t guarantee compatible package dependencies.

Why can’t I connect right after installing?

The installer provides the client, not connection settings. Import a valid subscription or individual configuration, then select a connection. On desktop, check the system proxy mode; on Android, grant the system connection permission. Then test whether traffic is actually connecting.