VMess and VLESS Share Links: Single Nodes vs. Subscription URLs

Learn what VMess and VLESS share links and subscription URLs contain, how to import a node from your clipboard or a QR code, and when to manage nodes with a subscription.

At a glance

If you have the full text starting with vmess:// or vless://, import it from your clipboard. If you have a QR code containing the same information, scan it to import. For an HTTPS URL clearly labeled as a subscription, create a subscription group first, then update it. After importing, check the node protocol and server port before selecting the node.

Single-node links vs. subscription URLs

A single-node link contains the configuration for one connection. The common vmess:// share format puts details such as the server address, remote port, user ID, transport, and remarks into JSON, then Base64-encodes it. Base64 is not encryption. A vless:// link usually puts the user ID, host, and port in the main part of the URL, with transport and security settings in the query parameters. A trailing # fragment is typically used for the node name. Copy the entire link; don't remove characters just because they look unfamiliar.

A subscription URL, on the other hand, points to an endpoint the client uses to fetch configuration. When you update it, the client makes a request to that URL and parses the nodes in the response. Common responses contain share links on separate lines or a Base64-encoded list of links. HTTPS only describes how a URL is accessed. Download pages and login pages can also use HTTPS, but that doesn't make them subscription URLs.

Single-node share link

Recommended

Importing creates a copy of one configuration. If the server address, port, or user ID changes later, you'll need a new link to import or update the existing entry as instructed by its source.

Best for: You have one link and want to test that node first.

HTTPS subscription URL

Save the URL to update the group whenever you need to. It is still a subscription even if it returns just one node. Likewise, pasting several share links at once doesn't turn them into a subscription.

Best for: The provider maintains an updated list, and you want to manage changes in one group.

How to tell: check the prefix and the source's label

If you see vmess:// or vless://, use the node import option. If you see an HTTPS URL without a clear subscription label, go back to the source page and look for “Copy subscription URL.” Don't paste the browser's current page address as a subscription.

Import from your clipboard or a QR code

If the link is text on your computer, copy it directly. If the QR code is on your computer screen, scan it with an Android device. Here are the usual options. Menu labels vary slightly between versions: on desktop, look for “Clipboard” or “Scan QR code on screen”; on Android, look for the “+” in the top-right corner of the node list.

Choose an import option for your client

v2rayN for desktop
  • Clipboard: Copy the entire link, open the v2rayN main window, then select “Servers” → “Import bulk URLs from clipboard.” The menu says “bulk,” but it works with a single link too.
  • QR code: Display the entire QR code on your computer screen, then select “Servers” → “Scan QR code on screen.” If it doesn't scan, enlarge the code and move any obstructing windows, or use the corresponding text link instead.
  • Verify the import: Find the new row in the node list and check its protocol and remarks. Then right-click it and select “Set as active server.” Adding a node doesn't automatically switch to it.
v2rayNG for Android
  • Clipboard: Copy the complete link, return to the v2rayNG node list, then tap “+” in the top-right corner → “Import from clipboard.”
  • QR code: Tap “+” in the top-right corner → “Scan QR code,” grant camera access when prompted, and point the camera at the code on another screen. If the code is only on the device you're using and the scanner has no image picker, ask the source for the text link.
  • Verify the import: Tap the newly added node, then tap the connect button. The first time you connect, confirm the system's VPN connection request. System approval doesn't mean the remote node is reachable.

Don't paste a share link into the address field for a subscription group. If importing does nothing, first check that your clipboard contains the link itself—not a forwarded message, webpage title, or screenshot.

What to check after importing

If the node appears in the list, open its editor and compare each setting with the values provided by the source. Don't copy transport or security settings from another node just because it also uses VLESS. Two configurations for the same host may still use different remote ports and transport settings.

443
Examples of common remote ports for TLS; these are not fixed protocol ports
10808
Common local proxy ports in v2rayN; check your local settings

Don't mix up the ports

In the server editor, check the remote port specified by the share link. Use the local listening port shown in v2rayN under “Settings” → “Parameter settings” only when entering a local proxy manually in an app. These two port numbers don't need to match.

  1. Node type: vmess:// corresponds to VMess, and vless:// corresponds to VLESS. Replacing the prefix won't convert one configuration into the other.
  2. Address, port, and user ID: First check that they match the original configuration. If the editor is missing a field, recopy the original link instead of guessing a common value.
  3. Transport and security: If the source uses WebSocket, check the corresponding path and host settings. If it uses TLS or REALITY, verify the relevant fields against the source. Don't enable “Allow insecure” just to clear a connection error.
  4. Is the app actually using the proxy? On desktop, confirm the active node, then, if needed, select “Set system proxy automatically” under “System proxy” in the tray menu. Test with an app that follows the system proxy. On Android, first check that the VPN is running. If per-app proxying is enabled, make sure the app you're testing is included.

Manage regularly updated nodes with a subscription group

If the provider changes URLs or adds nodes, using a subscription is easier than importing share links one by one. Give manually imported entries and subscription groups distinct names so you can tell which one you're using. Updating a subscription only affects its group; it won't update nodes you imported separately.

  1. v2rayN: Open “Subscription groups” → “Subscription group settings,” add a group, and enter a recognizable name under “Remarks.” Paste the full subscription URL into “Address (url).” Save, select the group in the list, then choose “Update current subscription” from “Subscription groups.” Choose whether to update through a proxy based on your current network.
  2. v2rayNG: Open the main menu in the top-left corner and go to “Subscription group settings.” Tap “+” to add a group, enter a name and URL, then save. Return to the node list, select “Update subscriptions” from the top-right menu, and open the relevant group to check the results.
  3. Select a node again after updating: If the original entry isn't in the new list, don't assume an entry with the same name is the same node. Compare its address and protocol in the editor, then set the verified entry as the current connection.

Common import and update issues

Why does my copied link say it contains no valid configuration?

Go back to the original source and use its “Copy link” button if available. Make sure the full link starts with vmess:// or vless://, with no spaces or truncation from a forwarded message. A link wrapping visually on the page doesn't necessarily contain a line break; don't delete parameters to fix the wrap.

The QR code gave me an HTTPS URL. Can I add it as a node?

A QR code alone doesn't tell you whether it contains a node. Return to the page that provided it and check what it's for. If it's labeled as a subscription, copy the original subscription URL into the group settings and update the group. If it's a webpage, look there for the actual node link or subscription option.

The update succeeded. Why don't I see any new nodes?

First clear any search filters and confirm you're viewing the group you just updated. If it's still empty, check the update log to tell a failed request from an unsupported response format. The URL may return content, but it could be a login or error page rather than a node list.

Why does the subscription URL time out when the node works?

Connecting to a node and requesting a subscription are separate network operations. Check whether your current network can reach the subscription provider. If you already have a working node and v2rayN offers “Update current subscription (via proxy),” try that option. If it still fails after several attempts, check whether the URL has changed or expired.

Download v2rayN