V2Ray Setup Guide: Install, Configure, Connect

Whether you use Windows, macOS, Linux, or Android, follow the illustrated steps below to finish setup and connect successfully in three minutes.

Quick Start

The same three steps for every client

v2rayN, v2rayNG, and v2flyNG all follow the same workflow. Start with the overall process.

  1. 1

    Download and install a client

    Go to the Download Center and select the package for your platform: download v2rayN for desktop or v2rayNG / v2flyNG for Android (prefer arm64-v8a). The Windows portable build runs after extraction. On Android 8+, if installation is blocked, open the prompt and allow installs from your browser or file manager (Install unknown apps).

  2. 2

    Import node configurations

    Choose one of three methods: ① copy the subscription URL from your provider, add and update it in the client to import nodes in bulk; ② scan a QR code on your phone; or ③ copy a share link beginning with vmess://, vless://, or trojan://, which the client will recognize and import from the clipboard.

  3. 3

    Test speed, connect, and verify

    Run a real-connection speed test on all nodes, choose the one with the lowest latency, and connect. On desktop, enable “System Proxy” from the tray icon; on Android, tap the round Connect button at the bottom. Finally, open a site that shows your public IP (or any destination you intended to reach via the proxy) to verify the connection.

Desktop

v2rayN Guide (Windows / macOS / Linux)

Using the most common subscription method as an example.

Step 1: Install and launch

  • Windows: download v2rayN-windows-64.zip, extract it to any folder, then double-click v2rayN.exe to launch it (you may need to allow it through the firewall on first launch).
  • macOS: download the DMG for your chip. If it says “the app is damaged,” run xattr -cr /Applications/v2rayN.app in Terminal.
  • Linux: on Debian / Ubuntu, run sudo apt install -y ./v2rayN-linux-64.deb; on other distributions, extract the ZIP and run ./v2rayN.

Step 2: Add a subscription

  1. Open the “Subscription Groups” menu → “Subscription Group Settings,” then click “Add.”
  2. Enter any remark, paste the subscription URL from your provider into “Subscription URL (url),” then confirm to save.
  3. Return to the main window and press Ctrl + S (or choose “Subscription Groups” → “Update All Subscriptions”). The node list will appear automatically.

Step 3: Test speed and enable

  1. Select all nodes, right-click, and choose “Real Connection Latency Test.” Wait for the results.
  2. Double-click the lowest-latency node to make it active.
  3. Click the tray icon in the lower-right corner and set “System Proxy” to “Automatically Configure System Proxy.” Use “TUN Mode” when you need to capture all traffic.

If your browser reaches the destination you expect through the proxy (for example, an IP-check page shows the node location), setup is complete. If it cannot connect, see the troubleshooting steps in the FAQ.

Android

v2rayNG / v2flyNG Guide (Android)

Both clients have the same interface, so the steps apply to either one.

Step 1: Install the APK

  • Download the arm64-v8a APK from the Download Center; it works with most phones.
  • If Android says installation from unknown sources is blocked, allow installation by the current browser or file manager on the settings page that opens.

Step 2: Import nodes

  1. Tap the “＋” button in the top-right corner and choose “Scan QR Code,” “Import from Clipboard,” or “Manual Input.”
  2. For subscriptions: open the left drawer menu → “Subscription Settings” → “＋”, paste and save the subscription URL; return to the main screen, tap “⋮” in the top right, then choose “Update Subscription.”

Step 3: Test speed and connect

  1. Tap “⋮” in the top right → “Real Connection Test All Configs,” then choose the lowest-latency node.
  2. Tap the round button at the bottom to start the VPN. You must approve the system VPN permission prompt on the first connection.
  3. Real-time speed appears at the bottom. To proxy only certain apps, select them in “Settings” → “Per-app Proxy.”

Tip: v2rayNG and v2flyNG can be installed together, but only one app can use the system VPN tunnel at a time.

Go to Downloads Connection failed? See the troubleshooting guide