Shadowrocket background battery use: choosing On Demand connections
Review common causes of iPhone background battery use, compare always-on connections with On Demand triggers, and find a practical balance for Wi-Fi and cellular networks.
Verify the app · All platforms
A rules-based proxy client for all platforms with subscription import and rule-based routing. The iPhone / iPad version is a one-time $2.99 App Store purchase; Mac, Windows, Android, and Linux versions are free.
Current version v2.2.92 · Mac, Windows, Android, and Linux versions are free
View the getting started guide
Official guide · 2 ways to get the app
932747118When Shadowrocket appears in search results, open its product page and verify that the developer is Shadow Launch Technology Limited. Confirm that the icon matches the official icon on the left, and check that the product page URL ends in id932747118. Similar names and icons are not a substitute for checking the developer and App ID. System requirements are as listed on the App Store page; if you plan to use two devices, check compatibility for each one.
The App Store catalog varies by the country or region of the Apple Account used for purchases. The device's interface language and your current location do not determine its store region. If you cannot find the app, open the product page from the download guide and determine whether the message indicates unavailability, system incompatibility, or a page that did not load. Check the store region in the settings of the account used for purchases. If the page opens but the download does not start, check available storage and any download restrictions.
The iPhone / iPad version costs $2.99 as a one-time purchase in the US App Store; currency and price in other storefronts are shown on their local product pages. Mac, Windows, Android, and Linux versions are free. The same purchase can be used on an eligible iPhone and iPad with the same purchasing account. When switching devices or reinstalling, first confirm that you are using the original App Store account, then look for Shadowrocket in purchased items. If a price button appears, check the account and purchase history before deciding whether to proceed.
Shadowrocket is closed-source commercial software. A client purchase does not include a server plan: purchase history lets you download the app again, but does not restore servers, subscriptions, or configurations. Get subscriptions from your own service provider; this site does not provide, sell, or recommend servers or subscriptions. Before moving to a new device, make sure you have your own subscription or server details and any necessary configuration backups. After restoring the app, check your configuration, servers, and connection mode one by one.
Get iPhone and iPad updates through the App Store. For Mac, Windows, Android, and Linux, use this site's download guide to select your platform; installers are provided on this site under /dl/. Before updating, confirm the platform and architecture, then back up any rules and configuration you have edited. If connection problems occur after an update, first check whether the original configuration is still selected and the server is still available; there is no need to clear all settings immediately.
The server determines where you connect; Global Routing determines the path traffic takes; On Demand determines when a connection is made. Check these separately to avoid changing several settings while troubleshooting one issue.
In Home > Global Routing, select Config for the client to match traffic against the Rule order in the current configuration. Place entries for individual sites before broader entries to avoid matching an overly broad rule first. FINAL handles connections that did not match earlier rules. If only a particular website behaves unexpectedly, check the domain you actually accessed and the rule order before reviewing the fallback. Use Proxy and Direct for comparison tests, then switch back to Config.
See how to route traffic for specific websitesDOMAIN-SUFFIX,example.com,PROXYGEOIP,CN,DIRECTFINAL,PROXYOn Demand controls when to connect; it does not change how traffic is routed after a connection is established. First confirm that a manual connection works on the current network. Then open Settings > On Demand and set the triggers you need. Test Wi-Fi and cellular separately so a brief interruption during a network switch is not mistaken for a server failure. If the device reconnects unexpectedly, turn off On Demand, test the manual connection again, and then review the conditions you set.
On Demand settings and battery troubleshootingSettingsOn DemandHomeIn Add Server, choose Type first, then enter the address, port, and authentication details from your existing server information. Shadowsocks, VMess, VLESS, Trojan, Hysteria2, and WireGuard require different fields; matching addresses and ports do not mean protocols are interchangeable. If your parameters specify a transport or TLS, enter the original values rather than changing them to clear an error. Save and test this server first to avoid changing routing and configuration at the same time.
See the field differences between VMess and VLESSTypeHostPortGet subscriptions from your service provider. In Add Server, select Subscribe, paste the complete address, and save. Return to Home and check whether server entries appear under SERVER. A saved subscription does not mean its list has been retrieved. If the list is empty, check for extra spaces or a truncated link, then confirm the current network can reach the address. Note the server you are using before refreshing; if entries change, confirm the selected server and test it again.
View subscription import stepsAdd ServerSubscribeSERVERIn Config, check which file is currently selected and distinguish general settings, rules, and host mappings. Keep a copy of the original configuration before making changes; edit one group of rules at a time, then return to Home and confirm that Global Routing is set to Config. If iCloud sync is enabled, check on the other device that the file has appeared and is selected. App Store download history is not a configuration backup; before switching devices, make sure you can retrieve or import the files you need.
Choose a configuration and verify the resultGeneralRuleHostsIf you cannot connect, first use Connectivity Test in Home to check the current server, then open Diagnostics in Settings. To review usage, check traffic statistics in Data. A successful test only means that the test destination responded; it does not confirm that every website is working. When retesting, keep the server and destination unchanged and change only the network or mode. Note what you did and the error message; hide subscription addresses and authentication details before sharing.
Common questions about connections and routingConnectivity TestDiagnosticsDataThese steps use the iPhone and iPad interface. For your first connection, use a known working server and a familiar test website. Establish a repeatable test setup before adjusting rules or automatic connections.
Open Home and go to Add Server. If you have individual server details, enter the Type, Host, Port, and required authentication fields from those details. If you have a subscription, select Subscribe. Get subscriptions from your service provider; paste the complete address and do not share it publicly as if it were an ordinary webpage link.
After saving, return to Home and check SERVER for an available server. If there is a subscription entry but no server entry, refresh the subscription first. If the list contains entries, select the server you want to connect to before continuing.
Config uses the current configuration to decide which connections use a proxy, connect directly, or follow another specified policy. Proxy sends traffic handled by the client through the proxy; Direct provides a direct-connection comparison. To route traffic by website, select Config and first confirm in Config that the intended file is enabled.
To determine whether an issue comes from rules or the connection, keep the server unchanged and temporarily select Proxy to test the same website again. If it works only after changing modes, check the rule order and FINAL first rather than re-entering the server details.
Return to Home and turn on the connection switch. When establishing a VPN connection for the first time, the system may ask to add a VPN configuration. Confirm that the prompt corresponds to the Shadowrocket connection you just started, then follow the system instructions. Wait for the connection status to stabilize and use Connectivity Test to check the selected server.
Finally, visit the website you want to check. If the client shows that it is connected but the site still will not open, test other destinations on the same network first. If only one destination has a problem, check routing; if several fail, check the server details, current network, and system connection permission.
The iPhone / iPad version is a one-time $2.99 App Store purchase. Mac (Apple Silicon and Intel), Windows, Android, and Linux versions are free; installers are available on this site under /dl/. Each link below opens the platform guide, where you can choose the version for your device.
One-time App Store purchase: $2.99
Check App Store compatibility. To restore a purchase, use the original Apple Account.
Free · Apple Silicon / Intel
Check About This Mac for your chip or processor, then choose the matching installer.
Free
Check Settings → About for 64-bit compatibility. On managed devices, check your organization’s install policy.
Free
Check arm64 support. If the download fails in an in-app browser, try your regular browser.
Free · deb / rpm / AppImage
Match your CPU architecture and package manager. See the download guide for AppImage permissions.
Purchased items and server lists are managed separately. After restoring the client, check whether your configuration has synced and whether the correct file is selected. If the server list is still empty, re-import it from your saved server details or subscription. Do not buy the client again just to restore the list.
Connectivity Test checks its test destination, not every domain visited by your browser. Compare with other websites, then check whether the request uses a different domain and whether Global Routing is set to Config. If only one rule causes a problem, adjust the match order first and test again.
First confirm that the device can access the network. Then manually test again using the same server and mode. If manual connection works but automatic connection does not, check the On Demand conditions in Settings. Change one condition at a time and note the result on each network.
Choose an article for your issue: troubleshoot background battery use, write routing rules for specific websites, or interpret test results for an existing server.
Review common causes of iPhone background battery use, compare always-on connections with On Demand triggers, and find a practical balance for Wi-Fi and cellular networks.
Combine DOMAIN-SUFFIX, DOMAIN-KEYWORD, and FINAL,DIRECT for an allowlist configuration that sends selected websites through PROXY and connects directly to others, with notes on rule order and editing in Config.
Learn what Shadowrocket connectivity test results mean, how to compare servers in your existing subscription by region and protocol, and why low latency does not always mean faster page loading.