FAQ / CLIENT CHECKLIST
V2Ray FAQ and Client Troubleshooting Steps
Organized into fundamentals, installation and setup, practical usage, and troubleshooting. When something fails, identify the stage first, then check the network, client, node parameters, and system settings in order. Avoid changing multiple settings at once.
Record the error, platform, and triggering action.
Determine whether the issue is with the network, node, or client.
Change one setting per test and retest.
BASICS
Fundamentals
Understand the relationship between the ecosystem, core, client, subscription, and node before installing or changing parameters.
5 QUESTIONSWhat are V2Ray, v2rayN, and v2rayNG?
V2Ray generally refers to the Project V ecosystem of protocols, cores, and tools rather than a single graphical client. v2rayN is a desktop client for Windows, macOS, and Linux, while v2rayNG is an Android client. Both manage subscriptions, nodes, routing, and system proxy settings, then use the corresponding core to handle connections.
Which client should I use on desktop or Android?
Use v2rayN on Windows, macOS, and Linux, and v2rayNG on Android. If an Android setup specifically depends on the v2fly core, v2flyNG is also an option. Do not mix installers or platform-specific configuration files between clients.
What is the difference between the Xray core and the v2fly core?
Both come from the Project V ecosystem, but their support coverage and feature development are not identical. Xray is commonly used with v2rayN and v2rayNG, while the v2fly core pairs with v2flyNG. Choose based on the node protocol, transport parameters, and the client’s actual support.
How should I choose between VMess, VLESS, Trojan, and Shadowsocks?
Choose a protocol already provided by the server and explicitly supported by the client core; changing only the protocol name is not enough. VLESS usually requires matching TLS, REALITY, or other transport settings. VMess depends on the correct user ID, Trojan requires careful password and TLS domain checks, and Shadowsocks requires the right cipher and password.
How are subscriptions, nodes, and configuration files related?
A subscription URL fetches and updates nodes in bulk. A node contains the server address, port, protocol, and transport parameters, while a configuration file may also include routing, DNS, and inbound settings. Updating a subscription usually replaces nodes in its group but may not change global routing or interface settings.
INSTALLATION
Installation and Setup
Package architecture, subscription entry points, and client versions must match the device platform. After importing a configuration, run one update to verify it.
5 QUESTIONSWhat should I do if no nodes appear after importing a subscription link?
Make sure you used subscription management rather than single-node import, then check that the link is complete and contains no leading or trailing spaces or line breaks. Run a manual subscription update and review the log. If the response is empty or its format is unrecognized, ask the subscription provider to confirm the URL status and output format.
What should I check first when a v2rayN subscription update fails?
First, open the subscription URL in a browser to confirm it is reachable, then verify the system date, time, and time zone. Check v2rayN’s subscription group URL, update proxy settings, and HTTP status in the log. If the old URL has expired, replace it instead of repeatedly refreshing the same entry.
How do I choose between arm64 and universal Android packages?
Most mainstream Android phones released after 2015 can use arm64, which is usually a smaller package. Choose universal if the processor architecture is unknown, the device is older, or arm64 installation fails. One working, updatable source for the client is enough.
What is the difference between the v2rayN desktop edition and the classic WPF edition?
The desktop edition uses a newer cross-platform interface and suits users who want a consistent workflow across desktop systems. The classic WPF edition targets Windows, with interface layouts and settings paths closer to established Windows habits. If your current setup is stable, there is no need to switch versions just for interface differences.
How can I tell whether to download the Apple Silicon or Intel version on macOS?
Open System Information or About This Mac. Choose Apple Silicon when the chip field shows an Apple M-series processor, and choose Intel when the processor field says Intel. A mismatched package architecture may prevent startup or require an additional compatibility layer, so confirm the chip type first.
USAGE
Usage Tips
A connected status only means the client has started handling the connection. You must also check the system proxy, TUN, routing rules, and the application’s own settings.
5 QUESTIONSWhat should I do when the client says it is connected but webpages will not open?
Check in order whether the selected node works, whether the system proxy or TUN is actually enabled, and whether the browser has its own proxy settings. Test with a simpler routing mode, then check the log to distinguish DNS resolution failure, connection timeout, and TLS errors. Avoid changing several parameters at once.
Why can the browser connect while terminal traffic ignores the system proxy?
Browsers usually read the system proxy, but many terminal programs do not. Set the HTTP_PROXY, HTTPS_PROXY, or ALL_PROXY environment variable for the current terminal and make sure its port matches the client’s local inbound port. You can also use TUN mode to capture the required traffic.
How do I fix insufficient permissions when enabling TUN mode?
TUN creates a virtual network interface and changes system routes, so it usually requires administrator privileges or system VPN authorization. On desktop, follow the system prompt to elevate permissions; on Android, approve the VpnService request. If it still fails, close other networking tools using virtual interfaces and try again.
How should I use global, rule, and direct modes?
Global mode sends all matching traffic through the proxy outbound and is useful for temporarily verifying a node. Rule mode selects an outbound based on domain, IP, or process rules and is best for daily use. Direct mode helps rule out effects caused by client traffic interception. During troubleshooting, verify the link in global mode first, then return to rule mode and check rule order.
How should I interpret V2Ray node speed-test results?
A latency test measures only the response time of a probe; it does not represent download speed or sustained stability. Compare nodes on the same network, at roughly the same time, and with the same test method. Consider connection success rate, webpage loading, and sustained transfers instead of ranking nodes by a single latency result.
DIAGNOSIS
Troubleshooting
Preserve the error state and logs first, then check connectivity, time, domains, ports, DNS, and system permissions layer by layer.
5 QUESTIONSWhat is the right order for troubleshooting a node connection timeout?
Confirm that the device itself can access the network, then try other nodes in the same subscription to determine whether the issue affects one node or the whole route. Check the server address, port, protocol, transport, and security-layer parameters, and make sure the local firewall, router, or network environment is not blocking the connection.
How should I handle a failed TLS handshake or certificate error?
Correct the device date, time, and time zone first, then verify that serverName or SNI matches the certificate domain. Also confirm that the node address, TLS setting, transport layer, and fingerprint parameters come from the same configuration. Disabling certificate verification is not a long-term fix.
What should I do after a connection reports DNS resolution failure?
Determine whether every domain fails or only specific domains, and test whether direct access by IP works. Then check the client DNS settings, how routing rules handle DNS requests, the system cache, and local port conflicts. After making changes, restart the client, clear the system DNS cache, and test again.
Why does the Android client disconnect frequently in the background?
Add v2rayNG or v2flyNG to the system’s battery-saver exemption list and allow background operation and required network activity. Some systems restrict VpnService after the screen locks, so also check auto-start, background activity, and battery-optimization settings. Reconnect and test again with the screen locked.
How can I diagnose client startup failures or frequent crashes?
Record what you did immediately before the issue occurred and inspect the final error in the client log. Confirm that the package architecture matches the system, the configuration parses correctly, and sufficient disk space is available. Temporarily remove recently added settings or rules; if the old configuration starts, restore items one by one to identify the cause.