This guide applies to iPhone and iPad. If you use Shadowrocket only occasionally, start with On Demand off and disconnect from Home when you’re finished. Turn it on only if you need the system to connect automatically under specific network conditions, and check which conditions trigger it. To decide whether to leave it on, compare battery levels and connection behavior on the same device and similar networks. Don’t rely on the app’s battery-use percentage alone.
1. Check Battery: Usage Percentage Isn’t Battery Drain
Open Settings → Battery and check the charge graph, screen activity, and app usage during the period when the battery drained. If you can select a time range, choose the period with the steepest drop. If the system only shows daily totals, note the starting and ending battery levels yourself. Check whether Shadowrocket was active in the background, and look for other activity during that time, such as video playback, syncing, or system updates.
For example, if the battery drops from 80% to 76%, the device’s battery level fell by 4 percentage points. If Shadowrocket accounts for 25% of app usage over that same period, that’s its share of usage—not a 25-point drop in battery level caused by the app. This example simply distinguishes the two readings; it isn’t a benchmark for battery drain. An app can account for a large share during a period when overall usage is low, and background activity time alone can’t be converted into battery consumption.
Takeaway: Retest the period with the battery drop
If Shadowrocket’s usage percentage is high but the device’s battery level barely changes, leave settings as they are for now. Retest periods when both battery drain and background activity increase.
2. Understand On Demand, Connection Status, and Routing
On Demand lets the system start a VPN connection automatically when configured conditions are met; it isn’t an idle timer. Locking the screen or leaving Shadowrocket doesn’t disconnect the VPN, and turning on On Demand doesn’t tear down the tunnel after each request. Conversely, don’t use On Demand off as a disconnect switch. After changing it, check the connection in Home and use the connection toggle if you need to disconnect.
- Settings → On Demand: Check whether the system is allowed to connect under the configured conditions. Before comparing Wi-Fi and cellular, confirm whether the current configuration applies different conditions to each network type.
- Home → connection toggle: Check and control the active connection. If it reconnects after you disconnect manually, first check whether the current network still meets the On Demand conditions before treating it as a connection fault.
- Home → Global Routing: This controls how traffic is handled. For example, with Config selected, traffic follows the rules in the current configuration; a DIRECT rule match doesn’t mean the system VPN is disconnected. Keep the routing selection unchanged while troubleshooting battery drain.
When the network changes, existing connections may drop, and background requests may resume once the new network is available. Seeing the VPN reconnect doesn’t by itself prove that an app triggered it or that the connection was continuously idle. First determine whether it reconnects repeatedly on the same network or only reconnects after leaving Wi-Fi or regaining coverage.
3. Run Three Comparisons to Separate Background Drain from Automatic Reconnects
Start with three tests on stable Wi-Fi; 60 minutes is a reasonable starting point for each. Use similar starting battery levels and screen-lock times. Don’t charge the device, and keep the same configuration, connection profile, and Global Routing setting. Check connection status only once at the start and once at the end of each test to avoid repeatedly waking the screen. If you need to investigate cellular, repeat the tests separately on a device that supports it. Don’t compare results across the two network types by simply subtracting them.
Test the disconnected baseline
In Settings → Battery, note the starting battery level and time. In Shadowrocket, turn off On Demand in Settings → On Demand, then disconnect from Home. Confirm the status, lock the screen, and check the ending battery level at the agreed time.
Test a manual, always-on connection
Leave Settings → On Demand off and turn on the connection manually from Home. Once connected, run another test under the same conditions. If you find it disconnected at the end, mark the test as interrupted; don’t count it as a complete always-on sample.
Test On Demand
Go to Settings → On Demand, turn it on, and check whether the current network meets its conditions. Wait for it to connect as it would during normal use. If you need to make a network request to check, use the same page you normally access and note when you do it and the connection status in Home.
Check network switching
Run a separate short test: in a place with cellular coverage, leave Wi-Fi and then reconnect to Wi-Fi. Check the connection before and after each switch. Record whether it briefly drops and recovers or keeps reconnecting after the network is stable. Keep this test separate from the idle comparisons.
If the connection stays up in both the manual and On Demand tests and battery use is similar, there’s no evidence that switching On Demand will save a specific amount of power. If repeated connections happen only in the On Demand test when switching networks, reproduce that switching sequence first. If the disconnected baseline also drains quickly, check screen activity, other apps, and signal strength during the same period. If the results differ by just one percentage point, extend the test or repeat it under similar conditions rather than drawing a conclusion from one reading.
4. Choose On Demand Settings for Wi-Fi, Cellular, and Your Usage
| Scenario | Suggested setting | What to check |
|---|---|---|
| Fixed Wi-Fi, occasional use | Turn off On Demand. Connect from Home when needed, then disconnect manually when you’re done. | Before leaving the app, confirm that the connection is actually disconnected. Returning to the Home Screen alone doesn’t disconnect it. |
| Fixed Wi-Fi, extended use | If you need a connection throughout a work session, you can keep it connected manually. If you need it to reconnect automatically after a drop, try On Demand with your actual network conditions. | Compare connection behavior before and after locking the screen, and check whether it connects automatically during periods when you don’t need it. |
| Frequent network changes or weak signal during your commute | If you don’t need automatic reconnection after switching networks, start by testing with On Demand off. If you do need it, test the conditions for the networks you actually use. | Record what happens when switching from Wi-Fi to cellular and back. Don’t treat a brief interruption during the switch as an ongoing fault. |
| Not in use overnight, but the battery is low in the morning | For one night, test with On Demand off and disconnected from Home. Keep your usual Wi-Fi and cellular settings. | The next day, check the overnight battery graph and background activity. Don’t also turn on Airplane Mode, or you won’t be able to distinguish the effects of wireless network changes from connection settings. |
There’s no need to test cellular switching on a Wi-Fi-only iPad. If the device is managed by your organization and its connection is controlled by a management policy, record what happens and ask your device administrator to check it. Don’t remove the management configuration to save battery. On a personal device, if an app or service needs an automatic connection, first confirm that it reconnects after a network change, then compare battery use.
5. Troubleshoot Disconnects, Timeouts, and Automatic Reconnects
The following are the original English text of network errors from Apple’s system. They may appear when a request fails; the language and location of the message depend on the app that made the request. The text describes what happened to the request. It isn’t a battery reading and can’t, on its own, identify whether the cause is Shadowrocket, the current network, or the destination service.
Error: The Internet connection appears to be offline.
Cause: The system marked the request as offline (NSURLErrorDomain, -1009). A network switch may include a brief period without an available connection.
What to do: Wait until the network is stable, then try again. If the error persists and direct access is allowed, temporarily turn off On Demand and disconnect from Home. Then check whether basic connectivity works by opening a familiar page that’s accessible directly.
Error: The request timed out.
Cause: The request didn’t complete before the timeout (NSURLErrorDomain, -1001). A timeout alone doesn’t identify where the problem occurred.
What to do: Stay on the same stable network and test the same page with the connection on and off. If it repeatedly times out only when connected, note the time, network type, and how often it happens, then check the connection profile you’re already using.
If there’s no error but the VPN comes back shortly after you disconnect manually, first check Settings → On Demand, then return to Home and confirm it’s disconnected. If it stops reconnecting when On Demand is off, check the On Demand conditions first. If it still connects, check the device’s VPN settings to see whether the active configuration belongs to Shadowrocket. Don’t change the connection profile, routing mode, and On Demand settings all at once; even if the issue disappears, you won’t know which change fixed it.