This guide addresses the common question, “What should I do if v2rayNG won’t connect?” It walks you through troubleshooting your mobile network, node configuration, subscription updates, system permissions, and log messages to help you quickly determine whether the issue is your local network, an inactive node, or an incorrect client setting.
1. First, check that your network is working
Many connection failures aren’t caused by v2rayNG itself, but by an unstable network. Before troubleshooting, close v2rayNG and open a browser to visit a domestic website to make sure your phone can access the internet. If you can’t open domestic websites either, first troubleshoot your Wi-Fi, mobile data, router, or carrier network.
- Switch networks: change from Wi-Fi to mobile data, or from mobile data to Wi-Fi.
- Turn Airplane mode off and on again to reconnect to the network.
- If you’re using public Wi-Fi, it may have restrictions. Try using a personal hotspot instead.
- Check that your phone’s clock is correct. An incorrect time can cause TLS connection issues.
If switching networks fixes the connection, your original network may be blocking or restricting access, or have a DNS issue. The node itself may be fine.
2. Check whether the node is working
The most common reasons v2rayNG won’t connect are an expired or blocked node, incorrect configuration, or an outdated subscription. If you’re new to this, don’t keep changing settings at random. Start with these simple checks.
- In the v2rayNG node list, long-press a node and select Test real connection or Test latency.
- If all your nodes time out, suspect your current network or an inactive subscription.
- If only one node fails, switch to another.
- If you copied and imported a free node from this site, copy the entire link again to make sure no characters were missed.
Note: A successful latency test doesn’t guarantee you can access every website. However, if the real connection test keeps failing, the node is usually unavailable or the network can’t reach it.
3. Check your subscription import and update
When using a subscription link, many problems are caused by an outdated subscription. In v2rayNG, tap the menu in the upper-right corner and find the subscription settings. Check that the subscription URL has no extra spaces and that you haven’t copied the wrong line. Then return to the main screen and update the subscription.
If the download fails, try opening the subscription link in a browser. If it opens there but the update fails in v2rayNG, the issue may be related to the app’s permissions, network DNS, or leftover system proxy settings. If it won’t open in the browser either, the subscription URL may be inaccessible or expired.
Once the import succeeds, select a node and tap the circular button in the lower-right corner to connect. The first time you connect, the system will ask for VPN permission. You must tap Allow to establish the local VPN tunnel.
4. Check the logs to identify the cause
If the connection still fails, check the v2rayNG logs. You don’t need to understand everything—just look for a few keywords. “timeout” usually means a network timeout or an unreachable node. “refused” may indicate that the port or service is unavailable. “TLS” or “certificate” may point to an issue with the time, SNI, or certificate. If you see “DNS,” try switching networks or changing your DNS settings.
Follow this order when troubleshooting: switch networks, switch nodes, update the subscription, and then check the logs. Don’t start by changing advanced settings such as the transport protocol, TLS, or path. Subscription nodes usually include the correct configuration, and changing it incorrectly can cause connection failures.
5. What to do if you still can’t connect
If you’ve confirmed that your phone can access the internet, VPN permission is enabled, the subscription is up to date, and none of your nodes connect, try restarting your phone or reinstalling the latest version of v2rayNG. Remember to back up any working subscriptions before reinstalling.
Summary: If you’re new to v2rayNG and it won’t connect, first check that your network is working, your node is active, your subscription is up to date, and the app has the necessary permissions. Follow these steps in order to pinpoint most issues. Free nodes can be unreliable, so it’s a good idea to keep several on hand. If one fails, don’t keep retrying the same node.