September 16, 2026 · Getting Started · About 8 minutes

v2rayN and v2rayNG Subscription Setup: Base64 Subscriptions and Share Link Formats

Find subscription settings in v2rayN and v2rayNG, learn how Base64 subscriptions differ from vmess:// and vless:// links, and troubleshoot empty server lists.

At a glance

When importing for the first time, identify whether you have a subscription URL, a single server link, or the text returned by a subscription. Both the desktop v2rayN and Android v2rayNG can save subscription groups, but you still need to update the group after saving its URL. If the list is empty, check the selected group first, then determine whether the request failed or the response could not be parsed.

Subscription URLs vs. share links: choose the right import method

https:// only tells you that this is a web address; it does not mean it is a subscription URL. Copy the URL labeled for your client from the provider's subscription page, not the dashboard address in your browser after signing in. A subscription URL is requested by the client, which then receives content it can read.

Subscription group

Recommended

Save the subscription URL, then use the update menu to fetch the server list. When the provider changes its servers, update the same group instead of pasting each link again. Give the group a recognizable name, such as “Work subscription.”

Best for: A provider-issued subscription URL and a group of servers to maintain.

Import from clipboard

Copy a complete vmess:// or vless:// link, then import it from the clipboard. The client adds the current server configuration; it will not automatically refresh from a subscription just because the link came from one.

Best for: When you have a single share link or want to check whether one server configuration imports correctly.

A typical Base64 subscription encodes a list of share links, separated by line breaks, as a single block of text. Usually, you just enter the subscription URL in the client, which fetches and parses the content. If you only have a long block of encoded text, that is the subscription content—not a URL the client can request periodically. For automatic updates, ask the provider for a subscription URL.

v2rayN on Windows: Add and update a subscription group

These steps use the Chinese-language v2rayN 7.x interface on Windows. Open subscription group settings from the “Subscription Group” menu in the main window, not the system proxy menu. Saving a subscription and selecting the active server are separate actions; you do not need to change system proxy settings before the first import.

  1. Open group settings

    In the main window, select “Subscription Group” → “Subscription Group Settings” to open group management, then click “Add.” If a group with the same name already exists, check its URL before editing it or creating another one, so you can identify the right results.

  2. Enter the subscription URL

    In the edit window, enter a remark and paste the full subscription URL into “Optional address (Url),” then click “OK.” Keep any parameters after the question mark. Removing them may cause the server to return a sign-in page or deny access.

  3. Update the selected group

    Return to the main window and select the new group above the server list. Choose “Subscription Group” → “Update current subscription (without proxy).” For the first update, update only the selected group so it is easier to find the result in the log. If the menu shows “Update current subscription” with a separate proxy option, choose the direct update entry.

  4. Check for imported servers

    After the update, stay in the target group, clear any search terms, and check the list. For example, if the provider is expected to return three servers and you see three rows in the group, they have been imported. To check whether a server works, select one and run a separate connection test.

If you only have a single share link, you can skip group settings. Copy the full link, then choose “Server” → “Import bulk URLs from clipboard” in the main window. On Windows interfaces that support the shortcut, you can also press Ctrl + V in the main window. After importing, check the selected group first; if you cannot find the server, switch to the all-servers view.

v2rayNG on Android: Save the URL, then update from the home screen

These steps use the Chinese-language v2rayNG 1.9.x interface on Android. Use the top-left navigation drawer to manage subscription settings, and the three-dot menu at the top right of the home screen to start an update. The plus button on the home screen is mainly for adding servers; it is not the same as the plus button on the subscription settings page.

  1. Open subscription settings

    On the home screen, tap the top-left menu and open “Subscription Group Settings,” then tap “+” in the top-right corner of the settings page. If you cannot find the option, return to the server list first; do not stay on a server edit screen.

  2. Save a subscription group

    Enter a “Remark” and “Optional address.” If the edit screen has an “Enable updates” switch, leave it on. Tap the check mark in the top-right corner to save. Seeing the new remark on the group settings page confirms that the URL is saved, but does not mean the servers have been fetched yet.

  3. Update the subscription

    Return to the home screen and switch to the relevant group. Tap the three-dot menu in the top-right corner → “Update subscription.” If your version offers “Update current group subscription” and “Update all,” choose the current group. Wait for the update message, then check the server names and count in that group.

If you have just one share link, tap “+” in the top-right corner of the home screen → “Import from clipboard.” If you copied the link from a chat, make sure it does not include explanatory text, trailing punctuation, or line breaks. You do not need to save an empty subscription group before importing from the clipboard.

VMess vs. VLESS: Share link formats and fields

A vmess:// link often contains Base64-encoded data, but that is a different use of Base64 from encoding an entire subscription. The link represents one server configuration; a Base64 subscription bundles a list of links. Base64 is an encoding, not encryption.

VMess share link

Prefix
vmess://
Typical contents
A Base64-encoded JSON object
Server fields
add is the address, port is the port, and id is usually a UUID
Transport fields
net specifies the transport type; WebSocket configurations may include path

When importing, keep the prefix and the complete content that follows it. Do not copy only the encoded part.

VLESS share link

Prefix
vless://
Typical structure
User ID, host, and port, followed by query parameters
Connection parameters
type specifies the transport type, and security specifies the security layer settings
Display name
A fragment after #, if present, is usually used as the server remark

Do not manually remove or edit parameters after the question mark, and do not try to convert VMess to VLESS by changing the prefix.

Empty server list after an update: Check the group, request, and format

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

First switch to the group you just updated and clear any search or filter. If the “All” view shows servers but the target group is still empty, that does not confirm the update succeeded; the all-servers view may show previously imported servers. Check the update message or log to confirm that the target group was updated, and see whether it was skipped.

The update timed out or returned 401 or 403. Should I use a different import method?

Do not switch import methods yet. A timeout means the request did not receive a response in time. First check your network connection and the subscription domain, then try again. For a 401 or 403, check whether the subscription has expired, its token is invalid, or the URL was truncated. Do not paste a subscription URL into the single-server import field to work around the error.

The URL opens in a browser. Why can't the client read any servers?

A page opening in a browser only means the URL returned some content. Even with a 200 status, the response could be a sign-in page, an error message, or a configuration format the client does not support. Go back to the provider's subscription page and select the output format for your client. If the provider lets you copy a single link, import one as a comparison: if the single link imports but the group remains empty, check the subscription response and its format first.

The list has servers, but none connect. Should I import them again?

First distinguish importing from connecting. If the new servers appear in the list, the client has read their configurations. Test one server and check its address, server-side port, transport, and security layer settings against the connection error. The subscription download URL and the server's connection address are separate things to troubleshoot. Do not enter your local proxy port as the server's remote port.

Download v2rayN