V2Ray FAQ
Find answers for your issue: choose an installer, import a subscription, or troubleshoot node timeouts and a system proxy that isn’t working.
Basics
Which should I choose: v2rayN, v2rayNG or v2flyNG?
For desktop devices running Windows, macOS or Linux, start with v2rayN, then choose a package for your operating system and processor architecture. On Android, v2rayNG with the Xray core is a good first choice; consider v2flyNG only if your configuration provider specifically requires the V2Fly core. If a configuration imports but will not connect, you do not need to switch clients right away. First check whether the protocol, transport and security settings are supported by the current core, then decide whether to try another client.
What’s the difference between a subscription URL and a single node link?
A subscription URL points to a list of configurations that can be fetched again. Add it to a subscription group, then update the group. A single node link contains one configuration and is usually imported from the clipboard or by scanning a QR code. Don’t judge by whether the link starts with HTTPS; check its stated purpose and format with the provider. Subscription URLs may contain account credentials, so hide the full URL and query parameters in screenshots. Don’t share QR codes for individual nodes either.
Do system proxy and TUN mode cover the same apps?
Not necessarily. A desktop system proxy tells apps that honor the setting to send requests to the client’s local proxy port. Some apps use their own proxy settings, while others ignore the system proxy entirely. TUN uses a virtual network interface to receive traffic routed to it by the system; actual coverage depends on routing, exclusion rules and the client’s implementation. To check whether a browser can use the proxy, try the system proxy first. Consider TUN only after confirming that an app ignores the system proxy.
What’s the difference between Global, Bypass mainland China and Direct routing?
These modes determine how traffic entering the client is routed. Global mode generally sends traffic entering the client through the proxy, but does not mean every app on the device is covered. Bypass mainland China sends traffic that matches domain or IP rules directly; the exact scope depends on the rule set. Direct mode generally avoids proxy nodes. To test routing, use the same app and destination, change one mode at a time, then compare the matched rule and outbound route in the logs.
Installation & Setup
Which Android package should I choose: arm64 or universal?
If your device explicitly supports arm64-v8a, choose the arm64 package. If you’re unsure which architectures your current system supports, choose the universal package for the same client. Universal packages typically include components for multiple architectures, but they still have a minimum Android version requirement. A 64-bit processor does not guarantee that the operating system can run 64-bit apps. If installation fails, check the Android version, available storage, and whether an app with the same package name but a different signing key is already installed.
Which should I choose on Windows: Desktop or classic WPF?
For a first install, try the Desktop edition, whose interface is more consistent with the versions for other desktop platforms. Choose classic WPF if you prefer its traditional menu layout or are following a guide based on the WPF interface. Before installing, check your system architecture and the edition’s requirements. Before switching editions, back up your configuration and exit the old client, including any process in the system tray. Don’t let both editions listen on the same local port, and don’t overwrite your old data until you’ve confirmed the new edition can read the configuration.
Why is my subscription group empty after import fails?
First check what you pasted: a subscription group needs the full subscription URL. Don’t include instructions, extra spaces or a single node link. Save it, update the group manually, then select it on the main screen. If the log shows a successful request but no entries were parsed, the response may be a login page, an error message or an unsupported subscription format. Copy the client-specific URL again from the provider’s site. Don’t paste your subscription URL into a third-party parser to test it.
TUN reports insufficient permissions. What should I check?
Exit any other VPN or virtual network adapter tool currently handling traffic, then try again. Check whether the failure occurs when creating the adapter or adding routes. On Windows, if the log explicitly reports insufficient permissions, exit the client and restart it as an administrator when prompted by the system. On Linux, grant permissions as required by your distribution and package; avoid loosening file permissions without a good reason. On Android, allow the system’s VPN connection request. If network permissions are restricted on a managed work device, contact your administrator.
How-to Guides
Why did my active configuration change after updating a subscription?
An update refreshes the corresponding group with the content returned by the subscription. The selected entry may have been renamed, replaced or removed, and the client may not preserve your previous selection. After updating, check the current group and active entry, then verify that the protocol and transport settings are as expected. Keep manual configurations you want to retain in a separate group instead of editing entries that subscription updates can overwrite. If your current network is the only way to reach the subscription, don’t delete the old group until you’ve tested the new configuration.
What else needs updating after changing the local listening port?
First identify whether the client is listening for HTTP, SOCKS or mixed traffic. Set browsers and other apps to use the same proxy type and port as the client. Update any apps where you configured the proxy manually. If the client manages the system proxy, check that it points to the new port afterward. If the client won’t start, check the logs for a port conflict and make sure the old process has exited. If you only need local access, keep the listener bound to the loopback address; don’t expose it to your entire local network just to troubleshoot.
How do I proxy traffic from just one app?
If a desktop app has its own proxy settings, enter the client’s local listening address and port there; you don’t need to enable the system proxy. On Android, if the client supports per-app proxying, check whether the app list lets selected apps use the VPN or bypass it. Select the target app and reconnect. Test the target app and an unselected app against the same known destination to make sure the rule is working in the intended direction.
How can I tell which DNS or routing rule change took effect?
Note the current core, routing mode and DNS settings, then choose a domain that reliably reproduces the issue. Change one variable at a time, save, and restart the core or reconnect as required by the client. In the logs, check whether the domain resolved, which rule matched the request and which outbound route was used. Also check for encrypted DNS in the app and cached connections. If a change has no effect, revert it before trying the next one. Don’t change the resolver, node and routing mode all at once.
Troubleshooting
Does a node timeout in the speed test mean the node is unusable?
Not necessarily. A speed test may check only the port, or it may access a fixed test URL through the proxy; these tests don’t measure the same thing. First confirm the core is running, then compare the result with a previously working entry using the same test method. If only one entry times out, check its address, port and transport settings. If several time out at once, check your local network, the test destination and the core logs. If the logs report a handshake failure, check the device clock and make sure the security settings match the provider’s configuration.
The client says it’s connected. Why won’t websites load?
Connected may only mean the core is running or the system VPN is established; it doesn’t prove that a web request reached its destination. Note your current proxy settings, temporarily pause the proxy on a network where that’s permitted, and check whether the basic connection works. Public Wi-Fi may require portal sign-in first. Re-enable the proxy, open a site you know is reachable and check whether the client logs the request. If there’s no request in the logs, check the app’s proxy path. If there is one, follow the first failure through DNS resolution, routing and handshake.
v2rayN configured the system proxy, so why isn’t an app using it?
In your system’s network settings, confirm that the proxy address and port were applied and match v2rayN’s current listener. Test a new connection in a browser that follows the system proxy, then try the affected app. If the browser works but the app generates no request logs, check whether it is set to connect directly, has its own proxy settings, or needs a restart to pick up system changes. If the system proxy reverts as soon as it is applied, check whether another proxy tool or device management policy is overriding it.
A subscription used to update, but now times out, is denied or fails to parse. What should I do?
Check the update log to distinguish between the request, the HTTP response and content parsing. If the request times out, confirm that your current network can reach the subscription service. Then check the client’s settings to see whether the update is using a proxy that no longer works. For a 401 or 403 response, check your account and subscription URL with the provider. If the response succeeds but parsing fails, check whether the subscription format has changed. Keep the existing group and test the new URL in a separate group; replace the old one only after the new URL returns usable entries.