Client downloads / choose an operating system and architecture

V2Ray Download
v2rayN · v2rayNG

Choose your operating system, then the right installer. Use v2rayN on desktop, v2rayNG on Android, or v2flyNG as an alternative.

Free and open source Graphical interface Subscription import

Already have a configuration? Back it up before updating. New to the client? After downloading, continue with the quick start guide →

Download the Windows client

Both options are x64 ZIP packages. For a new install, start with the Desktop edition. If you’re used to WPF, you can stick with the classic edition.

v2rayN

v2rayN

Recommended7.24.1

Desktop edition

A newer cross-platform UI. A good fit for first-time users and anyone who wants a consistent experience across desktop systems.

Download Desktop · x64 ZIP archive · extract before use

Classic WPF edition

A classic, stable edition with the familiar Windows desktop layout. Ideal if you want to keep your existing workflow and configuration process.

Download WPF · x64 ZIP archive · use a separate folder

The editions may differ in layout, runtime requirements, and access to some features. If you already have a configuration, back it up and follow the import instructions for your chosen edition. Keep the program files in separate folders; don’t overwrite the existing installation just to switch interfaces.

Windows setup checklist

CheckWhat to do
Operating system and architectureFor Windows x64. Find your system type under “Settings → System → About.” Check the current package notes for supported Windows versions.
Runtime requirementsSome versions may require a specific .NET Desktop Runtime. If startup reports a missing component, check the required architecture and runtime type.
Folder and permissionsExtract the ZIP archive completely to a writable folder before launching the program. Don’t run it from inside an archive or place it in a restricted system folder.
First-time setupHave a valid subscription or configuration ready and make sure the local port is available. Get the standard system proxy working before considering TUN.

When you first launch the app, check that the main window opens normally before changing routing, ports, or the core. If it can’t save its configuration, check folder permissions and security software logs. Grant elevated permissions only when a specific feature requires them; not every startup issue is caused by insufficient permissions.

Quit the old client before launching the new one to reduce port conflicts and repeated changes to the system proxy. For the complete setup sequence, see the Windows installation and setup guide. Follow the steps in order: extract, launch, import, then enable the system proxy.

What to do after downloading

Installing the client is only the first step. Import a configuration, test the connection, then adjust routing and advanced modes.

Back up before installing or updating

If you already have a client, disconnect first and note the system proxy state and local listening port. Use the client’s backup or export feature to save any configuration you need. Subscription links may contain access credentials, so store them securely and redact them before sharing error screenshots. When switching clients, reimport the original subscription where possible instead of copying database or cache files you don’t understand.

Updating the same client and switching to another client are different operations. Updates usually retain the existing configuration; a different client may support different fields, routing, and core features. After updating, confirm your groups, rules, and configurations still load before testing the connection. Keep your old backup until you’ve verified everything works.

Import a subscription and select a configuration

The client installer doesn’t include a subscription service. Get a subscription link you’re authorized to use, open the subscription group settings, create a group, and paste the full link. Save it and update the group. If the list is empty, check the update log and confirm the response is readable by your client rather than repeatedly importing the same link.

After a successful update, select a configuration and start the connection. Node tests can help check reachability, but they don’t replace testing in the apps you use. If a configuration won’t connect, compare it with one you know works. Avoid changing DNS, routing, ports, and transport settings all at once, or it’ll be hard to tell what fixed or caused the problem.

Test the standard proxy before changing advanced settings

On desktop, make sure the system proxy is enabled and uses the client’s local listening port. On Android, confirm VPN permission is granted. Test a browser on a page that normally loads reliably, then test the target app. If something goes wrong, check the client logs to distinguish a local network issue from a subscription or connection setting problem.

Enable TUN, per-app proxy, and custom routing one at a time, only after the basic connection works. Change one setting per test and keep a configuration you can restore. If the network stops working after you close the client, check whether the system proxy still points to the stopped app before investigating further.

Common client download questions

Organized by installer choice, configuration migration, and first connection.

Which v2rayN edition should you choose: Desktop or classic WPF?

For a first install, start with the Desktop edition, which uses a newer cross-platform interface. Choose WPF if you prefer the classic Windows layout. The editions may differ in settings and runtime requirements. Back up your configuration before switching, keep each edition in its own folder, and never overwrite one edition with the other.

Should you download the arm64 or universal Android version?

Most phones released since 2015 should use arm64, but check which app architectures your device supports. If you’re unsure or the arm64 package won’t install, try the universal version. It supports more architectures and is usually larger; it doesn’t include more features.

Does downloading the client automatically provide subscriptions or nodes?

The client reads configuration and connects to servers; the installer does not include a subscription service. You’ll need a subscription link or server configuration that you’re authorized to use. Import and update it in a subscription group, then select a configuration. Don’t share subscription links that contain access credentials.

Should you delete your old configuration before installing a new version?

Usually, no. Before updating, disconnect, quit the client, and back up your configuration. Keep the same app, architecture, and installation method. If switching desktop editions or cores, read the relevant instructions and confirm the configuration loads before removing old files.

What should you do if the installer won’t open or reports an architecture mismatch?

Check your operating system, CPU architecture, and file format, and make sure the download is complete. Fully extract ZIP files on Windows; choose the right package for Apple Silicon or Intel on macOS; and match the package format to your Linux distribution. Review the reason for any security warning instead of disabling system-wide protection.

What should you check first if you still can’t connect after installation?

Turn off the proxy and confirm your regular internet connection works. Then check that the subscription updated, a configuration is selected, and the client is running. On desktop, check the system proxy and local listening port; on Android, check VPN permission. If the issue persists, follow the troubleshooting steps one at a time instead of changing several settings at once.

Browse all FAQs →

Download v2rayN