Before importing, identify what you have: a subscription URL, subscription contents, or a single server share link. Add a subscription URL to a group and then update it; import a server link directly from the clipboard. If the list is still empty after an update, troubleshoot the download, parsing, and connection stages before reinstalling the client.
Subscription URLs, subscription contents, and server links: what's the difference?
A subscription URL tells the client where to fetch configuration. The subscription contents are what it receives, while a share link usually describes a single server. They may all come from the same page, but they don't belong in the same input field.
| What you have | How to identify it | Where to use it |
|---|---|---|
| Subscription URL | Usually starts with https:// and is labeled for a specific client by the provider | Add it in subscription group settings, then update |
| Subscription contents | May be a single Base64 string or a list of server links, one per line | Use the original subscription URL if available. If you only have the contents, identify the format before importing the links as servers. |
| Server share link | For example, starts with vmess:// or vless:// | Import a server from the clipboard |
A URL starting with HTTPS isn't necessarily a subscription. Account login and QR code pages also use HTTPS, but they don't return a server list the client can parse. Use the full URL the provider specifically labels as a subscription. Keep any query parameters after ? when copying; don't copy just the domain, since parameters may contain an access token or specify the output format.
How to Add and Update a Subscription in v2rayN
In the desktop app, saving a subscription group and downloading its servers are separate actions. The menu names below are from the Simplified Chinese interface; labels, button placement, or punctuation may vary by version. Choose the equivalent options in your version.
Open subscription group settings
From the main window, select “Subscription Group” → “Subscription Group Settings.” If you already have a group for the same provider, edit it rather than adding a duplicate.
Add a subscription
Click “Add.” Enter a recognizable name under “Remarks” and paste the full subscription URL under “Optional Address (Url),” then confirm and save. The name is only for identifying the group locally, not a login name. Keep all URL parameters intact.
Update the current group
Return to the main window, switch to the group you just saved, then select “Subscription Group” → “Update current subscription (without proxy).” For a new setup, start with a direct update and update one source at a time so you can tell which subscription an error refers to.
Check the import result
Check whether servers appear in the current group, then select one from the list. If you only have a single share link, copy the entire link and use “Servers” → “Import bulk URLs from clipboard” instead. Clipboard imports aren't updated when you refresh a remote subscription.
Import a Subscription and Choose a Server in v2rayNG on Android
On Android, use the top-left menu to manage and update subscriptions. The “+” in the top-right corner imports servers from the clipboard. Identify what you have before choosing an option.
Open subscription management
Open the top-left menu on the main screen, tap “Subscription Settings,” then tap the “+” on the page. To replace an expired URL, edit the existing group instead of clearing all your settings.
Enter the group details
Enter a remark and the subscription URL, then save using the confirmation button in the top-right corner. If you copied the URL from a chat message, check that you haven't included a trailing period or quotation mark and that all query parameters are intact.
Return and update
Go back to the main screen, open the top-left menu, and tap “Update subscription.” When the update finishes, switch to the relevant group to check for servers. A visible group label only means its settings were saved; it doesn't mean the servers were downloaded successfully.
Select and connect
Tap a server in the list, then tap the connect button. The first time you connect, approve the VPN permission prompt from Android. To import a single share link, copy the full link, then tap “+” in the top-right corner of the main screen → “Import from clipboard.”
Base64 Subscription Contents and VMess and VLESS Share Link Formats
A common Base64 subscription encodes a list of server links as a single text block, usually with one link per line after decoding. The Base64 after vmess:// usually encodes the JSON for a single server. To tell which layer to decode, check for a protocol prefix first; don't include the prefix in the decoded input. Base64 is an encoding, not encryption, so anyone with the text can usually recover the authentication details.
VMess share link
- Prefix
vmess://- Typical payload
- Base64-encoded JSON object
- Server address and port
add、port- Authentication and transport
idis the user ID;netis the transport type- Server name
psis the display name
This is a common share link format. To inspect its fields, decode only the payload after the prefix locally; use the complete link for importing.
VLESS share link
- Prefix
vless://- Authentication ID
- Usually a UUID before
@ - Server address and port
- Between
@and the query string - Query parameters
typespecifies the transport;securityspecifies the security layer- Server name
- Usually the display name after
#
These links usually express their fields directly in the URI rather than encoding the entire server configuration as Base64.
The subscription download port, server port, and client's local listening port are different things. Don't change the server port to 443 just because the subscription uses HTTPS, and don't put the example local port 10808 in a server configuration. Preserve percent-encoded values such as %2F in VLESS links; decoding them too early can change field boundaries.
Subscription Import Failed? Check Download, Parsing, and Connection
- Download: If an update times out, fails to resolve the domain, or returns an HTTP error, first check whether the subscription request succeeded. Verify the network, URL, and status code. Changing server transport settings usually won't help at this stage.
- Parsing: If the update completes but imports zero servers—or only some appear—check the response format and whether the client supports the protocols and transports used by those entries. If the provider offers multiple export options, choose the subscription format specifically intended for v2rayN or v2rayNG.
- Connection: If servers are listed but won't connect when selected, at least one server was parsed. Confirm which server is active, reproduce the problem, and check the connection log. Don't mistake a connection failure for a subscription update failure.
Subscription updates keep timing out. Should I use a proxy?
Start with an update without a proxy and check whether your current network can reach the subscription host. If you already have a working connection on desktop but a direct request to the subscription host times out, try “Update current subscription (through proxy)” once for comparison. During initial setup, there's no working server to use, so switching to a proxied update won't solve the connection dependency.
I got a 401 or 403 error. Is the Base64 format wrong?
These are HTTP response status codes. Check access permissions first, not the encoding. Return to the provider's page and copy the current subscription URL again. Check whether the token has expired or any query parameters were cut off. If the new URL is still rejected, check your account status or restrictions on the URL.
The subscription opens in my browser, so why does the client show zero servers?
A page loading in your browser doesn't mean the client received a server list. The response may be a login page, an information page, or configuration in a format the client doesn't support. Your browser may also be using an existing login session. Check that you're using the client-specific URL provided by the service; don't treat content shown after logging in as subscription data.
What if the desktop app shows more servers than the mobile app?
First, check that both clients use the same subscription source and corresponding group, then update each one. If the lists still differ, compare the protocols and transport settings of the missing servers, then check the update message in the Android app. The server may return different content depending on the request, so a difference in server count alone doesn't prove an import failed.