Quick Start / 4 Steps

V2Ray Setup Guide: Import a Subscription and Test Your Connection

First, get a server to appear in the list. Then choose how apps should use the proxy. Finally, make a real request to verify the connection instead of relying on the status icon.

Before you start, get a subscription URL from a trusted source and make sure your device is online. Haven’t installed a client yet? Choose the right version on the downloads page. This guide uses an existing subscription, so there’s no need to write JSON by hand. If you only have a server share link, check the glossary to distinguish it from a subscription URL, then choose the right import option.

Step 1: Import and Update a Subscription

Importing involves two steps: save the subscription URL, then fetch the server list from it. Saving only confirms that the client has stored the group. This step is complete only when server entries appear under it. Keep any query parameters at the end of the URL when copying; remove only accidental spaces at either end. A subscription URL with access credentials may let others view its contents, so don’t post the full URL in a public forum.

v2rayN: Add a Subscription Group

Open the main window, go to Subscription Group > Subscription Group Settings, and add a group. Enter a recognizable name in the remarks field, paste the full subscription URL, and save. Back in the main window, select the new group, then choose Update current subscription from the Subscription Group menu. If the menu offers updates through or without a proxy, and the URL is reachable directly from your current network, choose the direct option for initial setup. This avoids relying on a connection that isn’t up yet.

v2rayNG: Update a Subscription from the Side Menu

Tap the top-left menu, open Subscription group settings, and tap the plus button to add a group. Enter a note and the subscription URL, then save. Return to the server list, select the group, open the top-right menu, and choose Update subscription. Don’t paste the URL into the plus menu’s single-server import option. If the list looks unchanged after updating, make sure you’re viewing the group you just updated, not another one.

When the update finishes, at least one configuration should appear. If the list is still empty, check the update message first. For a timeout, check your network and whether the subscription URL is reachable. For a parsing error, make sure you copied a subscription URL, not a login page URL or a single-server share link. If access is denied, check with the service that provided the URL to see whether it has changed or expired. There’s no need to change proxy modes while the list is empty.

Step 2: Choose a Proxy Mode

The server group determines which configurations you can choose from; the proxy mode determines which apps send requests through the client. These settings serve different purposes. For your first test, choose an app that’s easy to verify, such as a browser that follows the system proxy. Don’t also enable TUN, switch cores, or change DNS yet, or it’ll be harder to identify the cause of any problems.

v2rayN: Use the System Proxy

Open the v2rayN menu from the desktop system tray, find System Proxy, and select Set system proxy automatically. This sets a local proxy for the system; only apps that follow this setting will send requests through the client. If you’ve configured a separate proxy in your browser, check its settings to see whether it follows the system. Do not change system proxy preserves the current settings; it doesn’t enable the system proxy. Clear system proxy removes the system proxy settings; it isn’t a connection mode.

v2rayNG: Check Which Apps Use the VPN

v2rayNG uses Android’s VPN interface to route traffic. You don’t need to enter a proxy address in your Wi-Fi settings. If you’ve enabled per-app proxying, check whether the app you want to test is excluded. What the list means depends on the current rule: some modes proxy only selected apps, while others exclude selected apps. Don’t rely on checkmarks alone. If another app is already using the VPN and you want to switch to v2rayNG, end the existing VPN session first.

Once you’ve set the mode, don’t use a website failing to load as a test of whether the subscription works. The desktop system proxy may be configured before an active server is running, and Android’s app selection takes effect only after the VPN starts. Return to the client’s list and select a configuration.

Step 3: Select a Server and Connect

For your first connection, test one configuration at a time. If several have similar names, note which one you selected so you can match it to the logs later. An update finishing, entries appearing in the list, and a connection running are three separate states. Highlighting a row doesn’t necessarily make that server active.

v2rayN: Set an Active Server

Right-click the server you want to use and choose Set as active server. Depending on the version, this option may be in the Server menu instead. Make sure the active indicator is next to your selection, then check the logs at the bottom of the window. The client may restart its core when you switch configurations, so wait for startup to finish before testing. If you configured the system proxy, check the current mode in the tray menu after switching. A running core doesn’t necessarily mean the system proxy is working.

v2rayNG: Start a VPN Session

Select a configuration in the main list and tap the connect button at the bottom right. The first time you connect, Android will ask to set up a VPN connection. Check that the prompt names the client you just started before approving it. Return to the main screen, wait for the button to show that the VPN is running, and check that Android reports an active VPN. If you denied the permission request, tap connect again to request access; there’s no need to reimport the subscription.

If the desktop client reports that a local port is already in use, quit any older client that may be using the same port and try again. If Android can’t establish a session, check system permissions and the current VPN status. For a configuration parsing error, start with the first specific error in the logs. Don’t change the server, routing, and core all at once. For details on listening ports or outbound fields, see the configuration reference. Once the status is stable, test the actual route with an app request.

Step 4: Check Whether Your App Is Using the Proxy

A connected status only confirms that the client is running; it doesn’t prove that an app’s requests are going through the proxy. Note the current time, then make a new network request in the app you want to test. For example, open a page in your browser that normally loads and that you haven’t opened during this session. Don’t rely on an already-open tab: cached content can still appear without a new request.

Check the client’s runtime logs for that time period. If the current log records requests and routing results, find an entry matching the test time and the target domain or address, then check which outbound it used. A request can reach the client and still be routed directly, so seeing it in the logs doesn’t mean it went through a remote server. Direct routing is expected for destinations that should bypass the proxy. For destinations that should use the proxy, confirm that they matched the intended proxy outbound. If outbound and routing labels are unfamiliar, see the glossary.

If there’s no matching log entry, first check whether the current log level records requests, then confirm that the app is included in the proxy scope. On desktop, check whether the browser follows the system proxy. On Android, check whether per-app rules exclude it. If the logs show a proxy outbound but the request still times out, test another configuration with the same app and destination, changing only the server—not the proxy mode. If only one app has a problem, compare its settings before deleting the entire subscription.

The client’s built-in latency test can help compare servers, but it’s not the same as a complete request from your app. A successful test doesn’t mean every app uses the same route. If you were only testing, tap Stop in v2rayNG when you’re done. On desktop, if automatic system proxy configuration is enabled, make sure the system proxy is restored to its usual settings before quitting. Otherwise, apps may keep sending requests to a local port that’s no longer running.

Download a Client