What should you do if v2rayNG won’t connect? This guide helps you distinguish between local network problems, inactive nodes, subscription import errors, and Android system restrictions. Troubleshoot in order, changing only one setting at a time and reconnecting after each change to avoid making things worse.
1. First, make sure your phone can access the internet
Disconnect v2rayNG, then use your browser to open a website you can normally access directly. If it still won’t open, check for Wi-Fi sign-in requirements, unpaid mobile data charges, or a router outage before changing nodes.
- On public Wi-Fi, check whether your system prompts you to sign in or authenticate, and complete that step before trying again.
- Switch between Wi-Fi and mobile data, and test the same node on each. If it fails on only one network, focus on that network’s restrictions or router settings.
- Temporarily disable other VPNs, accelerators, and filtering tools that use the VPN channel. Android generally cannot run multiple standard VPN connections at the same time.
- Set your phone’s date, time, and time zone to automatic to prevent time discrepancies from affecting TLS certificate validation.
If the basic network connection is down, switching nodes usually won’t help. If switching networks resolves the issue, you can use the working network for now; there’s no need to reinstall the client right away.
2. Check that the node and subscription are valid
Return to the v2rayNG main screen and make sure the configuration you want to use is selected—not just imported. If you use a subscription, update it from Subscription Management or the relevant menu, then return to the list and select a node again. Menu names may vary slightly between versions.
- Subscription update fails: Check that the address is complete and has no extra spaces, and see whether the provider has changed the link. Some subscriptions can only be updated through a working proxy.
- Manually imported link: Make sure you copied the entire link without any explanatory text. If the QR code is blurry, try importing by copying the link instead.
- One node fails: Test other configurations from the same subscription. If only one is unavailable, the node itself is more likely to be the problem.
Free nodes may stop working or be affected by the number of users. If you got your configuration from our free nodes page, check when it was last updated. A successful latency test does not guarantee that websites will open; verify by opening a page as well.
3. Connected, but webpages won’t open
Temporarily switch to the client’s global proxy mode, if available, to rule out routing rules. If global mode works but the original mode doesn’t, focus on routing rules and per-app proxy settings rather than assuming the node is down.
Next, check whether your browser is excluded from the proxy. If you manually configured Android’s “Private DNS,” temporarily restore it to Automatic and test again. Don’t change multiple DNS settings at once or enter unfamiliar addresses.
If the connection drops after a short time, go to system settings and relax battery optimization and background activity restrictions for v2rayNG. You should also allow the VPN connection request when prompted at startup. If Always-on VPN or “Block connections without VPN” is enabled, make sure it isn’t set to use a different app.
4. Use the logs to pinpoint the issue; don’t reinstall blindly
Open the client logs, clear the old entries, then reconnect and reproduce the problem once. A timeout should be assessed alongside the network and node status; a DNS resolution failure calls for checking DNS; and certificate errors are a reason to check the system time and configuration source first. Log messages are clues, not proof of the cause on their own.
When asking for help, don’t share your full subscription link, UUID, or other credentials publicly. Provide the client version, network type, symptoms, and a redacted error message. If the problem persists, update to a compatible version from the project’s official release channel. Back up your configuration before reinstalling to avoid losing your subscription.