Choose a package by platformOpen-source client

V2Ray Client Downloads

Use v2rayN on desktop. For Android, v2rayNG is the recommended choice; choose v2flyNG if you need its core. Select your device’s OS first, then confirm its chip architecture or package format.

Packages by platform

v2rayN

v2rayN

Recommended

7.24.1Windows · x64 · ZIP

Desktop is the modern edition with a cross-platform interface and is recommended for new installs. WPF is the classic, stable edition for users already familiar with the Windows layout and system tray menu. Choose one, not both.

Windows system requirements

CheckRequirement
System typeGo to Settings → System → About and confirm that your system is 64-bit and the processor is x64.
Installation mediaExtract the ZIP to a writable folder before opening the installer.
Runtime environmentIf your OS version or runtime libraries don’t meet the requirements, follow the installer’s instructions.

Installation and edition switching

In System Information, check for both “64-bit operating system” and “x64-based processor.” Seeing “64-bit” alone isn’t enough: 64-bit systems can run on different processor architectures. Once confirmed, use File Explorer’s Extract All option to unpack the ZIP. Don’t run the installer from the archive preview; it may need other bundled files that aren’t available until the whole archive is extracted.

When switching from classic WPF to Desktop, back up your nodes and subscription groups, then exit the old version from the system tray—not just by closing its main window. On the new version’s first launch, check your node list, routing choices, and local listening port. If the client is open but webpages won’t load, check whether the old version left a system proxy setting behind and whether a program is still listening on its configured port. Don’t start by reinstalling or repeatedly switching nodes.

Installation and migration

Before and after installation

Test installation, configuration import, and traffic routing separately. When something goes wrong, first identify which step didn’t complete.

Wait for the download to finish before opening the package

Your browser may still be writing the downloaded file. Check the browser’s download history to make sure the download is complete, then open the destination folder. If file extensions are hidden, use Properties or Get Info to tell ZIP, DMG, APK, deb, and rpm files apart. If you see a file corruption or cannot-open error, note the exact message and download status. Changing a file extension won’t convert it to another package format.

Back up your data before replacing the old app

If you already use the client, back up your nodes, subscription groups, and custom routing rules, and note the local port and traffic-handling mode in use. Manually added nodes may not be included in subscriptions, and custom routes won’t automatically return when a subscription updates. Backups may contain subscription URLs and node credentials. Store them somewhere you control, not in a public cloud drive, chat screenshot, or support request. After installing the new version, make sure it can still read your settings before deleting old files.

Check nodes before testing webpages

An empty list after a fresh install is normal. In v2rayN, for example, add an address under Subscription Group, then choose Update All Subscriptions and confirm that nodes appear in the list. Select a node, check the client logs for connection or handshake errors, then choose system proxy or TUN. Don’t run multiple clients or change several settings at once while troubleshooting. Change one thing, then retry the same webpage to narrow down the cause.

For step-by-step instructions, see Quick Start. For differences in system permissions, package dependencies, or proxy routing, see Installation Guide.

Download FAQs

Choosing a package, upgrading, and connecting for the first time.

Do I need to download both Windows installers?

No. For a fresh install, choose the desktop edition with its modern cross-platform interface. If you prefer the classic Windows layout or need to follow instructions for that edition, choose the classic WPF version. Run only one client while troubleshooting to prevent two instances from changing your system proxy at the same time.

Which macOS installer should I choose: Apple Silicon or Intel?

Open About This Mac from the Apple menu. Choose Apple Silicon if Chip lists an Apple M-series chip, or Intel if Processor lists an Intel processor. Choose based on the Mac’s actual chip, not its purchase date or storage capacity.

Can the Android universal version fix every installation failure?

No. The universal version is useful when you’re unsure which app architecture your device supports. It won’t fix failures caused by an outdated OS, installation-source permissions, or a signature conflict with an existing app. Check the system message first, then decide whether to try a different package.

For Linux packages, should I choose the format or architecture first?

First choose deb or rpm based on your distribution’s package system, then select x64 or arm64 to match your system architecture. Even when both match, check the installer’s compatibility and dependency requirements for your distribution.

Which settings should I keep before upgrading?

Back up your existing nodes, subscription groups, and custom routing rules. Separately note your local listening port and current traffic-handling mode. Exit the old client before upgrading. After launching the new version, verify your nodes and routes before enabling the system proxy or TUN. Keep your backups and subscription URLs somewhere secure.

Why are no servers available after installation?

The installer provides only the client. You need to configure server nodes separately: import your own node configuration, or add and update a subscription you’re authorized to use. Once nodes appear, select one, configure how traffic is routed through the proxy, and test the connection.

Download V2Ray Client