Open-source clients · Package index

V2Ray client downloads

For desktop, choose v2rayN. For Android, start with v2rayNG, or choose v2flyNG if it better fits your configuration. Select your operating system below, then check the device architecture and package format.

Choose a package by operating system

Each option includes its system requirements and installation steps.

Windows packages

Windows system requirements

CheckRequirement and where to find it
System typeGo to Settings → System → About and confirm that you have a 64-bit system with an x64 processor.
Installation folderExtract the ZIP archive fully, keeping the installer and bundled files in their original folder structure.
Runtime requirementsIf startup reports a missing runtime, check the component name, version, and architecture shown in the message.

Launching after extraction and switching versions

In File Explorer, select Extract all, then run the installer from the extracted folder. Don't double-click it in the archive preview. Keep the extracted folder somewhere easy to find, rather than running it repeatedly from a temporary folder or synced drive. After installation, launch the app from its new shortcut and check that both the main window and notification area icon open correctly.

When switching from WPF to Desktop, don't copy the old installation folder over the new one. Back up your subscriptions, custom routing rules, and local port settings in the old version, then fully exit it, including the tray instance. If your lists or rules don't appear after switching, check where the new version stores its settings and import what you need. If your browser still uses the old proxy port, check which port is actually listening instead of repeatedly updating your subscription.

After downloading: import a subscription and connect

First make sure the client opens, then check your configuration and traffic separately. There's no need to troubleshoot everything at once.

  1. Choose the import option that matches your link. A subscription URL usually updates a group of nodes; after adding it, run a subscription update. A single share link adds just one node. Once entries appear, check that the group, label, and protocol are as expected. Don't post subscription URLs containing access credentials in public forums.
  2. Test one node, then choose how to route traffic. Verify the connection with an app that has a clear use case. On desktop, if you start with the system proxy, make sure the test app actually uses system settings. If you need more apps to use the same route, learn about TUN permissions and when to use TUN mode. On Android, grant the VPN permission when prompted, then check the per-app settings.
  3. Disconnect, then test the network again. Disconnect normally or clear the system proxy, then retest with the same app. If access works with the proxy on but fails locally after it's turned off, check whether the app or system retained the proxy address. If only certain destinations fail, review the routing rule order and change one setting at a time.

Package download FAQs

Do I need to install both Desktop and WPF on Windows?

You only need one. If you're new to v2rayN, start with Desktop. Choose WPF if you're familiar with its classic Windows interface or following an existing WPF guide. Back up your settings before switching versions, and run only one instance during initial testing to avoid conflicts over the same local port.

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

Open About This Mac from the Apple menu. If it lists an Apple M-series chip, choose Apple Silicon (arm64); if it lists an Intel processor, choose Intel (x64). The Mac's name and screen size don't indicate its architecture, and models in the same lineup may use different chips.

What's the difference between the Android arm64 and universal packages?

The arm64 package is for devices that support arm64-v8a and is usually smaller. The universal package supports multiple architectures included in that release. If you're unsure which architecture your device uses, start with the universal package. It won't lower the minimum Android version or resolve app-signature conflicts.

Can I install a new version over an older one?

Back up your settings first, then check that the app, installation source, and package format match. On desktop, quit the old process before upgrading as directed by the installer. Android updates require a compatible app ID and signing key. If you see a signature conflict, keep the old version and export your settings before considering an uninstall.

After installation, do I need to download a subscription or install a core separately?

The client installer and a subscription are separate. Launch the GUI client, then add your subscription URL or a single share link. Follow the client's prompts to confirm any required components. If the client opens but the list is empty, check that you used the right import option and that the subscription updated successfully; there's no need to download the installer again.