How to Use v2rayN and v2rayNG

Have your subscription URL? Follow these four steps to connect for the first time: import the subscription, choose a proxy mode, connect, and verify with a real request. Test one configuration first; there’s no need to change advanced settings.

Step 1: Import a Subscription and Update the Group

First, make sure you have a client subscription URL. Your provider typically supplies one complete URL that retrieves a group of configurations. If you copied the account login page, the client may receive a webpage instead. If the text starts with vmess:// or vless://, it is usually a single share link; use the client's clipboard import option rather than pasting it into the subscription URL field. Keep any parameters at the end of the URL—don’t copy just the domain.

v2rayN: Configure a Subscription Group

Open the main window and find “Subscription Group” at the top, then select “Subscription Group Settings.” Choose Add, enter a recognizable name in “Remarks,” and paste the full subscription URL into “Optional address.” Save, return to the main window, and switch to the new group. Open the subscription group menu again and choose Update Current Subscription. If the only option is to update all subscriptions, first check which groups are listed, then run the update. You don’t need to set an automatic update interval for the initial import.

Saving only means the client has stored the URL. After the update, check the main list: switch to the new group and confirm that configuration entries appear. If another group is still displayed, don’t create the subscription again. Switch groups first, then check the update notification or logs to confirm which group—and URL—was updated.

v2rayNG: Add a Subscription, Then Update from the Main Screen

Open the side menu on the main screen and go to “Subscription Group Settings.” Tap Add and enter a name and subscription URL. After saving, return to the main screen and select the group. Open the menu in the upper-right corner and choose Update Subscription. Some versions put the update option in the group management screen or use a similar label, such as “Update Subscription Group.” Return to the list and confirm that selectable configurations appear under the new group.

If you see the group name but no configuration entries, stop here. If the URL is reported as invalid, check for extra spaces, line breaks, or quotation marks. If authentication fails, return to your provider’s subscription page and make sure the link hasn’t expired. If the request times out, confirm that your device has an active internet connection, then try the update again. Don’t post your full subscription URL in a public forum or paste it into an unfamiliar website to check its format. Once configurations appear in the list, continue to choosing a proxy mode.

Step 2: Choose System Proxy or VPN Mode

Proxy mode determines how app requests reach the client; routing determines which outbound a request uses after it gets there. Treat these as separate settings. For your first connection, keep the client’s existing routing configuration and choose just one way to route traffic through it. If you change the mode, routing, and configuration all at once, it’ll be hard to tell which change caused a problem.

v2rayN: Find the System Proxy Menu

Find “System Proxy” in the main window or the desktop tray icon’s right-click menu. Common options include “Clear system proxy,” “Set system proxy automatically,” and “Do not change system proxy.” For an initial browser test, you can choose “Set system proxy automatically.” First, note where this option is; apply it after the active configuration is ready in the next step. Enabling the system proxy too early may send browser requests to a local port that isn’t ready yet.

After you enable automatic system proxy settings, only apps that follow the system proxy will use that route. Browser access doesn’t mean every app uses the same setting. “Do not change system proxy” keeps the current setting; it doesn’t turn the proxy off. “Clear system proxy” changes the current system proxy settings. If your device already uses a work or school proxy, note its existing settings and follow your organization’s device policies—don’t overwrite or clear them without checking first.

v2rayNG: Use VPN Mode for the First Test

For your first test on Android, use the client’s VPN mode. If the settings offer a service mode, select VPN rather than a mode that only provides a local proxy port. VPN mode receives traffic through the system interface, so you don’t need to enter a proxy address in the browser. Don’t change the per-app proxy list yet; the browser you’re testing could be excluded. If another VPN is already active, check what it’s for first. The system may ask to replace the existing connection; don’t disable a work-managed or security-required connection.

At this point, you know where to enable the system proxy on desktop and have selected a service mode on Android. Next, return to the subscription group list, select a configuration, and start the service. Don’t enable another traffic-routing method until you’ve finished verifying the connection.

Step 3: Select a Configuration and Connect

Return to the group you updated in step 1. Select a configuration that works on your current network and is marked as available by your provider. For the first test, use just one active configuration; don’t switch between several in quick succession. Make a note of the group and configuration name so you can match any errors in the logs to the action that caused them.

v2rayN: Set the Active Configuration, Then Enable the System Proxy

Select a configuration in the main list, then activate it by double-clicking or choosing the Set as active configuration option from the right-click menu. Highlighting a row doesn’t necessarily make it active. Check the active configuration indicator, status bar, or latest startup log. If your version doesn’t start or restart the service automatically, use the client’s start or restart option and check the logs for errors such as a core startup failure or a port already in use.

Once the client reports no startup errors, return to the “System Proxy” menu from the previous section and choose “Set system proxy automatically.” Then open the browser you’ll use for testing. If your usual sites stop loading, undo this change or restore your previous proxy settings, then check the client’s startup logs. Don’t repeatedly refresh pages to work around a local service that isn’t ready.

v2rayNG: Tap Connect and Approve the System Prompt

Select a configuration on the main screen and make sure the selection indicator moves to the right entry. Then tap Connect. The first time you start the VPN, Android will usually show a system connection request. Confirm that the prompt is from the client you just opened, read it, and decide whether to approve it. After approval, check that the client button shows a running state and that Android displays a VPN indicator. Previously authorized devices may not show the prompt again, so check the current connection status.

If the button quickly returns to a disconnected state after you tap Connect, open the client logs and check the latest startup entry. If you canceled the system permission prompt, try connecting again. If there’s a configuration or core error, first make sure the active configuration is from the group you just updated. A running button only means the local service has started; it doesn’t confirm that the remote connection works. Make a new request in the next step to check.

Step 4: Verify That the Proxy Is Working

Check three things: whether the client is running, whether the browser request reached it, and whether the request used the expected outbound. A tray or VPN icon only confirms the first. Even if a page opens, it may have loaded from cache or used a direct route under the current rules. Don’t rely on a status icon or a single page load to verify everything.

Make a New Request and Check the Logs at the Same Time

Open the client logs and note the current time. Then use a browser to visit a test page you’re authorized to access and know should respond. You can open a page you haven’t visited before in a new window to reduce the effect of cached content. Return to the client and look for a log entry for that destination at the same time. If the interface shows outbound labels, direct usually means a direct connection and proxy usually means proxy outbound. Custom configurations may use different labels, so check the configuration. A direct entry shows that the request reached the client, but it doesn’t prove proxy outbound is working.

To verify proxy outbound, choose a test destination that an existing routing rule clearly sends through the proxy, then make a new request. You’ve confirmed that the proxy request worked only when the expected outbound appears in the logs and the page loads successfully. Some versions or log levels don’t show individual requests; check whether an access log is available. The absence of a destination in the logs doesn’t prove that it connected directly. You don’t need to keep logging at the most detailed level—restore the previous setting when you’re done troubleshooting.

Troubleshoot by symptom; change one setting at a time

The page loads, but there’s no matching client log entry: On desktop, check that automatic system proxy settings are still enabled and that the browser doesn’t have its own proxy settings overriding them. On Android, confirm that the VPN is still running and that the browser isn’t excluded by per-app rules. Make the same test request again, then check the logs. If the logs don’t record individual requests, fix the way you’re monitoring traffic before changing subscriptions.

There’s a request log entry, but the page won’t load: Check whether the log shows a DNS lookup failure, connection timeout, or handshake error at the same time. If direct outbound fails, first check that the device can reach the destination over its regular network. If proxy outbound fails, keep the current mode and test destination, and try another configuration from the same subscription. If only the original configuration fails, check its availability first. If several fail at the same stage, note the error type and troubleshoot that stage.

When you’re done testing, restore the previous system proxy settings on desktop before exiting the client. On Android, tap Disconnect in the client and confirm that the system VPN has ended. You don’t need to add the subscription again next time; select the configuration you already tested. Update the subscription only if the group needs refreshing. To learn more about rule order, domain strategies, or the scope of TUN traffic handling, read the V2Ray configuration guide. There’s no need to change these settings during your first connection.