V2Ray FAQ

Find answers by symptom: for a first-time installation, check your OS and package type; if a setup that used to work has stopped, go straight to troubleshooting. Change one setting at a time and test again with the same website or app.

Getting Started

What’s the difference between V2Ray, a client and a core?

In everyday discussions, V2Ray usually refers to an open-source proxy toolkit and its ecosystem. The core establishes connections, parses configuration and applies routing rules. A graphical client provides an interface for importing nodes, selecting an outbound and viewing logs. Knowing the difference helps you troubleshoot in the right place: if a button is missing, check the client version; if the connection log reports an unrecognized field, check which core is actually running and its version. Don’t rely on the client’s name alone.

What’s the difference between a subscription link and a single-node link?

A subscription link lets a client retrieve a list of nodes and refresh it when the list changes. A single-node link contains just one connection configuration and won’t update with a subscription. When you receive a link, use the import option specified by its provider rather than relying on the link’s prefix. If you need help troubleshooting, share only the link type, import method and error message. Subscription URLs may contain access credentials, and node links may contain connection credentials—never share the link itself or its QR code.

Are routing rules, system proxy settings and TUN the same thing?

No. System proxy settings tell apps that honor them which local endpoint to send requests to. TUN is a virtual network interface that can receive traffic from some apps that don’t use system proxy settings; what it captures depends on routing configuration and system permissions. Once traffic reaches the client, routing rules determine whether it’s proxied, connected directly or blocked. Troubleshoot these separately: first check whether the traffic reaches the client, then check where it’s routed.

Are VMess and VLESS speed test modes?

No. VMess and VLESS are connection protocols that determine how a client communicates with a server. A speed test is a test the client runs against a configuration. Use the server’s configuration to choose a protocol, and check the accompanying transport and security settings. If the client reports that the configuration isn’t supported, check core compatibility first, then make sure you imported the right configuration. Changing the protocol in a dropdown won’t make the server support a different protocol.

Deployment

Which Android package should I choose: arm64 or universal?

If your device supports arm64-v8a, choose the arm64 package. If you’re unsure which app architectures it supports, choose the universal package or check the device manufacturer’s specifications. A universal package usually includes components for multiple architectures, so it’s larger, and it still has minimum OS version and architecture requirements. If installation fails, check whether the system reports an architecture mismatch, an outdated OS or a conflict with an installed version. Don’t uninstall the old version before backing up your settings.

Which v2rayN desktop package should I download?

Check your operating system and processor architecture first. For Windows x64, choose the desktop or classic WPF edition based on your interface preference. On macOS, check About This Mac to see whether your computer has Apple silicon or an Intel processor. On Linux, choose deb or rpm based on your distribution, and confirm whether you need x64 or arm64. If the client won’t start, note your OS version, package type and startup message, then check the requirements on the download page.

Subscription import failed. What should I check first?

Make sure you’re using the subscription URL import option, not the clipboard option for importing a single node. Copy the full URL, remove any leading or trailing spaces and line breaks, and leave its query parameters unchanged. Save it to the correct subscription group and update manually. If the URL saves but no nodes appear, check the log to see whether the request failed or content was received but couldn’t be parsed. For request failures, check your network or authorization. For parsing failures, check whether the provider’s subscription format is compatible with your client.

What should I do if TUN reports insufficient permissions?

On desktop, check whether the log specifically reports a failure to create the virtual interface or modify routes, then grant permissions as prompted by the client. On Windows, try running a trusted client as administrator. On Linux, check the permissions guidance for your distribution and client; don’t loosen system device permissions without a good reason. On Android, approve the system VPN permission prompt to continue. If another VPN is running, disconnect it before testing.

Advanced Setup

How can I group subscriptions to avoid updating the wrong list?

Create a separate group for each source and give each group a recognizable short name. Don’t include subscription URLs or credentials in group names. After adding a subscription, select its group and update it manually to confirm the nodes appear in the expected list before enabling automatic updates. If you use server-side filtering and the list suddenly becomes empty after an update, temporarily disable keyword filtering, compare the original node names and adjust the criteria. Update one group at a time to pinpoint problems.

How can I tell whether a node is reliable?

Don’t choose a node based on a single latency ranking. First check whether the client tests port connectivity or sends a request through the node—these measure different things. Compare results across several tests using the same test address, network and method, then open the service you actually need and see whether it keeps loading. If slowdowns happen only in the evening, keep a set of daytime results for comparison; that’s more useful than repeatedly refreshing a single speed test.

How can I verify routing if I only want some connections to use the proxy?

Check which routing rules are currently enabled. An outbound is how the client connects to a destination, such as through a proxy or directly. Choose two addresses expected to use different outbounds, visit each one, then compare the destinations and outbound labels in the connection log, if available in your client version. If both use the same outbound, check whether an earlier rule matched or whether neither matched and the default outbound was used. Change one rule at a time, then test the same two addresses again.

What settings should I back up before switching devices?

Use the client’s backup or export feature to save subscription groups, manually added nodes, and any routing or DNS settings you’ve changed. DNS resolves domain names to network addresses. Backups aren’t always compatible across clients. If you’re switching apps, reimport your subscriptions on the new device first, then migrate custom settings one at a time. Don’t wipe the old device until the new one connects successfully. Backups may contain connection credentials, so store them somewhere only you can access.

Troubleshooting

Does a node speed test timeout mean the node is down?

Not necessarily. The test address may be unreachable, which can also cause a timeout. Keep the network and test method unchanged, then compare with another node in the same group. If only one fails, check its address, port, protocol settings and logs. If several fail at once, confirm your local network is working and the core has started, then try a known-good test address. If the same node works on another network, investigate the current network path; a timeout alone doesn’t prove the server is down.

The client says it’s connected. Why won’t web pages load?

A connected status doesn’t mean browser requests are getting through. In the same browser, visit two websites that normally work, then check whether the client log records those requests. If there are no log entries, check whether the browser uses the system proxy. If there are entries, see whether the request stalls at DNS resolution, the remote connection or routing. If only one site is affected, check that domain’s DNS resolution and outbound rules first. Avoid changing the node, DNS and mode all at once, or you may lose useful troubleshooting clues.

Why does system proxy mode in v2rayN work for some apps but not others?

Test with a browser that follows system proxy settings. If the browser works but another app doesn’t, check whether that app has its own proxy settings; don’t assume every app uses the system settings. If the browser also fails, make sure the system proxy’s local address and port match v2rayN’s listening settings, and check the core log for port conflicts. If multiple proxy tools are running, let just one manage the system proxy, then test again.

A subscription that used to work suddenly won’t update. How can I troubleshoot it?

Keep your existing nodes and groups. Manually update only the subscription that failed, then check the log for that attempt. If the request timed out, check your current network and whether the update depends on a proxy that’s no longer connected. For a 401 or 403 response, check authorization, subscription expiry and whether the URL has changed. If the request succeeds but parsing fails, ask the provider to confirm that it returned compatible subscription content rather than a login or error page. When reporting the issue, share only the error and time—not the subscription URL.

Related Setup Guides

If you haven’t made your first connection yet, follow the steps in Getting Started. For installation requirements, visit Client Downloads. If you’re already connected and want to adjust routing or DNS, see Advanced Setup.