V2Ray Setup Guide
First, make sure the subscription group contains server entries, then route an app through the proxy. Finish by checking a real web request—not just the connection icon—to confirm the routing result.
Before you begin, make sure your device can access the internet and have the subscription URL from your service provider ready. Haven’t installed a client yet? Choose the right version on the Download page, then come back here. Menu labels can vary slightly by version. If you don’t see an exact match, look for the menu in the location described and choose the option with the relevant purpose; there’s no need to change versions just to match a screenshot.
Import and Update a Subscription
Importing a subscription takes two steps: save the URL, then update the group. Saving creates the group name, but doesn’t mean server entries have been downloaded. Give the new group a recognizable name so you can tell it apart from existing groups when updating.
v2rayN: Add a Subscription URL to a Group
At the top of the main window, open “Subscription Group” and choose “Subscription Group Settings.” Click “Add” or the equivalent option to create a group. Enter a recognizable name in the remarks field, paste the full subscription URL into the address field, and save. Back in the main window, switch to the new group, then use the “Subscription Group” menu to update the current subscription. For the initial setup, if the menu offers “Do not use proxy” and the subscription source is accessible over your regular connection, choose it. This avoids relying on a connection that hasn’t been established yet.
v2rayNG: Save the Group, Then Return to the Configuration List
Open the menu in the top-left corner of the main screen and select “Subscription Group Settings.” Tap the plus icon in the top-right to add a group. Enter a name and subscription URL, then tap the save icon. Return to the configuration list and switch to the group you just saved. Open the top-right menu and choose “Update current group subscription” or “Update subscription.” If the update option doesn’t specify a group, return to the new group afterward and check it there—not just the overall list for entries that were already present. Don’t tap the Connect button in the bottom-right yet.
Move on once you can see selectable entries in the new group. If you see only the group name and the list is empty, first confirm that the new group is selected. Then check that you copied the full URL and that it has no extra spaces at either end. The subscription URL used in the client is usually different from the sign-in or management page on your provider’s website. If the update fails, go back to the page where you originally got the URL and verify it there. Subscription URLs may contain private access credentials; when taking notes or sharing screenshots, show only the group name and any prompt text. For the difference between a single configuration and a subscription, see the Quick Reference.
Choose a Proxy Mode
Separate two questions: whether an app sends requests to the client, and whether the client connects directly or through a proxy after receiving them. The first depends on how traffic reaches the client, such as through the system proxy or VPN mode. Routing rules decide the second. Enabling the system proxy won’t send requests through a proxy if they match a direct-connection rule. Conversely, changing routing rules won’t affect apps that aren’t connected to the client.
v2rayN: Check Routing First, Then Enable the System Proxy When You Connect
Find “Routing” at the bottom of the main window or in the tray menu, and check the current preset. For your first setup, keep a preset that already works with the client; there’s no need to edit domain rules or their order yet. Note its name so you’ll know whether a test destination should connect directly or use the proxy. Next, find the nearby “System Proxy” menu and locate “Automatically configure system proxy.” Remember where it is, but wait to enable it until you’ve selected an active server and confirmed that the client is running. For your first test, use a browser that follows the system proxy. Don’t also switch to virtual network adapter mode or enter a separate proxy address in the browser, or it’ll be difficult to tell which setting affected the result.
v2rayNG: Use VPN Mode and Test with One App First
Open “Settings” from the side menu. If your version has an option such as “Run mode,” make sure it’s set to VPN mode rather than local proxy only. If the main screen starts Android’s VPN request when you tap Connect, you don’t need to look for a separate mode switch. Then check “Per-app proxy.” You can leave it off for the first test so you don’t have to check whether your browser is on the allowlist. If you already have per-app settings you need to keep, note them first and make sure the browser you’ll test isn’t excluded. You can narrow the proxy’s scope later by choosing which apps to proxy or bypass.
At this stage, you’re only choosing how traffic reaches the client; the mode name alone doesn’t confirm a connection. Keep the subscription group and routing preset unchanged. In the next step, choose an entry from the same group and connect. To learn how rule-based routing differs from global proxy mode, see the Quick Reference once the connection is stable. There’s no need to change every option during your first setup.
Select a Server and Connect
Choose an entry in the group you just updated that your provider lists as available. Use one entry for your first test; don’t run a batch of speed tests or edit transport settings at the same time. The subscription already includes the server address and protocol settings, so start with the configuration as provided. If an error occurs, you’ll know whether it came from the original configuration or a change you made later.
v2rayN: Set an Active Server, Then Enable the System Proxy
Find the entry you want in the server list, right-click it, and choose “Set as active server” or the equivalent. Clicking a row usually only selects it; that doesn’t necessarily make it the active server. Check the active marker in the list or status area. After switching, check the main window’s running log to make sure the core hasn’t immediately reported a startup error. Then choose “Automatically configure system proxy” from the “System Proxy” menu at the bottom of the window or in the tray menu. Check that the menu item is selected, then open your test browser.
If you’ve used another proxy client, disconnect it normally in its own interface first so the two programs don’t keep changing the system proxy. If even sites that normally connect directly stop loading after you enable the proxy, choose “Clear system proxy” from the same v2rayN menu. Check that your regular connection works, then review the startup message in the client. If your computer already has manual proxy settings, note them down and restore the original values after testing.
v2rayNG: Tap Connect and Approve the System Request
Return to the configuration list and tap the entry you want. Confirm that the active marker is on that entry, then tap Connect in the bottom-right. The first time you connect, Android will usually show a VPN connection request. Make sure it comes from the client you just opened, then tap “OK” or “Allow.” You may not see a prompt if you’ve already granted permission. The Connect button should change to a stop or disconnect option, and Android may show a VPN icon or notification. If another VPN needs to stay connected on your device, check whether it can be switched before replacing the current connection.
Wait for the client to show a running state before testing outside the app. On desktop, the active marker shows which configuration is selected; on Android, the VPN indicator shows that a system tunnel has been established. Neither alone proves that the remote server handled a web request. If the button quickly returns to a disconnected state, note whether it happened when you tapped Connect or after authorization, then check the first error message in the app. Find common permission and switching issues in Troubleshooting; there’s no need to keep deleting the subscription or reinstalling the client.
Test Whether a Real Request Uses the Proxy
Check two things: whether the page loads and whether the request uses the expected outbound. Choose a test page you’re authorized to access and know will be routed through the proxy by your current rules. On desktop, use a browser that follows the system proxy. On Android, use a browser that isn’t excluded by per-app rules. After connecting, open a new tab and load the test URL again; don’t judge by a page that was already open before you connected. A browser may display previously loaded content, so a page still being visible doesn’t mean a new request was made.
Check the Request Time and Outbound
If the client logs show request details, note roughly when you loaded the page, then look for the destination domain and outbound tag at that time. In example rules, proxy is commonly used as the proxy outbound tag and direct as the direct outbound tag; actual names depend on your configuration. The test is successful when the page loads and the request matches the proxy outbound. If the logs show only errors or no request details, don’t assume that a missing entry means the request went direct. You can also use a trusted IP address checker and note the results before and after connecting on the same network; make sure the checker itself matches a proxy rule.
If the Result Is Unexpected, Check the Scope Before Switching Servers
If the page loads but the log shows a direct connection, check whether the destination matches a direct rule in the current routing preset. Also check that your desktop browser follows the system proxy or that your Android browser isn’t excluded. If the log shows a proxy connection but the page times out, keep the browser and mode unchanged. Choose another known-working entry in the same subscription group and revisit the same test destination. Change only one setting at a time; otherwise, even if the page loads on the next try, you won’t know which change fixed it.
If your regular connection also stops working, disconnect the proxy and test again: on desktop, clear the system proxy set by the client before exiting; on Android, tap the Connect button to disconnect the VPN. Once your regular connection is back, review the “Choose a Proxy Mode” and “Connect” sections on this page. If timeouts, subscription update failures, or background disconnections persist, note the step where the error occurred, the time, and the message, then use Troubleshooting to find the relevant fix. Remove subscription URLs and private connection details before sharing logs; include only the error information needed to diagnose the issue.