This guide explains how to add a v2rayNG subscription: from installing the Android client and pasting in the subscription URL to updating nodes and connecting. It also explains how your IP, DNS, and browser environment can affect the results. Menu names may vary slightly between versions, so follow the options shown in your app.
1. Before you begin: Install the client and check the link
Download the APK for your phone from the official v2rayNG project release page or another trusted source, then install it by following the system prompts. Avoid modified versions from unknown sources. If you need to allow installation from unknown apps, grant temporary permission only to the app you use for this download.
Next, get the subscription URL from your service provider. It is usually a complete link starting with https://. Unlike individual vmess:// or vless:// node links, a subscription URL is generally used to fetch and update multiple nodes. It may contain a personal token, so do not share screenshots or forward the link.
2. How to add a subscription in v2rayNG
- Open v2rayNG and find “Subscription settings” or a similarly named option in the side menu.
- Tap the plus icon to add a subscription. Enter an easy-to-recognize name in the “Remarks” field, such as “Daily subscription.”
- Paste the full subscription URL into the URL or address field. Check that there are no extra spaces or line breaks at the beginning or end, then save.
- Return to the node list and select “Update subscription” or “Update current group subscription” from the menu in the upper-right corner. Wait for the update to finish.
- Make sure nodes appear in the list, select one, then tap the connect button. The first time you connect, Android will display a VPN connection request. Confirm it to establish the local proxy tunnel.
- Open a website you commonly use to test the connection. If it does not load, try other nodes in the same subscription, then check the error message.
Saving a subscription does not mean that nodes have been fetched. You must update it. If you only have a single node link, use an option such as “Import from clipboard” instead of entering it in the subscription URL field. Free nodes provided on this site should also be imported in the format specified on the page. Their availability depends on whether they connect successfully.
3. How to troubleshoot update or connection failures
If you see a download failure message, first make sure your phone itself can access the internet, then check that the subscription URL is complete and has not expired. Some subscription URLs cannot be accessed directly on your current network. If you already have a working connection, try again, or ask the provider to confirm the URL is still active. Avoid refreshing repeatedly in quick succession, as this may trigger access restrictions.
If the update succeeds but no nodes appear, the response may be empty or the subscription format may not be supported by your current version. Try updating the client, then confirm that the URL is a subscription for v2rayNG, not a webpage address or a configuration file intended only for another client.
If nodes appear but the connection fails, check that your system date and time are set to update automatically, close other VPN apps, compare the results over Wi-Fi and mobile data, and check the client logs. Before sharing an error report, hide any sensitive information such as subscription tokens and node passwords.
4. How IP, DNS, and your browser environment are related
A successful subscription import only means that the configuration was retrieved. Your exit IP after connecting depends on the selected node and routing rules. With split tunneling, some websites may still connect directly, so testing a single webpage is not enough to determine whether all traffic is going through the proxy.
DNS resolves domain names. If it is not working properly, the node may appear connected while webpages fail to load. Try restoring the client’s default DNS settings first. Check whether Android’s “Private DNS” or your browser’s secure DNS is set to an unreachable service, then test each setting one at a time to avoid changing multiple things at once.
Browser cache, cookies, location permissions, and your logged-in account can also affect the region a website displays. Try comparing the results in a private window, but keep in mind that private browsing does not automatically change your exit IP. Troubleshooting in the order of “update subscription, connect to a node, access a webpage” makes it easier to find the cause than repeatedly reinstalling the app.