v2rayN / v2rayNG / v2flyNG
v2rayN FAQ
Browse by setup stage or error. For connection issues, check the client logs first and change one setting at a time.
Basics
Start by distinguishing the client, subscription, and traffic routing method.
How do v2rayN, v2rayNG, and v2flyNG compare?
Use v2rayN on desktop, choosing a package for your operating system and processor architecture. On Android, check the core requirements from your service provider: choose v2rayNG for Xray configurations, or v2flyNG when V2Fly configurations are explicitly provided. Being able to import a link only means the app recognizes its format; it does not guarantee that the current core supports every transport or security parameter in it.
What’s the difference between a subscription URL and a single server link?
A subscription URL lets the client periodically fetch a set of server configurations. A single server link contains connection parameters for one server. Add the subscription URL to a subscription group and update it after saving; import a single server link from the clipboard into the server list. Either link may contain credentials, so when troubleshooting, share only the error category—not the full URL or QR code.
What’s the difference between system proxy and TUN mode?
System proxy settings are used by apps that support them; apps that ignore these settings may still connect directly. TUN routes matching traffic through a virtual network interface, with coverage depending on routing rules, exclusions, and system permissions. To test a server for the first time, start with a browser that follows the system proxy. Once access works, decide whether you need TUN.
Does routing change the server settings in a subscription?
No. A subscription provides server addresses, authentication, and transport settings. Routing rules decide which outbound connection handles traffic based on conditions such as domains or addresses. Rules are generally matched in order, so a broad rule near the top can override more specific rules below it. After making changes, test one site expected to connect directly and another expected to use the proxy.
Setup
Choose a package, import subscriptions, check permissions, and decide what to back up.
What should I check first if a subscription won’t import?
In v2rayN’s subscription group settings, make sure you pasted the full subscription URL—not an account dashboard URL or a single server link. Remove any spaces or line breaks added during copying, save, then update the selected subscription. If the request succeeds but no entries are imported, check whether your provider returned a subscription format supported by the client or a web page such as a login or renewal notice.
Which Android package should I choose: arm64 or universal?
If your device’s operating system supports arm64-v8a, arm64 is usually the right choice. If you’re unsure which architectures the system supports, check the device specifications and consider the universal package. A 64-bit processor doesn’t necessarily mean the operating system supports 64-bit apps. If installation reports that the package is incompatible, check the Android version requirements. If it conflicts with an installed app, first confirm that the installation source and signing match.
How do I fix a permission error when enabling TUN?
Check the client logs first to distinguish insufficient permissions from a virtual interface creation or route setup failure. On Windows, if the logs explicitly report insufficient permissions, quit the client, restart it as an administrator from the system menu, and test again. On macOS and Linux, grant permissions as prompted by your version. If your device is managed by an organization, check with your administrator rather than weakening system security settings.
How can I keep my v2rayN settings when switching computers?
Use the configuration export feature in your current version if available, and check whether it includes subscription groups, routing, and DNS settings. If there’s no export option, quit the client and back up its user data directory as described in the documentation for that version. On the new device, restore and test one group first, then check system proxy and TUN settings; system-level features may need authorization again. Store backups somewhere secure.
Tips
Organize sources, verify outbound traffic, and keep settings you can restore.
How should I organize multiple subscriptions to avoid selecting the wrong one?
Create a separate group for each source and name it by purpose or provider abbreviation. Don’t include account details or the full subscription URL. Before updating, switch to the target group and confirm that you’re updating the current subscription. After the update, check the active servers again, since older entries may have been replaced or removed. Keep manually maintained configurations separate from subscription entries so server remarks aren’t mistaken for source labels.
How can I tell whether an app is using the proxy?
In a browser known to follow the system proxy, open a site expected to use the proxy and check the client’s connection log for the corresponding domain and outbound. Then launch only the app you’re testing and check for requests at the same time. If the browser works but the app’s traffic doesn’t appear in the client, check the app’s own proxy settings or whether it supports the system proxy. There’s no need to switch servers first.
What settings should I record before changing DNS?
Record the current resolvers, domain matching rules, and outbound used for DNS requests. If a resolver address is itself a domain, also find out which resolver handles it initially. Change one setting at a time, then retest both a regular domain and the one that was failing. If only certain domains are affected, check the matching rules and resolution results first; don’t change DNS, servers, and routing all at once.
Why clear the system proxy before quitting the client?
When the client quits, its local proxy port usually stops listening. If the operating system still points to that port, browsers and apps that follow the system proxy may all fail. If v2rayN set the proxy, choose “Clear system proxy” before quitting. If your device had an organization-managed proxy before, restore its original settings instead of always switching to a direct connection.
Troubleshooting
Narrow down the cause by scope: one server, one app, or all connections.
Does a server test timeout mean the server is down?
Not necessarily. First check what kind of test timed out: a connectivity test and a test that visits a URL through the proxy check different parts of the connection. Make sure your network is working, then compare other servers in the same subscription. If only one server fails, check its address and transport settings. If several fail, check whether the core is running, whether the test target is available, and whether the logs show a DNS or connection error.
The client says connected, so why won’t websites load?
“Connected” usually means the client service or network mode has started; it doesn’t mean the destination is reachable. First check whether the client receives browser requests, then see which routing rule each request matches. If the logs show a DNS resolution failure, check DNS. For a handshake failure, check the server settings and device clock. If only certain sites fail, compare with another site before reinstalling anything.
Why do some apps ignore the system proxy?
Make sure v2rayN is set to “Automatically configure system proxy,” not “Do not change system proxy.” In your operating system’s proxy settings, check that the local address and port match the values the client is currently listening on. If the browser works but one app doesn’t, check whether that app has its own proxy settings. If nothing works, check the core startup logs and look for a local port conflict.
A subscription used to work. What should I do if updates now fail?
First distinguish a failed subscription download from a failed server connection; they can happen independently. For an update timeout, check your local network, subscription domain resolution, and the current update method. If you see an authorization error or a missing address, ask your provider whether the subscription expired or its URL changed. Don’t delete the old groups still stored locally; first confirm the new URL imports valid entries, then clean up.