Steps to import subscriptions in v2rayN and v2rayNG: where to add them and how Base64 feeds work

Learn where to add and update subscription groups in v2rayN and v2rayNG, how Base64 subscription feeds are structured, and what to check when an import fails.

At a glance

For your first import, do two things: save the subscription URL, then manually update the group. Seeing the group name only means the URL was saved; nodes appearing under it means the feed was fetched and parsed. Follow these steps in either client to identify whether the content could not be fetched, no nodes could be parsed, or the nodes simply cannot connect.

Subscription URLs vs. individual share links

If your provider labels a link as a subscription URL, add it to a subscription group. Individual links starting with vmess:// or vless:// should be imported through the client’s clipboard import option, not pasted into a group’s URL field. Regular web pages also use HTTPS, so the prefix alone is not enough to tell them apart. Copy the subscription URL from the subscription section of your account page, not the account page’s address bar.

Subscription URL

Common prefixes
https://
Where to add it
Subscription group URL field
How to update
Fetch the URL again and parse the response

The URL path or query string may contain an access token. Copy it in full, and never share it publicly.

Individual share link

Common prefixes
vmess://、vless://
Where to add it
Node import options, such as clipboard import
How to update
Reimport after changing the parameters, or edit them manually

An individual link describes one node. Updating subscriptions will not automatically fetch new parameters from your provider.

v2rayN: Add a group and update its subscription

These steps use the common Simplified Chinese interface in v2rayN 7.x. Button placement may vary by build. Start with the Subscription Group menu at the top of the main window; both adding a URL and updating the list are available there. You do not need to change the system proxy first.

  1. Open the group settings

    In the main window, select Subscription Group → Subscription Group Settings → Add. If there is a + next to the group tabs, you can also use it to open the add-group dialog.

  2. Enter the URL

    Enter a recognizable name in Alias, paste the complete subscription URL into Optional Address (Url), then select OK. The alias is only used to identify the group on this device, so it does not need to match your provider’s name. If the settings window has an Enable Update option, make sure it is turned on.

  3. Update the current group

    Return to the main window, select the new group, then choose Subscription Group → Update Current Subscription (without proxy). Use this option if your current network can reach the subscription URL directly. It refreshes only the selected group, leaving your existing groups untouched.

  4. Check the node list

    Wait for the status message to finish, then check the new group for nodes. If the list is still empty, clear any search terms first, then review the update message. Do not add the same URL again or enter server ports one by one.

If your provider issues a replacement subscription URL, edit the existing group in Subscription Group Settings, then update it. Updating may replace the nodes in that group. Keep any manual nodes you want to retain in a separate group.

v2rayNG: Save a subscription group, then refresh it from the main screen

  1. Open v2rayNG, tap the top-left menu (☰) → Subscription Group Settings, then tap + in the top-right corner.
  2. Enter a label in Remarks and paste the subscription URL. In some versions, the URL field is labeled Optional Address (Url). Tap the checkmark in the top-right corner to save; the back button does not save your changes.
  3. Return to the main screen, select the new group, then tap ⋮ in the top-right corner → Update Subscription. If the menu offers Update Current Subscription and Update All Subscriptions, choose the current-group option first.
  4. After updating, check for nodes in the corresponding group. To use one, select it and tap the start button at the bottom. If Android shows a VPN connection request, make sure it is the one you just initiated before granting permission. A successful import does not mean the connection is already running.

Test the same URL on desktop and Android

Desktop: v2rayN
  • Keep your old groups and refresh the new group separately first. This makes it easier to see which nodes were affected by the update.
  • Test a node in the client first. If it works but your browser is not using the proxy, check the System Proxy setting in the main window.
Android: v2rayNG
  • Save and update the subscription separately on your phone. Groups and selected nodes are not automatically synced with the desktop client.
  • If the desktop client updates successfully but your phone times out, try again on the same Wi-Fi network to rule out differences between mobile data and Wi-Fi.

If your provider allows use on multiple devices, you can save the same URL on both. However, update times, server responses, and supported node types may differ between clients.

Base64 subscription feeds: Check the response body, not the URL length

A common feed format combines multiple share links, one per line, then encodes the entire text as Base64. After fetching the subscription URL, the client decodes the full response body and reads the links line by line. With the traditional vmess:// share format, a link’s payload may itself be Base64-encoded JSON. That is an inner layer within the link, separate from the outer encoding of the full subscription feed.

3 bytes
Complete Base64 input group
4 characters
Encoded length of a complete input group
200
The request succeeded; check the response body too
403
The request was rejected; check the URL and access permissions first

Here is a structure-only example with no node details: the character a followed by a newline encodes to YQo=. The trailing = is padding in this example, but it does not identify a subscription format. Base64 is not encryption, so do not post recoverable content on public forums or third-party decoding sites.

Subscription update failed: Diagnose the issue from the message

The update times out. Should I change the port first?

Not yet. A timeout while fetching the subscription may happen before the client can read any node parameters. Check that you copied the full URL, then try updating the same group on a network known to reach the subscription site. If v2rayN already has a working proxy connection, you can compare by trying Update Current Subscription (through proxy). If you have no working nodes, first restore direct access to the subscription URL.

The update says it finished, but why is the list still empty?

Select the relevant group and clear the search first. Then check the update message for parse failures or zero records. If your provider offers multiple subscription URLs, use the one intended for your client from the account page, save it, and refresh only that group. If the response is empty or reports an account status, check whether your subscription has expired.

The update returns 403. Should I delete and recreate the group?

No need to delete it first. Copy the URL again from your provider’s account page and make sure the query string is intact and subscription access is still active. If your provider has issued a new URL, edit the existing group and update it. If the error persists, report the client version, update time, and status code—never share the full URL.

The nodes appeared. Why can’t any of them connect?

Test one node in the client first, then try another from the same group for comparison if needed. If both tests fail, check the connection logs and your provider’s status. If a test succeeds but apps still cannot connect, check whether desktop apps follow the system proxy settings, or whether the VPN connection is running on Android. Repeatedly updating the subscription will not replace these checks.

Download v2rayNView platforms and installers