This guide addresses the common question, “What should I do if v2rayNG won’t connect?” It’s suitable for beginners to follow step by step: check your phone’s network, node details, client settings, and system permissions to determine whether the issue is with your local network, an unavailable node, or an incorrectly imported configuration.
1. First, check whether the problem is your network
In many cases, v2rayNG won’t connect because of network restrictions, DNS issues, or a proxy that isn’t active—not because the app is broken. Start with these checks:
- Close v2rayNG and open a browser to visit a domestic website. Make sure your phone can access the internet normally.
- Switch between Wi-Fi and mobile data to test the connection. Some campus, office, and hotel networks may restrict proxy connections.
- Turn on Airplane mode for 10 seconds, then turn it off so your phone can reconnect to the network.
- If you’re using Wi-Fi, restart your router or temporarily switch to mobile data to test.
If switching networks resolves the issue, the original network is likely restricting the connection. Try changing the node protocol or port, or using another available connection.
2. Check whether the node is unavailable or was imported incorrectly
The most common reason v2rayNG won’t connect is that the node is unavailable. Free nodes may stop working, especially when they’re overloaded or their routes change. You can get free nodes from our site and import them again to test, but don’t rely on a single node.
- Open v2rayNG, long-press the current node, and select “Test connection” or “Test latency.”
- If the test times out or fails, try another node.
- Check whether your subscription has expired: open the menu in the upper-right corner and update the subscription.
- If you copied the node manually, make sure you copied the entire link without missing any characters, especially the complete content beginning with vmess, vless, or trojan.
A failed connection test for one node doesn’t mean the app won’t work. We recommend testing at least three nodes from reliable sources.
3. Check your v2rayNG client settings
If the node is working but you still can’t access anything, check the client settings. Open v2rayNG and make sure the switch in the lower-right corner is on. A VPN icon should appear in the Android status bar. If it doesn’t, the proxy hasn’t been activated.
- Go to “Settings” and leave “Routing” on the default rules for now. Beginners should avoid changing it without a reason.
- Temporarily turn off “Proxy only selected apps” to make sure the target app isn’t being excluded.
- If per-app proxying is enabled, make sure your browser or other app is included in the proxy list.
- When prompted for VPN permission, tap Allow.
Don’t run multiple VPN or proxy apps at the same time. Running another accelerator, Clash, or sing-box simultaneously can cause port conflicts or routing issues.
4. How to interpret common errors
If the logs show timeout, connection refused, or failed to dial, the issue is usually related to the node, port, or network restrictions. Messages such as invalid or decode failed are more likely to indicate a malformed link or a problem with the subscription content. You can check the brief details on the v2rayNG logs page. You don’t need to understand every message, but they can help you identify the likely cause.
Recommended troubleshooting order: switch networks first, then try another node, and finally check the settings. If the same group of nodes fails on different networks, the nodes are likely unavailable. If the same node works on mobile data but not Wi-Fi, focus on troubleshooting the Wi-Fi network.
5. What to do if it still won’t connect
Try updating v2rayNG to the latest version. Older versions may not support some newer protocols or parameters. After updating, import the subscription again rather than repeatedly changing the old configuration. If you’re using a subscription link, open it in a browser first to confirm it’s accessible. If the subscription itself won’t open, the client won’t be able to update the nodes either.
Finally, keep in mind that tools for bypassing network restrictions are heavily affected by network conditions, and free nodes may be unreliable. Follow the steps in this guide to pinpoint the cause. Avoid changing advanced settings at random. For beginners, keeping the default settings often makes it easier to connect successfully.