Getting Started · First-Time Setup

v2rayN and v2rayNG Setup Guide

If the client is installed and you have a working subscription, set aside about 10 minutes for a connection test. First get servers to appear in the list, then decide which apps to route through the client, and finally check where a test request went.

Step 1: Add a Subscription

A subscription URL lets the client retrieve a server list. Saving the URL only tells the client where to fetch the list; setup is complete once you update it and see servers appear. Before you start, copy the subscription URL provided for your client from your service provider's account page. An account login page, order page, or individual server share link is not a subscription URL. If you haven't installed a client yet, choose an installer on the download page, then come back here.

v2rayN for Desktop

Open the main window and go to “Subscription Group → Subscription Group Settings.” Choose Add, enter a recognizable group name, paste the full URL into the “Optional Address” field, and save. The name is just a label; it does not replace the URL. Return to the main window, select the group you created, then choose “Update Current Subscription (without proxy)” from the “Subscription Group” menu. Since there is no working connection yet, this option makes it easier to tell whether the subscription can be fetched directly. When the update finishes, check whether server entries appear in the selected group.

v2rayNG for Android

Open the menu in the top-left corner of the main screen and select “Subscription Group Settings.” Tap Add, enter a group name and subscription URL, then save. Return to the server list and make sure the new group is selected. Open the top-right menu and choose “Update subscription.” Seeing the group name only means its details were saved; it doesn't mean servers have been fetched. Wait for the update to finish, then check for servers in the group. There's no need to tap Update repeatedly.

If the list is still empty, first check that you're viewing the right group, then read the update message. If it times out, make sure the device has a working internet connection. If the URL can't be parsed, check that you copied the subscription URL, not a login or information page. If the client says the subscription has expired, check its status on your provider's account page. Note the error type while troubleshooting, but don't post the full subscription URL in a public comment; it may contain account access credentials. Once at least one server appears, move on to proxy mode.

Step 2: Choose a Proxy Mode

Proxy mode determines which apps send requests to the client; the server determines where requests that match the proxy rules are sent. These are separate choices. For your first test, use just one browser. Confirm the simplest connection works before changing routing, DNS, or app coverage all at once; otherwise, it'll be hard to tell which change caused a problem.

v2rayN: Start with the System Proxy

Find the v2rayN icon in the system tray, then open its context menu and locate “System Proxy.” “Set system proxy” adds the client's local proxy endpoint to your system settings, allowing browsers and other apps that follow those settings to use it. “Clear system proxy” removes the proxy settings configured by the client. For now, just locate these options; after choosing a server in the next step, select “Set system proxy.” If the main window has an “Enable TUN” switch, leave it off for your first test.

Some apps use their own network settings, so they may not use the system proxy even if the browser test succeeds. First check whether the app can follow the system proxy; there's no need to switch servers right away. If you need the client to handle more apps, read TUN and system proxy in the glossary and check the permissions and platform-specific notes in the setup guide. To compare the two modes, note your original settings and change only one thing at a time.

v2rayNG: Keep the Default Routing

On Android, app traffic usually goes through the system VPN interface. You don't need to enter a proxy address in Wi-Fi settings for your first test. After installing v2rayNG, keep the default routing option under “Settings.” If you've used “Per-app proxy” before, make sure the test browser isn't excluded, or temporarily restore the default app scope. If another app is using the VPN interface, make sure you can stop it before continuing. On managed devices, don't change existing connections without authorization.

Once you've chosen a mode, there's no need to change DNS or import extra rules yet. Routing rules determine whether a request goes through the proxy or connects directly after reaching the client. Even when an app is covered, not every address is necessarily routed through the same server. Just note which connection mode you're using, then put one server to work in the next step.

Step 3: Select a Server and Connect

A server appearing in the list only means the client has loaded its configuration. For your first test, choose one that your service provider marks as available and note its displayed name. There's no need to run a speed test on the whole group or sort every server. Testing one at a time makes it easier to match any log errors to your actions.

v2rayN: Set the Active Server

Return to the main window, right-click the target server in its subscription group, and select “Set as active server.” Some versions highlight the current server; others show its name in the status area. Check which one your version uses. Then open the tray menu and choose “System Proxy → Set system proxy.” At this point, two things should be true: the client is using the server you selected, and the system proxy menu shows the selected mode is active. Highlighting a row without setting it as the active server doesn't switch servers.

If the logs immediately report that the core failed to start or a local port is in use after you set the active server, fix that specific error first. Repeatedly toggling the system proxy won't help. Close any duplicate client instances you opened yourself, then try once more. If the error persists, see the startup guidance in the setup guide. If the client hasn't started successfully, clear the system proxy settings you just applied so other apps don't send requests to an unavailable local endpoint.

v2rayNG: Connect and Approve the VPN Request

Tap the server you want in the list, then tap Connect on the main screen. The first time you connect, Android will usually show a VPN connection request. Make sure the prompt names the app you're using, then approve it. The Connect button should change to a control you can use to stop the connection, and a VPN indicator may appear in the system status area. If it quickly returns to a disconnected state, check the app logs to see whether VPN permission was denied or the client failed to start.

You can now verify the connection; there's no need to switch to another server yet. The proxy status in the desktop menu and the VPN indicator on Android only show that the connection mode is enabled. To find out whether the server can handle real requests, send a new request from your test app.

Step 4: Verify the Connection

Check two things separately: whether the app can make a request, and whether that request was routed through the proxy. An already-open page may be cached, while a system connection icon doesn't show where a request went. First, use a familiar page to confirm basic internet access. Then, in the same browser, make a fresh request to a test destination that should use the proxy under your current rules. Don't switch networks, servers, or browsers during the test.

Compare with the Connection On and Off

With the connection on, load the test destination in a new tab and note whether it opens and roughly how long it takes. If the client's log level records access requests, look up the destination at that time and check whether it used a proxy or a direct route. Then disconnect: in v2rayN, select “Clear system proxy” from the tray menu; in v2rayNG, return to the main screen and tap Stop. On the same network, open the same destination again. Don't rely on an old tab that's still loading. If you need to keep your original network settings, restore them using the notes you made before testing.

If you have a trusted page that reports your public IP address, you can compare its results too, but first make sure your routing rules send that destination through the proxy. A different IP with the connection on shows that this request took a different route; it doesn't prove that every app uses the proxy. If the results match, check whether the destination is covered by a direct-connection rule, whether the browser follows system settings, or whether the browser is excluded from v2rayNG's app coverage. Treat this as a test of one specific app and destination.

Use the Results to Decide What to Check Next

If servers are listed but the browser times out as soon as you connect, first check whether a regular page loads with the proxy off. If it does, check that the correct active server is selected and that the client started without errors. Once both are confirmed, try a known-working server for comparison without changing anything else. If pages still won't load with the proxy off, troubleshoot the device's internet connection first. If the browser works but one particular app doesn't, go back to Step 2 and check whether that app uses the proxy; don't import the subscription again.

Your first setup is complete once you can reliably reproduce an expected proxied request and know how to disconnect or clear the system proxy. To check subscription update intervals, system permissions, or how to route a specific app, find the relevant platform section in the setup guide. If you come across unfamiliar terms such as routing, DNS, or core, look them up in the glossary to see what each one does.