For anyone setting up v2rayNG on Android for the first time, or troubleshooting disconnects when the screen is off or a specific app won’t use the proxy. First check that both Android’s VPN service and the client connection are working. Then adjust background restrictions as needed and test the app list with two apps—changing one setting at a time.
VPN access: Confirm Android is handling the connection
v2rayNG uses Android’s VpnService to create a local virtual network interface and handle traffic from selected apps. The system prompt grants permission to create this interface; it does not verify the remote connection. A VPN icon in the status bar means Android has an active VPN session, but it doesn’t confirm that the configured server is reachable or that every app is using the proxy.
Select a configuration
In v2rayNG, select the imported configuration you want to test. If you haven’t imported one yet, follow the Android quick start guide to prepare a configuration. There’s no need to keep refreshing your subscription to troubleshoot a permission prompt.
Allow the connection
Tap the start button in the bottom-right corner of the main screen. In Android’s “Connection request” dialog, check the app name and tap “OK.” If you’ve already granted permission, the dialog may not appear again; check the notification or Android’s VPN settings instead.
Check which VPN is active
On stock Android, go to “Settings” → “Network & internet” → “VPN” and check whether v2rayNG is connected. Settings paths vary by manufacturer, so try searching for “VPN” in Settings. If another VPN is running, check whether it can be disconnected. Don’t disable a work VPN your device requires.
Establish a baseline
Turn off “Per-app proxy” in v2rayNG’s settings, disconnect, then reconnect. Keep the screen on and stay on the same network. In a browser, open a site you normally access through the proxy. If it still fails, check the client logs and verify the server address, port, and transport settings before changing battery settings.
Battery optimization: Fix disconnects when the screen is off
Check background restrictions first if the connection works with the screen on but drops after the screen has been off for a while. Setting v2rayNG to “Unrestricted” can reduce Android’s limits on background activity, but won’t fix network changes, remote server timeouts, or Android revoking VPN access. This setting may increase standby battery use, so change it for v2rayNG only rather than disabling battery saver for the whole device.
- Find the app’s battery settings: On stock Android 14, go to “Settings” → “Apps” → “See all apps” → “v2rayNG” → “App battery usage,” then select “Unrestricted” if available. Some devices put this option under “Battery optimization.” Switch the list to “All apps,” then set v2rayNG to “Don’t optimize.”
- Check for manufacturer-specific restrictions: If battery optimization is disabled but the VPN notification still disappears after the screen locks, search Settings for “background activity” or “auto-start.” These options aren’t available on every device; change them only if your device has them and the symptoms point to a background restriction.
- Keep the test conditions consistent: Use the same configuration and network before and after each change, and retest with the same app. After unlocking, check the VPN icon and notification before making a new page request. A closed connection and a stopped VPN service are different problems.
These durations are convenient checkpoints, not fixed Android disconnect thresholds. If the VPN icon stays visible but requests fail only when switching from Wi-Fi to mobile data, test a fresh connection on each network. One failed network handoff alone doesn’t mean Android killed the app.
Per-app proxy: Choose bypass or proxy-only
In v2rayNG, go to “Settings” → “Per-app proxy,” enable the feature, and check “Bypass mode” and the selected apps. In the classic interface, with “Bypass mode” on, checked apps are excluded; with it off, checked apps are included. Some versions display the mode names directly. The key is to confirm whether each selected app is included in or excluded from the VPN.
Proxy-only: Include checked apps
RecommendedStart by selecting just one browser you use often, leaving other apps outside the VPN. Add apps one at a time as needed, so it’s easier to identify which change affects the connection.
Best for: A small number of apps need the VPN, or you’re testing per-app proxy for the first time.
Bypass: Exclude checked apps
Select apps that must connect directly over the current network as exceptions, such as an app for managing devices on your home network. Apps that aren’t checked remain covered by the VPN. Don’t carry over the same list unchanged when switching modes.
Best for: Most apps should use the VPN, with only a few confirmed exceptions.
The per-app list determines whether traffic enters the VPN. Once it does, Xray selects an outbound route according to the routing rules. Some destinations may still match a direct rule, even when traffic comes from an included app. So checking an app doesn’t mean all of its traffic will use the remote proxy.
- After changing the list, save your settings if there’s a save button, then disconnect and reconnect so the new list applies to the VPN interface.
- Choose two browsers for comparison: include one and exclude the other. On the same network, open the same destination and make a new request. Don’t rely on a cached page or an existing long-lived connection as a test.
- If the destination is reachable both directly and through the proxy, simply loading the page won’t tell you which route it took. Check outbound entries in the client logs, or use a trusted IP lookup site on the same network. If both routes use the same exit IP, matching results still don’t prove the app list is being ignored.
Common issues: Narrow down the cause by symptom
Why doesn’t tapping Start show a permission prompt?
Check Android’s “VPN” settings first. If v2rayNG is already connected, you usually don’t need to grant permission again. If another VPN is active and it’s a personal connection you can disable, disconnect it in its app, then return to v2rayNG and tap Start. If Android says the setting is controlled by an administrator, check with your device administrator.
Why does only one app fail when the VPN icon is visible?
Check which apps are included or excluded, then confirm which app is actually handling the request. Some links open in an external browser, and an app in a work profile is separate from the same app in your personal profile. Try entering the destination directly in the selected browser, then reconnect the VPN and make a new request to rule out redirects and stale connections.
Why does the connection still drop after setting the app to Unrestricted?
After unlocking, check whether the VPN is still active. If both the notification and VPN are gone, look for separate background-management settings from the device manufacturer. If the VPN is still active, refresh the page and note whether the network changed. Also test with the screen on over the same network to distinguish the app stopping in the background from a simple connection timeout.
Why can’t a bypassed app connect to the internet?
In Android’s “VPN” settings, check whether “Block connections without VPN” is enabled under “Always-on VPN.” When this block is on, apps excluded from the VPN may lose internet access instead of connecting directly. If the restriction is intentional or enforced by device policy, include the app in the VPN and troubleshoot within the permitted policy. Don’t treat disabling this protection as the default fix.