Basic Setup · About 10 Minutes

v2rayN Setup Guide: From Subscription Import to Connection Verification

Prepare a working subscription URL and complete the initial setup in four steps. This guide covers only the settings needed for everyday startup; protocol, core, and cross-platform details are covered in the multi-platform guide.

Subscription Management System Proxy Routing Mode Connection Verification
SETUP FLOW 4 Steps
  1. 01
    Import Subscription Save the URL and update the server list
  2. 02
    Choose Mode Configure the system proxy and routing rules
  3. 03
    Establish Connection Select a configuration and confirm its running status
  4. 04
    Verify Result Check web access and the client log
Completion Criteria Status matches the access result
Before You Start

Confirm the client, subscription URL, and system time first

Before you begin, have the client installed and obtain the subscription URL from your service provider. A subscription URL is usually a link beginning with https:// that lets the client retrieve server configurations. It is not a regular web address and does not need to be opened in a browser first. When copying it, select from the first character through the last to avoid including spaces, line breaks, or a period automatically added by a messaging app.

If the client is not installed, visit the download page and choose the version for your current system. Use v2rayN on desktop devices and v2rayNG on Android devices. After installing or extracting the client, launch it once and confirm that the main window opens normally. After you close the desktop window, it may remain in the system tray. If you cannot find it later, reopen it from the tray instead of starting multiple processes.

Also check that the device date, time, and time zone are correct. VLESS, Trojan, REALITY, and TLS-based configurations use certificate and handshake time checks. If the system clock is significantly off, the client may appear to be running while the connection fails during the handshake. Enable automatic time synchronization before importing the subscription. You do not need to change the core, port, Mux, or DNS in advance; keeping the defaults makes it easier to identify the failing step.

The Client Is Running

You can see the v2rayN main window or the v2rayNG configuration list.

The Subscription URL Is Complete

The link came from the actual service provider, and the copied value contains no spaces, line breaks, or extra punctuation.

The System Time Is Correct

The date and time zone match your current location, and automatic time synchronization is complete.

01
Step One

Import the Subscription and Build the Server List

v2rayN Desktop Instructions

Open the v2rayN main window. In the top menu, find “Subscription Group” or a similarly named subscription management entry, then open “Subscription Group Settings.” Create a group record, enter an easy-to-recognize name such as “Daily Subscription” in the remarks field, and paste the complete subscription URL into the address field. Leave the other options at their defaults for now, then click Add, Confirm, or Save. Saving here only writes the URL to the client; the server configurations usually have not yet been downloaded.

Return to the main window, open the subscription menu, and choose “Update All Subscriptions,” or update the group you just added individually. Watch the status bar or log area at the bottom during the update. When it succeeds, multiple server configurations should appear in the main list. Common protocol entries may include VMess, VLESS, or Trojan. Aliases, protocols, and transports come from the subscription and do not need to be changed individually during the initial setup.

If the list is still empty after the update, return to Subscription Group Settings and check that the URL was saved to the correct group. Copy the original link again, remove any spaces at both ends, and save it. If the log reports a timeout, confirm that the current network can reach the subscription service. If it reports a format or parsing error, ask the subscription provider whether the URL is still valid. Do not use a web console URL, payment page URL, or a single QR-code result as a subscription URL.

v2rayNG Android Instructions

Open v2rayNG and go to “Subscription Group Settings” or “Subscription Settings” from the top-right menu. Tap the add button, enter a remark, paste the subscription URL, and save it. Return to the main page and choose “Update Subscription” from the menu. After a successful update, configurations will appear in the main list. Some versions show the group name first; open the relevant group to view its configurations.

Android may restrict background networking or prevent an app from reading subscriptions in Data Saver mode. If the same URL updates successfully on desktop but repeatedly times out on Android, temporarily allow v2rayNG to use Wi-Fi and mobile data, disable its Data Saver restriction, and update again. Once a configuration appears in the list, continue to the next step instead of refreshing repeatedly.

Step complete when A selectable server configuration appears in the main list
SUBSCRIPTION READY
02
Step Two

Choose the System Proxy and Routing Mode

After importing the server configurations, do not immediately edit every protocol parameter. First decide which app traffic the client should handle. On desktop, distinguish between “System Proxy” and “Routing Mode”: the system proxy tells browsers and other apps to send requests to v2rayN, while the routing mode determines whether incoming requests use a direct connection or the proxy rules. These settings serve different purposes, so enabling only one may not produce the expected result.

Start with Automatic System Proxy on Desktop

In the v2rayN main window’s bottom status bar or system tray menu, find “System Proxy.” For the first setup, choose “Set System Proxy.” The status bar usually shows the current system proxy state, and the tray icon may look different depending on the version. This mode points the system proxy settings to v2rayN’s local listening port and works well for browsers and desktop apps that follow the system proxy.

If you want only apps with manually entered proxy addresses to use the client, you can leave “Clear System Proxy” selected and enter the local HTTP or SOCKS port shown by v2rayN in the target app. However, this is an app-specific setup and is not recommended for initial verification. To reduce variables, this guide continues with “Set System Proxy.” When you finish, choose “Clear System Proxy” from the same location to restore the system’s normal connection settings.

Start Routing with Standard Split Tunneling

Open “Routing Settings” or the routing mode menu at the bottom and choose “Bypass LAN and mainland China” or an equivalent preset in your version. This mode keeps LAN addresses and common direct destinations on the original connection while sending other matching traffic through the current server. It is a practical starting point for everyday use and makes it easier to see which path a website uses. With “Global,” more traffic is handed to the client, but local sites and LAN devices may also be affected.

Here, “Global” refers to the routing scope; it does not mean every program must pass through the client. Some apps ignore the system proxy or use their own network stack, so they may connect directly even when v2rayN is using global routing. Covering more network types involves TUN, DNS, and administrator permissions; these topics are explained separately in the Multi-Platform Guide. For now, use the system proxy for a repeatable test.

Confirm the Connection Scope on Android

v2rayNG usually lets the system create a local network interface after you tap Connect, so it does not have exactly the same “System Proxy” switch as the desktop app. For the first setup, leave “Per-app proxy” disabled so the system handles the connection globally. If it was enabled previously, check Settings and make sure the target browser is included in the allowed list. If the list mode is reversed, the client may show Connected while the selected app bypasses the current configuration.

Routing settings can also start with a preset; there is no need to write custom domain or IP rules before the first connection. Confirm the basic connection first, then add rules as needed. This keeps subscription, server, and routing issues separate. Once this step is complete, the proxy scope is clear; the next step is to select one configuration and connect.

Starting Settings

System Proxy: Automatic Configuration

For browsers and desktop apps that use the system proxy, making initial verification easier.

System Proxy
Standard Split Tunneling

Routing: Bypass LAN and Mainland China

Start with the built-in rules and adjust custom routing only after the basic connection works.

Routing Mode Preset Rules
03
Step Three

Select a Configuration and Connect

Return to the server list. It may contain several similarly named configurations. For the first connection, choose any configuration that was successfully delivered by the subscription; there is no need to guess speed from its name. Speed-test results, actual connection latency, and download throughput measure different stages, so no single number tells the whole story. To keep troubleshooting clear, use one fixed configuration first, then compare another only if the first fails.

Set It as the Active Server in v2rayN

Click a configuration row to highlight it, press Enter, or choose “Set as Active Server” from the context menu. The row will usually show an active marker, and the current server name will appear at the bottom of the window. Confirm that the system proxy is still set to “Set System Proxy” and that the routing mode remains the preset selected in the previous step. v2rayN generally starts the required core automatically; there is no need to open a separate command window.

Watch the log area for a few seconds. If it shows the core starting, the configuration loading, and the local port beginning to listen, the client is ready for application requests. No web activity has occurred yet, so a quiet log is normal. If it immediately reports that the port is in use, fully exit any duplicate client process and restart. If the configuration cannot be parsed, update the subscription or try another configuration in the same group.

After minimizing the desktop window, v2rayN usually remains in the tray. Do not keep an old process running while repeatedly double-clicking to launch new windows; multiple processes may compete for the same local port. When you need to reload, use “Restart Service” from the menu, or exit from the tray before launching it once again. Once the active server, system proxy, and routing mode are all clear, open a browser to verify the connection.

Tap Connect in v2rayNG

In the v2rayNG main list, tap the configuration you want to use so it becomes the current item, then tap the circular connect button at the bottom. When connecting for the first time, Android displays a network connection authorization prompt; confirm it so the client can create a local interface. Authorization is handled by the system. If you cancel it, v2rayNG returns to a disconnected state, so tap Connect again and confirm.

After a successful connection, the button state changes, and the top of the page or system status area shows that the client is running. Keep v2rayNG in the foreground for a few seconds and check for an immediate error. If it switches to Connected and then disconnects, open the log and look for the first clear error instead of repeatedly tapping Connect. Common causes include an expired configuration, an unreachable server, an incorrect system clock, or a network change.

Switching from Wi-Fi to mobile data, or back again, may briefly interrupt the existing connection. Wait for the network to stabilize, then disconnect and reconnect once. If the system uses aggressive background power management, allow v2rayNG to run in the background so it is not stopped immediately after the screen locks. See the Android Configuration chapter for more background policies and platform differences.

Check the Connection Status

The active configuration, running core, and proxy scope all match

“Connected” only means that the client service has started. Confirm actual usability with the next step’s access test and log results.

Client Running READY FOR REQUEST
04
Step Four

Verify the Result with Real Traffic and Logs

Do not rely only on the client button’s color. A running status means the local service has started; expected browser access confirms that app traffic, the system proxy, routing rules, and the current configuration form a complete path. The simplest test is to open a new browser window and visit a page you genuinely need, while keeping the client log visible.

If the target page opens normally, visit a commonly used direct-access page to confirm that both types of traffic behave as expected under the preset route. Refresh several times and watch for stability. The desktop log should show new connection entries; on Android, the log page should show request handling related to the current configuration. You do not need to understand every line—focus on whether clear errors keep appearing and whether the log changes when requests are made.

Separate Browser Cache from a Real Connection

A page that was already open may load from cache and fail to reflect the current connection. Use a new private window or test a specific page you have not opened before. You can also disconnect the client, refresh once, then reconnect and refresh again for comparison. A clear difference between the two results usually indicates that the system proxy and routing participated in handling the request.

If only one browser fails while other apps that follow the system proxy work normally, first check whether that browser has an independent proxy, proxy extension, or secure DNS setting. An independent setting can override the system proxy and prevent the browser from using v2rayN’s current port. Restore “Use system proxy,” restart the browser, and test again. If every app fails, return to the client status, server configuration, and local network layers.

A Practical Daily Startup Order

You do not need to add the subscription again each time. The usual order is: start the client, update the subscription if needed, select a configuration, confirm the system proxy or Android connection status, and then open the target app. An update may replace or add servers, but it cannot determine which configuration suits the current network. If one configuration fails, compare it with another from the same subscription.

Before finishing on desktop, choose “Clear System Proxy” from the tray menu, then exit v2rayN. This prevents the system from retaining a proxy pointing to a local port after the client has stopped. On Android, tap the connect button to disconnect. If the desktop client exits unexpectedly and ordinary web pages suddenly stop opening, restart v2rayN and clear the system proxy, or disable the leftover proxy in the system network settings.

Status Matches

The current configuration is selected, the client remains running, and the system proxy or Android connection is enabled.

Access Meets Expectations

The target page opens, and commonly used direct-access pages also work under the current routing rules.

No Persistent Errors in the Log

A corresponding entry appears when a request is made, without recurring handshake, parsing, or port errors.

Quick Troubleshooting

Narrow Down the Cause in Order When the First Connection Fails

Change one thing at a time and retest after each change. This helps distinguish subscription, configuration, system proxy, and local network issues.

No Configurations Appear After Updating the Subscription

Check that the subscription was saved to the current group, then copy the original URL again and remove leading and trailing spaces. Watch the log during the update: a timeout usually points to the subscription service or current network, while a parsing error usually points to the URL content. Confirm that you are using a subscription URL rather than a service management page.

The Client Runs, but the Browser Still Uses the Original Network

On desktop, confirm that the system proxy is set to “Set System Proxy” and check whether the browser has an independent proxy setting. On Android, check that v2rayNG is Connected. If per-app proxying is enabled, make sure the target browser is in the correct list. After changing settings, fully close and reopen the browser.

The Connection Drops Immediately or Keeps Reporting Errors

First confirm the system date, time, and time zone. Then update the subscription and try another configuration in the same group. If every configuration shows the same error, the issue is more likely related to the subscription, current network, or client environment. If only one fails, disable it temporarily and ask the provider to confirm its status.

Ordinary Web Pages Stop Opening After Exiting v2rayN

This usually means the system still has the old proxy address while the local client has stopped. Restart v2rayN, choose “Clear System Proxy” from the tray or status bar, and then exit normally. In the future, clear the system proxy before finishing to prevent an unusable setting after the local listening port stops.

Go Deeper

Platform Permissions, TUN, DNS, and Custom Routing

After the basic connection works, handle platform-specific settings. The Multi-Platform Guide covers Windows, macOS, Android, and Linux in separate chapters, including installation, subscriptions, system proxies, and common issues.

Open the Multi-Platform Guide