This article addresses the common question “What should I do if v2rayNG won’t connect?” and offers a step-by-step troubleshooting guide for beginners. Check your phone’s network, node details, subscription updates, client settings, and system permissions to determine whether the issue is with your local environment or an unavailable node.
1. First determine whether the issue is with your network or the node
If v2rayNG keeps spinning after you tap Connect, times out, or connects but won’t open web pages, don’t rush to reinstall it. Start with these basic checks:
- Close v2rayNG and use your phone’s browser to visit a domestic website to confirm that your internet connection is working.
- Switch between Wi-Fi and mobile data to rule out restrictions on your current network.
- If it only fails on your company, school, or public Wi-Fi, that network may have stricter restrictions.
- Try another node. If other nodes work, the original node may be unavailable or congested.
The free nodes provided on this site can be used for temporary testing, but their availability may fluctuate. We recommend keeping several backup nodes available.
2. Check your v2rayNG node configuration
Many connection failures aren’t caused by a faulty app, but by incomplete node information. Check that the address, port, user ID, transport protocol, TLS, SNI, path, and other details match the subscription source. Beginners should avoid changing parameters manually unless they understand what they do.
- Open v2rayNG and long-press the current node.
- Select “Edit server configuration.”
- Check that the protocol is the correct type, such as VLESS, VMess, or Trojan.
- Make sure transport settings haven’t been changed by mistake, such as the WebSocket path or TLS toggle.
- Save your changes and try connecting again.
If you imported nodes from a subscription, try updating the subscription first rather than changing settings one by one. This helps avoid making things more confusing.
3. What to do if subscription import fails or all nodes show red
If no nodes appear after importing a subscription, or all latency tests fail, try the following:
- Check that the subscription link is complete and that you haven’t copied extra spaces or left out any characters.
- Open the subscription link in a browser to see whether it returns content properly.
- In v2rayNG, open the subscription settings, paste the link again, and update it.
- Check that your phone’s time is correct. An incorrect time can cause TLS handshake failures.
- Switch networks and try updating the subscription again. Some networks may not be able to access the subscription address.
If every node in the same subscription is unavailable, the subscription source may be temporarily down. If only a few nodes are unavailable, try connecting to another node instead.
4. Check your phone’s system settings and v2rayNG permissions
On Android phones, battery-saving settings, VPN permissions, or security software may interfere with the connection. Make sure you allowed v2rayNG to create a VPN connection when prompted the first time you connected. If no prompt appears when you tap Connect, reset the VPN permissions in your system settings or reinstall the client.
We also recommend disabling battery optimization for v2rayNG to prevent the system from closing it in the background. Some devices from Chinese manufacturers may also require you to allow background activity, auto-start, and network access. When the connection is successful, a VPN icon should usually appear at the top of the screen. If it doesn’t, the proxy tunnel may not have been established.
5. How to resolve common errors
- timeout: Usually means the node is unreachable, the network is restricting the connection, or the port is blocked. Try another network and node first.
- TLS handshake failed: Check your phone’s time and the TLS/SNI settings, and make sure the node hasn’t expired.
- connection refused: The server port isn’t responding. Switching to another node is usually the quickest fix.
- Connected but web pages won’t open: Check the routing mode. You can try switching to “Bypass LAN and mainland addresses.”
6. Recommended troubleshooting order for beginners
- Make sure your phone can access the internet normally.
- Test by switching between Wi-Fi and mobile data.
- Update the subscription and try another node.
- Check your system time and VPN permissions.
- Avoid changing protocol settings at random. If necessary, delete the node and import it again.
In short, if v2rayNG won’t connect, check the network first, then the node, and finally the client’s permissions and configuration. Following these steps can usually help you quickly identify the cause and avoid reinstalling the app or repeatedly changing settings without a clear reason.