This article addresses the common question, “What should I do if v2rayNG won’t connect?” It walks you through troubleshooting your phone’s network, system time, node subscriptions, proxy mode, and client logs in order. It’s suitable for everyday users to follow and doesn’t cover setting up a server.
1. First, check that your network environment is working properly
Many connection failures aren’t caused by the node itself, but by an unstable network environment on your phone. Run through these basic checks before switching nodes or reinstalling the client.
- Switch networks: Toggle between Wi-Fi and mobile data, and turn Airplane mode off and back on.
- Turn off other proxies: If you’re also using another VPN, accelerator, or packet capture tool, quit them all first.
- Check the system time: Set your phone’s time and time zone to automatic; otherwise, TLS verification may fail.
- Check network permissions: In system settings, allow v2rayNG to use WLAN and mobile data.
- Avoid restricted networks: Company, school, and hotel Wi-Fi may restrict proxy connections. Try using mobile data first.
If the connection works on mobile data, the original Wi-Fi network may be blocking it. If it fails on every network, continue checking your configuration.
2. Check your nodes, subscription, and import method
Open v2rayNG and check that the currently selected node is working. Free nodes can become unavailable or congested, so we recommend regularly updating the subscription for the free nodes provided on this site rather than continuing to use an old link.
- On the v2rayNG home screen, tap the menu in the upper-right corner and select “Update subscription.”
- After updating, switch between nodes in different regions or using different protocols, and test each one.
- Long-press a node and select “Test current service connectivity” or a similar test option.
- If you imported a node manually, check that the link is complete. In particular, make sure vmess, vless, and trojan links aren’t missing any characters.
If you see a parsing error, the subscription address was likely copied incorrectly, the QR code is incomplete, or the link has expired. Copy the subscription address again, or delete the old configuration and import it again.
3. Check your v2rayNG client settings
If you can connect but can’t open web pages, the issue may be with the proxy mode. Open v2rayNG settings and check these items in particular:
- Routing mode: If you’re new to v2rayNG, try “Bypass LAN and mainland China addresses” or use the default rules.
- Local DNS: If pages keep loading without opening, try enabling or changing the DNS settings.
- VPN permission: The first time you connect, the system will prompt you to authorize the VPN. You must tap Allow.
- Battery restrictions: Exempt v2rayNG from battery optimization to prevent it from being closed in the background.
When troubleshooting, avoid changing several options at once. Disconnect and reconnect after each change so you can tell which one fixed the problem.
4. Use the logs to identify common errors
Open the menu in the upper-right corner of v2rayNG and go to the logs to quickly identify the type of problem. If you see “timeout” or “connection refused,” the node is probably unavailable or the network is blocking the connection. Messages containing “certificate,” “TLS,” or “handshake” may point to an issue with the system time, SNI, transport settings, or node configuration. If there are no logs at all, first check the VPN and system network permissions.
A practical troubleshooting sequence is: switch networks, update the subscription, try a different node, and then check the logs. Don’t reinstall the app as your first step—reinstalling won’t fix an incorrect configuration or an unavailable node. If multiple nodes fail on multiple networks, update v2rayNG to the latest version and import the subscription again.
5. Quick recovery steps
If you just want to get connected again as quickly as possible, follow these steps in order: close other VPNs, correct the system time, update the subscription, select a new node, then tap Connect and authorize the VPN. If it still fails, test the connection on mobile data. This checklist can help you pinpoint most causes of “v2rayNG won’t connect.” Finally, keep in mind that free nodes may vary in reliability. We recommend keeping several working subscriptions or node sources on hand so you can switch quickly if one stops working.