How to import a subscription link in v2rayN?

After installing v2rayN, the step that decides whether you can get online is importing your provider's subscription link and updating a node list. Many beginners stall here: empty subscription bar, update errors, or no idea which node to pick. This guide walks the full desktop flow—from copying the URL to enabling the proxy—on Windows, macOS, and Linux.

If you haven't installed the client yet, get the package for your OS from v2rayN download, then come back to these steps.

What to prepare first

You need two things: a working v2rayN install, and the subscription URL from your provider (usually starting with https://). Copy the whole string—no extra spaces, no missing trailing characters. If you get both a "subscription" and a single node, prefer the subscription—it syncs many nodes and later updates with one click.

Also confirm your network can reach the subscription URL. If that domain is blocked, you may need another way to get nodes or a backup subscription from your provider.

Add a subscription in v2rayN

Open the client and find subscription management (labels vary by version: "Subscription groups", "Subscription settings", etc.). Then:

1. Choose Add subscription / New subscription.
2. Paste the full URL into the address field; use the provider name as a remark so you can recognize it later.
3. Save and return to the main screen.

This only registers the subscription URL—nodes won't appear until you update in the next step.

Update the subscription to load nodes

In the subscription list, click "Update subscription" or "Update all". On success, the server list fills with regional nodes (e.g. Hong Kong, Japan, Singapore, US). Time depends on subscription size and network—usually a few to tens of seconds.

If the update fails: check that the link was not truncated; make sure system time is accurate (a large offset can break TLS handshakes); try another network; or confirm with your provider that the subscription has not expired.

Speed-test and pick a working node

A long node list does not mean every node works. Tips:

• Run a latency test on the current group and prefer nodes that succeed with lower latency.
• Filter by region and pick a nearby location for the sites you visit.
• If a node keeps timing out, switch to the next one—don’t keep retrying the same one.

Latency results are a connectivity reference, not absolute speed. What matters is whether pages and video load smoothly. If every node fails, the issue is more likely an expired subscription, a local proxy that isn’t on, or wrong system time—not that you “clicked the wrong button.”

Enable system proxy and verify

After selecting a working node, enable System Proxy (or Tun mode, depending on your preference). We also recommend smart routing / bypass rules: keep local sites and apps (shopping, banking, intranet) direct, and send the rest through the proxy—more stable and less unnecessary latency than forcing everything through the node.

After enabling, check the tray or status bar for a connected state, then verify in a browser. If the browser has its own proxy extension, avoid conflicting with system proxy. Once verified, you mainly need to refresh the subscription regularly and re-test when a node dies.

Clipboard & QR: for temporary nodes

Besides subscriptions, v2rayN can import a single share link from the clipboard (common prefixes include vmess://, vless://, trojan://, ss://) or via QR scan. Those are fine for a few temporary nodes, not as your only source—large lists become hard to maintain. Prefer subscriptions day to day; use clipboard/QR as a supplement.

Empty list or update failed? How to check

1. Copy the subscription again and make sure nothing is missing.
2. Confirm the client isn’t outdated; update from the download page if needed.
3. Check that the device clock uses automatic time sync.
4. Switch networks and update once more.
5. If it still fails, ask your provider about subscription status, or try a backup URL.

Import is only the start. If you see nodes but can’t browse, continue with Can’t connect troubleshooting; Android users can follow the Android install tutorial. Full desktop walkthroughs are also in the v2rayN tutorial.

Build a habit: after each subscription update, test latency, then connect, then verify with two sites—one that should stay direct, and one that should use the proxy. Direct traffic should feel snappy; proxied sites should open. If proxied sites work but “direct” destinations get slower, bypass/routing is probably off or too broad—enable smart routing in the settings.

Menu labels may differ slightly across v2rayN versions, but the core path stays the same: Subscription → Update → Pick a node → Enable proxy. Stick to that path and UI revisions won’t throw you off.