This article addresses the question “What should I do if v2rayNG won’t connect?” Follow this checklist to check your phone’s network, system permissions, node subscription, time settings, and error logs one by one. It’s designed to help everyday Android users quickly identify the cause and restore their connection.
1. Check these basics before connecting
Many connection failures aren’t caused by a faulty client; they happen because the current network or phone environment isn’t suitable. Before opening v2rayNG, run through these basic checks:
- Make sure your phone’s internet connection works: Close v2rayNG and use your browser to visit a domestic website. If that doesn’t load either, switch between Wi-Fi and mobile data or restart your router.
- Check your system time: Open “Date and time” in your phone settings and turn on “Set time automatically.” A significant time mismatch can cause the TLS handshake to fail.
- Close other VPN or proxy apps: Use only one VPN connection at a time to prevent apps such as Clash, sing-box, or accelerators from occupying the VPN permission.
- Make sure v2rayNG has VPN permission: The first time you connect, the system will prompt you to allow the connection. You must tap “OK.” If you previously denied permission, clear the app’s default permissions in system settings and try again.
- Try a different network: Some Wi-Fi networks restrict proxy connections. Test with mobile data to determine whether the issue is with the node or the network.
2. Check that your node and subscription are valid
If everything else checks out, focus on the node. v2rayNG supports protocols such as vmess, vless, trojan, and shadowsocks. An incorrectly formatted import or an expired subscription can prevent a connection.
- Long-press the current node and select “Edit.” Check that the address, port, UUID, transport protocol, TLS, SNI, and other fields aren’t blank or obviously incorrect.
- If you’re using a subscription link, tap the menu in the upper-right corner and select “Update subscription.” Then select a node again and connect.
- If you copied a node from this site’s free nodes page, copy the entire link without manually removing or changing any characters. If importing from a QR code fails, try importing from the clipboard instead.
- Try several nodes from the same subscription. One unavailable node doesn’t mean there’s a problem with the client.
A common scenario is that a node imports successfully but won’t connect. This usually means the configuration format was recognized, but the node itself is unavailable, blocked by the network, or using transport settings that don’t match the server.
3. Use the logs to identify common errors
Tap “Log” at the bottom of the v2rayNG screen or in the menu, connect once, and check the last few lines. This is more effective than reinstalling the app blindly.
If you see “timeout” or “i/o timeout,” the node is probably unreachable or the current network is blocking it. Try a different network or node. Messages containing “handshake failure” or “certificate” are usually related to TLS, SNI, or the system time. If you see “authentication failed” or “invalid user,” the UUID, password, alterId, encryption method, or other parameters may be incorrect. Reimport the node.
4. Recommended troubleshooting order
- Close v2rayNG and make sure your regular internet connection works.
- Turn on automatic time and close other VPN apps.
- Update the subscription or reimport the node.
- Test using Wi-Fi and mobile data.
- Check the log keywords to determine whether the issue is a timeout, an authentication failure, or a TLS problem.
- If it still doesn’t work, uninstall the old version of v2rayNG, install the latest version, and reimport your configuration.
In short, if v2rayNG won’t connect, don’t start by changing a bunch of settings. First check your phone’s network and VPN permissions, then update the subscription and try another node. Finally, use the logs to pinpoint the issue. Following this practical checklist will help you quickly identify the cause of most connection failures.