client help
V2Ray FAQs
Check each stage of the problem, from client selection and subscription import to node timeouts and DNS issues. Every answer provides a practical troubleshooting sequence for common v2rayN, v2rayNG, and v2flyNG scenarios.
basics
Basics
Start by understanding how the client, core, subscription, and nodes relate to one another. Choosing the right client and package architecture can prevent import and runtime problems later.
How should you choose between v2rayN, v2rayNG, and v2flyNG?
Use v2rayN first on Windows, macOS, and Linux desktops. Android devices typically use v2rayNG with the Xray core; choose v2flyNG when the V2Fly core is required. The client is only a configuration and management interface, so the protocols, transport methods, and server parameters in the subscription must still match.
What is the difference between a V2Ray subscription link and a single node link?
A subscription link usually contains a set of configurations that can be updated after import. A single node link represents one configuration and must be imported and maintained separately. When you receive a subscription URL, use the client's subscription manager instead of pasting it into a single-server address field.
Can VMess, VLESS, and Trojan be used in the same client?
Yes. As long as the client core supports the relevant protocols, configurations using different protocols can be stored in the same subscription group. Select one active node for each connection. The protocol name alone does not determine whether a connection will work; the address, port, user ID, transport, TLS, path, and other parameters must match the server.
How do you choose between arm64 and universal Android packages?
Most recent Android phones and tablets use the arm64 architecture, so start with the smaller arm64 package. If you cannot confirm the processor architecture, or the arm64 package reports that it is incompatible, use the universal package instead. You do not need to install both architecture versions of the same client.
configuration
Installation & setup
After installation, the key decisions involve import methods, proxy capture, and system permissions. First determine whether the content you have is a subscription URL or a single-node link, then choose the corresponding entry point.
Why are there no nodes after importing a subscription into v2rayN?
First check that the subscription URL is complete, especially for spaces, line breaks, or explanatory text accidentally included during copying. Save the subscription, run an update manually, and make sure you are viewing the correct subscription group. If the update reports a format error, open the URL in a browser to confirm that it returns subscription content, then verify its status with the subscription provider.
What should you do when the client does not recognize a pasted share link?
Make sure the copied text starts with a protocol prefix supported by the client, then use the import-server-from-clipboard option. Chat apps may insert spaces or truncate the final characters of a link, so paste it into a plain-text editor first to check that it is complete. If you received a subscription URL, use subscription management rather than the single-node import option.
What should you do if the browser connects directly after system proxy is enabled?
First confirm that the client is running and a working node is selected. Then check whether the system proxy is set to automatic configuration or a global proxy. A separate browser proxy extension may override the system proxy, so temporarily disable it or set it to follow the system. After changing the settings, fully quit and reopen the browser, then check whether another program is using the local proxy port.
How do you handle insufficient permissions when enabling TUN mode?
TUN mode creates a virtual network interface and changes system routes, so administrator permissions may be required. Close the client, restart it with the administrative permissions allowed by the system, and enable TUN again. If it still fails, check whether security software is blocking driver or network-interface creation and whether an old virtual adapter remains. If you do not need to capture all traffic, use system proxy mode first.
daily use
Usage tips
Daily use mainly involves choosing the right routing mode, interpreting test results correctly, and maintaining local settings separately on each device. A subscription synchronizes node content; it does not automatically standardize every system option.
What is the difference between global, bypass-LAN, and rule-based routing modes?
Global mode sends requests handled by the client through the current node and is useful for temporarily ruling out routing rules. Bypass-LAN mode preserves direct access to printers, routers, and internal services. Rule-based routing chooses direct access, proxying, or blocking according to domain or IP conditions. It suits daily use, but rule order and matching scope must be configured correctly.
How should you interpret V2Ray latency test results?
A latency test checks whether the target is reachable and gives a rough indication of connection setup time; it is not a download-speed test. A real connection test usually reflects actual use better than a basic reachability check. Results are affected by your local network, route load, and test target, so test again after some time and consider web access and actual data transfer as well.
How often should a subscription be updated?
Update frequency depends on how often the configuration provider changes its service. Update proactively when nodes stop working, parameters change, or group contents are revised. For routine use, update periodically as needed rather than repeatedly requesting the subscription at every startup. Keep the group currently in use before updating, then confirm the active node afterward so it does not continue pointing to a deleted configuration.
How do you sync configurations between a computer and an Android device?
The simplest approach is to add the same subscription link separately in v2rayN and v2rayNG, then let each device update independently. A small number of individual nodes can also be transferred with share links or QR codes. Do not copy the entire client data directory, because interface settings, local ports, routing rules, and core configurations may not be portable across platforms.
troubleshooting
Troubleshooting
Change only one condition at a time. Check the local network first, then determine whether the issue affects every node or only one. Finally review the system proxy, routing, and DNS instead of repeatedly reinstalling the client and obscuring the real cause.
What order should you follow when troubleshooting node test timeouts?
First check whether ordinary web pages open directly, and verify the system date, time, and time zone. Then update the subscription and test other nodes in the same group. If only one node times out, check that node's status. If every node times out, check whether the client core has started, whether the local port is conflicting with another program, and whether the firewall is blocking the client process.
What should you do when the client says it is connected but webpages will not open?
Connected only means that the client has applied its local configuration or started the core; it does not guarantee that the target request succeeded. Switch to global mode first to rule out routing rules, then check whether the system proxy was actually applied, whether the browser is overriding it, and whether DNS can resolve the domain. Next, test a different node with a real connection and review the logs for connection refusals, timeouts, or resolution failures.
What should you do if a subscription update fails or returns empty content?
With the system network working normally, request the subscription again and check whether the URL has expired, been truncated, or contains extra characters. If the client supports using a proxy for updates, test both a direct update and an update through the current proxy. If the response is empty, do not overwrite the existing group immediately. Keep the old configuration and confirm the URL and response format with the subscription provider.
How do you troubleshoot DNS errors on some websites after connecting?
First determine whether all domains fail to resolve or only specific domains. Temporarily switching to global mode can show whether routing rules are responsible. Clear the system DNS cache and restart the browser to rule out stale records. If the problem occurs only in rule mode, check whether the domain rules, DNS query route, and remote-resolution settings use conflicting strategies.
next step
Still not resolved
Record the affected platform, client name, steps taken, and the first clear error in the logs, then continue with the relevant symptom chapter in the advanced troubleshooting manual. For subscription-related issues, keep the original group, copy the configuration before editing it, and preserve a path back to a working state.