Official Shadowrocket Manual
Shadowrocket Troubleshooting
Find troubleshooting steps by where the issue occurs: App Store and purchases, first launch, subscription import, or connections and rules.
App Store & purchases
Can I install it on iPad? Do I need to buy it separately for iPhone and iPad?
Yes. The same purchase can be used on eligible iPhone and iPad devices signed in to the purchasing account; check the App Store listing for system requirements. In the US App Store, Shadowrocket for iPhone and iPad costs $2.99 as a one-time purchase; check the store listing for current details. The Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free. A one-time app purchase is not a service subscription. To connect, use your existing subscription or server details; this manual does not provide those services.
Can’t find Shadowrocket in the App Store? What should I check first?
First, check the country or region of your current App Store. On your iPhone or iPad, open Settings, tap your name, then Media & Purchases, View Account, and Country/Region. Your device’s language and region settings do not determine the App Store catalog, and opening the US product page does not change the store region for your signed-in account. If you need to change regions because you have moved, follow Apple’s instructions on the same account page and resolve any outstanding balance or active subscriptions first.
How do I restore my purchase after changing devices or reinstalling?
First, make sure Media & Purchases in the App Store is signed in with the account used for the original purchase. Open the App Store, tap your profile picture, and find Shadowrocket in your purchase history. If you see the cloud download icon, you can download it again without paying again. If the page still shows a purchase button, check the signed-in account, purchase history, and current store region before trying to buy again. Restoring a purchase restores access to download the app; it does not restore server details or configuration from your previous device.
How can I verify the App Store product listing?
Check three details on the product page: the developer is Shadow Launch Technology Limited; the icon is a rocket with a white background and blue-purple outline, matching the official icon in this site’s header; and the page URL ends in id932747118, the app’s ID. Search results may include similarly named apps, so don’t rely on the name or icon alone. After checking all three details, use the information shown on the current store page.
Installation & first launch
Can I use Shadowrocket on computers and Android?
Yes. The Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free, with installers available from this site’s /dl/ download paths. Shadowrocket for iPhone and iPad costs $2.99 as a one-time purchase in the US App Store; check the store listing for current details. Choose the platform for your device, then check its processor architecture or package format. If you see a system prompt during installation, address the prompt for that specific file and leave system-wide protections enabled.
Which Mac version should I choose: Apple silicon or Intel?
Open the Apple menu and choose About This Mac. If you see Chip and an Apple silicon model, choose the Apple silicon version. If you see Processor and an Intel model, choose the Intel version. Both installers are DMG files, so the extension won’t tell them apart; don’t guess based on the year you bought your Mac. If macOS says the app isn’t compatible with this Mac, check the architecture again. An architecture mismatch is not a security warning, and overriding the warning won’t fix it.
Windows or Mac says the app can’t be verified. What should I do?
First, confirm you downloaded the file from this site’s download link for the correct platform and that the system has not reported malware. On Windows, if you see only a SmartScreen reputation warning, select More info, verify the file, then choose Run anyway. On Mac, if the only message says the developer can’t be verified, try opening the app, then check System Settings > Privacy & Security for an Open Anyway option. If the system reports a damaged file or a threat, or device policies prevent you from continuing, stop. Do not disable system-wide protections.
Can’t turn on the connection switch in Home on iPhone or iPad?
The first time you turn on the connection, the system may ask permission to add a VPN configuration. Confirm the request is from Shadowrocket, then follow the system prompts. If you previously denied it, return to Home and try turning the connection on again to bring up the prompt. If no prompt appears, check that you’ve selected a server, then see whether another connection is active in the system’s VPN settings. If a school- or work-managed device restricts adding configurations, contact its administrator; don’t change management policies.
Subscriptions & server imports
Subscription import fails after I paste an existing link. How can I troubleshoot it?
In Add Server, make sure the type is set to Subscribe. Copy the full link again from your service provider, without leading or trailing spaces, line breaks, or extra explanatory text. If the list still won’t load after saving, first check that your device can access other sites. Then ask your provider to confirm the link is valid, whether it needs to be reissued, and whether it returns subscription data rather than a login page. Don’t post the full link publicly while troubleshooting.
How do I enter details for a single server?
In Add Server, choose the protocol type that matches your server details, then enter the address, port, and required authentication fields. In the address field, enter only the specified hostname or IP address; don’t include the protocol prefix, port, or full path. If the server specifies an SNI or other TLS parameters, enter them as provided rather than guessing. Save your changes, then select the entry from Home to test it.
How do I update a subscription without accidentally removing manually added servers?
In Home, find the original entry or group imported with Subscribe and update it directly. You don’t need to clear the list or import the same link again. After updating, check that your previously selected server is still available. If your provider changed the list, choose a server again from the updated group. Manually added servers are separate entries and aren’t updated with the subscription; edit them separately using the latest details you have.
The subscription imports, but the updated list is empty. What should I check?
Saving a subscription link doesn’t guarantee that usable server entries were retrieved. First, make sure you’re viewing the group you just updated and note any update message. If it says the connection failed, check your device’s network. If the request completed but the list is still empty, ask your provider to confirm that the subscription currently returns server entries and that its format is compatible with Shadowrocket. Creating the same subscription repeatedly won’t change what the server returns.
Routing rules & troubleshooting
How do I choose among the three Global Routing modes?
Config applies the rules in the active configuration to decide how connections are handled, making it suitable for everyday routing. Proxy sends traffic through the selected server, which is useful for briefly testing the proxy route. Direct bypasses the proxy server, which is useful for comparison tests but does not turn off the connection switch in Home. When troubleshooting, change only one mode at a time, retry the same destination, record the result, then restore the original setting.
It says connected, but webpages won’t load. Which route should I check first?
First, turn off the connection switch in Home and try to visit a site that normally works on the same network. If it still fails, check Wi-Fi, mobile data, or the network’s sign-in page. If browsing works again with the connection off, turn it back on, run Connectivity Test for the selected server, and check the current Global Routing mode. A successful test only confirms that the test request completed; it doesn’t verify access to the site that failed. If only specific sites have problems, check their related rules.
The interface is in English. How do I find the controls mentioned in the manual?
Look for the English interface labels: Home shows the connection status and selected server, Config lets you view or switch configurations, and Settings contains app settings. To change the app’s language, check whether Shadowrocket offers a separate language option in your system settings. Changing the language won’t change Global Routing or your rules. Continue to use the original English keywords when checking configuration files.
How can I tell whether high background battery use is related to On Demand?
First, check Shadowrocket’s background activity on the system’s Battery page. Note when the battery drain occurs, along with the network and connection status at the time. On Demand starts a connection when its configured conditions are met; after you disconnect manually, the connection may start again if those conditions still apply. If you don’t need automatic connections, turn off On Demand, disconnect manually, then observe battery use under similar network and usage conditions. Battery usage percentages alone can’t tell you how much power a single connection used.
Why isn’t a domain routed as expected after switching to Config?
First, confirm Global Routing is set to Config and that the configuration you just edited is active. Check which domain the request actually uses, then see whether the relevant DOMAIN or DOMAIN-SUFFIX rule appears after a broader matching rule. Rules are evaluated in order. Once an earlier condition determines how to handle a connection, later rules won’t take over. FINAL handles connections that don’t match any preceding rule. After editing, test again with a new request.