At a Glance

This guide explains how to add a subscription URL in v2rayNG, save it as a subscription group, download its server list, and select a node to test. It is for Android users who have a subscription URL from a provider and want to distinguish a successful URL update from a working proxy connection. Follow the steps in order, keep the URL private, and use the update result and client logs to narrow down failures.

A subscription URL is an address that v2rayNG requests to retrieve a list of configurations. It commonly begins with https://, but the prefix alone does not prove that the address is a valid subscription. The response must contain configuration data in a format that the client can parse. A provider’s account page, sign-in page, or purchase page may also use HTTPS but return ordinary web content instead of nodes.

A node share link describes one configuration rather than a group that can be refreshed. Common share-link schemes include vmess://, vless://, and trojan://. Importing such a link can add a node, but it does not automatically create a subscription group or give that individual node a URL to update. Use the subscription-specific address supplied by your service when you want v2rayNG to fetch a list again later.

Identify what you received before importing

Subscription URL
  • Usually an HTTPS address provided for a client.
  • Added through subscription management in v2rayNG.
  • Must be updated after saving to fetch the current list.
  • Can be requested again when the provider changes the list.
Node share link
  • Usually starts with a protocol scheme such as vmess:// or vless://.
  • Imported as an individual configuration, not as a subscription group.
  • Does not refresh itself from a subscription URL.
  • Must be imported again if its connection details change.

If your provider gives you a client subscription address, do not paste it into a field intended for a single node share link.

Subscription URLs can contain account tokens in their path or query parameters. Treat the complete URL like a password: don’t post it in public messages, upload it to unfamiliar conversion websites, or include it in a screenshot. If it is exposed, use the provider’s account controls to replace or reset it, then update the subscription with the new address.

Before adding the URL, check the source and network

Copy the address from the provider’s client setup page or subscription section, not from the browser’s address bar after signing in. Some services display separate URLs for different client formats. If the provider offers a format selector, choose one compatible with v2rayNG and keep any required URL options intact. Do not remove parameters simply because they make the address look unusual; they may identify the account or select the response format.

Adding the address and fetching its contents are separate operations. Saving a URL only records the information in the client. Until an update request succeeds, the group may be empty or may continue to show an older list. Likewise, seeing nodes after an update does not confirm that any node can establish a working connection.

Add a subscription group in v2rayNG

Menu wording and placement can vary between v2rayNG versions and translations. The common route is to open the navigation menu from the main screen and choose Subscription settings or a similarly named subscription-management item. In the subscription list, use the add control, often shown as a plus sign, to create a new entry. Add a short label that helps identify the provider, then paste the complete URL into the address field.

  1. Open subscription settings

    On the v2rayNG main screen, open the navigation drawer and select the subscription-management option. If the label differs, look for the screen that lists subscription groups rather than the list of individual server configurations.

  2. Create a group

    Tap the add control, commonly a plus icon. Enter a recognizable remark such as the provider name or account label. A useful remark makes it easier to update the correct group if you later add more than one subscription.

  3. Paste the full URL

    Tap the URL field and paste the address copied from the provider. Check that the start and end are present and that no space was added. Do not paste a node share link here unless the provider specifically identifies it as a subscription URL.

  4. Save the entry

    Confirm or save the group, then return to the subscription list. Check that the new remark appears. If the group is not listed, reopen its settings and make sure you completed the save action rather than leaving the editing screen.

  5. Request an update

    Use the subscription screen’s update control or the main menu’s update-subscription action. If the interface offers a choice between updating one group and updating all groups, choose the new group for the first test.

Once the request finishes, return to the main server list and check whether configurations have appeared. Some versions show the group name or a divider above its nodes; others display the imported entries within the main list. If the list remains empty, do not keep creating duplicate groups. First inspect the update result, URL, and network request conditions.

Update the list, then select a node

Use the update action whenever you want to fetch the latest configuration set. A saved group can exist without any imported nodes, and a previously populated group can still show old entries if the latest request failed. After updating, check for a completion message, a changed node count, or an error in the application log. The exact indicator depends on the installed version.

1 URL
Save the provider address in the subscription group
2 stages
Save the group, then request an update
1 node
Select one configuration for an initial connection test

When nodes appear, choose one entry on the main screen and start the connection using the client’s connect control. Android may show a system VPN connection request the first time; check that it names v2rayNG and approve it if you intend to create the local VPN interface. A VPN indicator only confirms that the interface was created. It does not, by itself, prove that the selected server can reach its destination.

Troubleshoot failed updates and empty lists

When an update fails, identify which stage failed before changing settings. A request may not reach the provider, the provider may reject it, or the response may not contain a configuration format v2rayNG can parse. The message in the client log is more useful than the fact that the list is empty alone. If the log includes a URL, redact its sensitive path and query values before sharing the message.

“Update subscription” finishes, but no nodes appear. What should I check?

Confirm that the saved address is the provider’s client subscription URL, then check the update log for a response or parsing error. If the provider offers multiple output formats, choose one supported by v2rayNG. A webpage response, login screen, or unsupported payload will not become a node list just because its address uses HTTPS.

The update times out. Should I keep tapping refresh?

First test whether the phone can open ordinary webpages on the same network. If it can, check the URL for copying errors and ask the provider whether the service is reachable or the account is active. Wait briefly before another request; repeated rapid attempts can trigger provider rate limits and make the result harder to diagnose.

The update succeeded, but every node fails to connect. Is the subscription broken?

Not necessarily. Subscription retrieval and proxy connections are separate operations. Select one node, connect, and inspect the client log for connection or authentication errors. Check whether the account is valid and whether the node’s configuration has expired before editing protocol, transport, or security fields.

Use the error wording to choose the next check. A DNS lookup failure suggests that the hostname could not be resolved; a timeout means the request did not finish within the allowed time; an HTTP authorization response such as 401 or 403 indicates that the server rejected the request. These clues do not always identify the complete cause, but they help distinguish a local network issue from an account or URL issue.

Keep subscription groups manageable

If you use more than one group, give each a clear remark and update only the group you are investigating. This avoids confusing entries from different providers and helps identify whether a change came from the latest response or from a different subscription. Before removing a group, check whether you still need its URL or want to preserve a configuration for reference; deleting a group may remove its associated entries from the client’s list.

A provider can change node addresses, ports, protocols, or transport parameters in a later response. For that reason, avoid manually editing imported values unless the provider’s instructions require it. If a node stops working after an update, compare the current entry with the provider’s guidance and check the connection log. Values such as a server address, port, user identifier, transport path, and TLS server name must match the configuration supplied for that node.

The practical sequence is straightforward: add the provider’s subscription URL, save the group, request an update, confirm that entries appear, and test one selected node separately. When an update fails, use the log and response clues to check the URL, network, account access, and content format in that order. This prevents an empty list from being mistaken for a VPN-permission problem or a connection failure from being mistaken for a subscription-update failure.