v2rayN / v2rayNG / v2flyNG Tutorials

Full walkthrough of install, subscription import, connecting nodes, and common troubleshooting.

V2Ray client quick-start overview

Whether you use v2rayN(Windows / macOS / Linux)、v2rayNG(Android) or v2flyNG(Android · v2fly core), the full flow is: download & install → import subscription/nodes → pick a working node and connect → verify the network. Start with the shared steps below, then open the detailed guide for your platform.

  1. 1

    Pick your OS and download a client

    Different systems need different clients — the wrong one won’t install well or will feel broken:

    • Desktop: download v2rayN(Win / macOS / Linux), install for your OS, then run
    • Android (recommended for most people): download v2rayNG
    • Android (when you need the v2fly core): download v2flyNG

    On Android phones, prefer the arm64-v8a APK build.

  2. 2

    Import a subscription URL or a single node

    The client doesn’t ship with nodes — you need to import a config before connecting. Common ways:

    • Subscription URL: import a full node set at once and update with one tap — best for daily use
    • QR code: easiest on phones for quick adds
    • Share link / clipboard: best for importing a single vmess://vless://trojan://ss:// config
  3. 3

    Test latency, connect, and verify it works

    After importing, don’t tap nodes at random — test latency first (or check delay), then pick a reachable server. Once connected:

    • Windows: confirm system proxy is on, then open a page in your browser
    • Android: confirm the VPN icon appears in the status bar, then verify in a browser
    • If pages won’t load, switch nodes first, then check whether the subscription updated successfully

Which guide should beginners open first?

  • Desktop users →
  • Android users →
  • Need the v2fly core →

Before you start

  • Have a working subscription URL, or at least one node config
  • Keep phone/PC system time accurate (large drift can break TLS)
  • Get installers from this site’s Download Center — avoid packages from untrusted download sites

Detailed Guides

Detailed guides by platform

Below are complete, ready-to-follow illustrated guides—easy to use step by step and friendly to search engines.

1. How do I use the v2rayN Windows client?

v2rayN is the mainstream graphical V2Ray client on Windows. First get the zip from this site’s Download Center and extract it fully, then run v2rayN.exe. If security software blocks the first launch, add the whole folder to the trust list and try again.

For setup, prefer a subscription URL: paste it in Subscription settings and update—nodes appear in the main list. Then run a latency test, pick a reachable route, enable system proxy, and connect. Browsers usually need no extra extension to verify. If some apps ignore system proxy, consider switching to TUN mode.

Common issues include: subscription update failures, all nodes red, or proxy on but pages won’t load. Suggested order: “switch node → update subscription → check system time and proxy toggle → look for conflicting browser proxy extensions.”

Open the step-by-step v2rayN tutorial

2. How do I use the v2rayNG Android client?

v2rayNG suits most Android users. When downloading, prefer the arm64-v8a APK, and allow installing unknown apps in system settings. After install, import nodes via subscription, QR scan, or clipboard; on first connect you must grant VPN permission, or no tunnel can be created.

After a successful connection, a VPN indicator appears in the status bar. To proxy only some apps, enable per-app proxy: for example, route your browser through the proxy while keeping banking and payment apps on a direct connection. That usually saves battery and fits everyday phone use better.

If you’re “connected but have no internet,” switch nodes and update the subscription; also check system time, whether battery optimization killed the background process, and whether the system revoked VPN permission.

Open the step-by-step v2rayNG tutorial

3. What’s the difference between v2flyNG and v2rayNG, and how do I use it?

v2flyNG and v2rayNG are highly similar in UI and workflow; the main difference is the core: v2flyNG uses v2fly (v2ray-core), while v2rayNG defaults to Xray. Learning cost is low—if you know one, you can usually use the other.

The flow is the same: download the matching-architecture APK → import a subscription or QR code → grant VPN and connect → set per-app proxy as needed. Without a clear v2fly core requirement, v2rayNG is usually simpler; choose v2flyNG only when your environment or routes clearly depend on v2fly.

Open the step-by-step v2flyNG tutorial

4. What are subscriptions, nodes, and protocols?

A nodeis a single server config;a subscriptionis an update URL for a set of nodes—the client can sync the latest list automatically. Day to day, subscriptions are preferred so you don’t add nodes one by one. Single share links are better for quick tests.

Common protocols include VMessVLESSTrojanShadowsocks , and more. Beginners don’t need to master protocol details first: if the subscription or share link is valid, the client recognizes it and builds connectable nodes. What usually matters more is node quality, your local network, and whether the proxy mode is set correctly.

FAQ

Tutorial FAQ

Frequent questions about install, subscriptions, connections, and permissions.

Which tutorial should I follow for v2rayN, v2rayNG, or v2flyNG?

On desktop, use v2rayN (Win / macOS / Linux); most Android users should use v2rayNG; only when you need the v2fly core, use v2flyNG. All three follow “install → import → connect → verify.”

I only have a share link, not a subscription — can I still use it?

Yes. Copy the vmess://vless://trojan:// or ss:// link, then import it from the clipboard. Subscriptions are better for long-term bulk management.

What if v2rayN fails to update a subscription?

Check that the subscription URL is complete; retry on another network; confirm the local clock is accurate. If it still fails, import a single node first to verify the client can connect.

Android won’t install the APK (“Install unknown apps”) — what should I do?

Open system settings, allow “Install unknown apps” for the current file manager or browser, then tap the APK again.

Connected successfully, but pages still won’t load?

Switch to a low-latency node first; on Windows confirm system proxy is on; on Android confirm the VPN icon is still there. Also check for conflicting browser proxy extensions and calibrate system time.

What is per-app proxy? Should I enable it?

Per-app proxy lets you choose which apps use the proxy and which go direct. Enable it when you only want browsing/messaging proxied; keep global when every app should use the proxy.

What is the difference between system proxy and TUN mode?

System proxy is simple and works with most browsers and apps; TUN mode takes over more thoroughly for programs that ignore system proxy, but is more likely to be blocked by security software. Beginners should start with system proxy.