Shadowrocket Official Manual

Shadowrocket FAQ

Find answers by symptom: check the storefront region if you can’t find the app, the system warning if first launch is blocked, and the network before checking rules if you’re connected but can’t access a site.

App verification and purchase

Developer, storefront region, and purchase history

How can I verify the official Shadowrocket app in the App Store?

Open the App Store product page and check three things: first, the developer is Shadow Launch Technology Limited; second, the icon matches the official icon in this page’s header; third, the product page URL ends in id932747118 and the app ID is 932747118. Search results may show similar names or icons, so don’t rely on just one detail. If any of the three checks doesn’t match, return to the product page and verify it again.

Can’t find Shadowrocket in the App Store? Check your account’s country or region

First, use the product page to check whether the app is missing from search results or marked unavailable in your current storefront. If it’s unavailable, open Settings on your device, tap your name, then go to Media & Purchases → View Account → Country/Region. This is your storefront region, not your device language. If you need to change it, use Change Country or Region on the same screen and follow Apple’s instructions for your balance, active subscriptions, and payment details. Then reopen the product page to check availability.

Do I need to buy Shadowrocket again when I get a new iPhone or reinstall it?

Usually not. Make sure the new device uses the original purchasing account under Media & Purchases, then find the purchase in your App Store account and download it again. If it isn’t listed, check your purchase history, hidden purchases, and current storefront region before placing another order. Redownloading restores access to the app; it may not restore Config or server entries from your old device. Back up any configurations you want to keep before switching devices.

Can I install Shadowrocket on iPad and use the same purchase as on iPhone?

Yes. Shadowrocket for iPhone and iPad is a one-time $2.99 App Store purchase; the US storefront price is shown here, and the App Store listing is the source for current pricing. Versions for Mac, Windows, Android, and Linux are free. The same purchasing account can use the purchase on eligible iPhone and iPad devices. Check the App Store listing for system requirements. If your iPad doesn’t show the purchase, check the Media & Purchases account and the product page’s compatibility information.

Does the one-time app purchase include servers or a subscription?

A one-time app purchase is not a server plan. App access and server access are managed separately. This site does not provide, sell, or recommend servers or subscriptions. Before connecting, make sure you already have a usable subscription URL or server details. If the app opens but an imported entry doesn’t work, check the subscription update and server details separately. You don’t need to acquire the app again to troubleshoot a connection.

Installation and first launch

Installers, system warnings, and connection permissions

Can I use Shadowrocket on a computer or Android device?

Yes. Shadowrocket for iPhone and iPad is a one-time $2.99 App Store purchase; versions for Mac, Windows, Android, and Linux are free. Get desktop and Android installers from the download page; downloads are available only through this site’s /dl/shadowrocket/ path. For Mac, check your chip type. For Windows and Android, check your device architecture. For Linux, choose the package format for your distribution. If you see a system warning on first launch, follow the installation instructions and check the source and warning type. Don’t continue if you can’t verify the source.

Which Mac download should I choose: Apple Silicon or Intel?

Check the hardware shown in About This Mac instead of guessing from the model year or appearance. Open the Apple menu in the top-left corner of the screen, then select About This Mac. If the Chip field lists an Apple chip, choose the Apple Silicon version. If the Processor field lists Intel, choose the Intel version. Both DMG files are available in the Mac downloads section. If macOS says the app is incompatible, check that you chose the right package; an architecture mismatch is not a security warning.

What should I do if Windows or Mac warns me when I open the app for the first time?

First, confirm that the file came from this site’s installer page, matches your device architecture, and that you understand the warning. If SmartScreen only reports an unknown publisher, verify the source, then check More info for an option to Run anyway. If macOS says it can’t verify the developer, try opening the app, then go to System Settings → Privacy & Security and check whether Open Anyway is available for it. If the system reports malware or a damaged file, or an administrator policy blocks the app, stop. Don’t disable system protections to continue the installation.

The connection switch won’t turn on on iPhone or iPad. What should I check first?

First, make sure Home has a usable server entry and that the entry you want to test is selected. The first time you connect, the system may ask to add a VPN configuration; follow the prompts to authorize it and complete authentication. If you previously canceled, return to Home and try again. If the switch immediately turns off, check whether another VPN is active or an organization’s management policy is restricting connections. Note the exact error before changing settings so you don’t mistake an authorization issue for a server problem.

The interface is in English. Which labels should I look for?

You don’t need to change your system language first. Find the screen you need by its label: Home shows servers and connection status; Add Server adds an existing server; Global Routing determines how traffic is handled after a connection is established; Config shows the current configuration; Settings includes options such as On Demand. Follow the user guide by matching its English interface labels, then check which entry is selected. Don’t rely only on a button’s position or color.

Subscription and server imports

Subscription URLs, server details, and list updates

Why can’t I import my subscription URL?

Make sure you have the complete subscription URL for your account, not a login or account-management page. When copying it, check for extra spaces or line breaks and make sure you haven’t omitted any parameters after the question mark. Choose Subscribe when importing; don’t enter it as an individual server. If you see a login prompt, an access error, or an expiration notice, check the URL’s status through the channel where you got it. Subscription URLs may contain access credentials, so don’t share the raw link or an unredacted screenshot while troubleshooting.

How do I update a subscription and check whether it worked?

Update the imported Subscribe entry, then return to Home. Confirm that the server you want to test is still in the list and remains selected. Updating the server list doesn’t change Global Routing or Config, so check both before reconnecting. If the update fails, keep any entries that still work, note the warning, and verify that the subscription URL is still valid before deciding whether to import it again.

How do I add server details without a subscription URL?

In Add Server, choose the protocol that matches your existing server details, then enter the required address, port, and authentication fields. Don’t use an individual server address as a Subscribe URL, and don’t switch protocols just because a connection times out. If your details specify TLS or SNI, enter them as provided; don’t weaken verification requirements just to pass a test. Save the entry, return to Home, select it, and run a connection test.

Why did server names or the number of servers change after a subscription update?

A subscription update retrieves the list currently returned by that URL. Entries may be renamed, replaced, or removed. First, confirm that you updated the intended Subscribe entry, then check the server selected in Home. If an old name is gone, don’t choose another entry just because its name looks similar. Compare known details such as the protocol, then test one of your own valid entries. If the list is empty and an error appears, note the error instead of repeatedly deleting and recreating entries.

Rule-based routing and troubleshooting

Routing modes, connectivity, and background battery use

Which Global Routing mode should I use: Config, Proxy, or Direct?

For everyday rule-based routing, choose Config. Traffic is handled according to the rules in the current Config. To test the proxy path on its own, temporarily choose Proxy so traffic handled by the client goes through the proxy. To compare results without the proxy, temporarily choose Direct. Direct does not turn off the system VPN. After the comparison, switch back to your intended mode and test the same address again to confirm that the result changed because of the mode, not the test target.

The switch says Connected, but I still can’t access the internet. Why?

Connected means the system connection is established; it doesn’t guarantee that a particular website is reachable. Disconnect Shadowrocket and open the same address in the same browser. If it still fails, check your Wi-Fi or mobile data first. If it works while disconnected, return to Home, verify the selected server, and run Connectivity Test. If the test passes but the page still fails, check whether Global Routing and Config send that destination along the intended path. Change one thing at a time to identify where the problem occurs.

Why won’t one domain open in Config mode?

First, confirm that the expected Config is enabled and note the domain that actually fails. After a redirect, the failing domain may differ from the one you originally entered. Check whether an earlier DOMAIN, DOMAIN-SUFFIX, or DOMAIN-KEYWORD rule matches it, and whether that rule’s policy is PROXY, DIRECT, or REJECT. Don’t change FINAL first: it is the fallback rule, and changing it may affect other destinations that were working.

Should I turn off On Demand if battery use is high in the background?

First decide whether you need automatic connections, then compare battery use. Note activity on the device’s Battery screen and check whether drain is concentrated during weak-signal periods, frequent network changes, or repeated connection attempts. If you usually connect manually only when needed, temporarily turn off On Demand and compare similar periods of use under similar network conditions. If you still need automatic connections, narrow the trigger conditions first. Don’t change servers, edit rules, and turn off On Demand all at once, or it will be hard to identify what affected battery use.

Does a successful Connectivity Test mean all my rules are working?

No. Connectivity Test reports the result for its test target and route at that moment; it doesn’t replace checking access in the app you’re having trouble with. After a successful test, keep the same network, server, and Global Routing mode, then open the address that actually fails. If only that destination fails, check its matching rule and policy first. If several unrelated destinations fail, check the server, network, or DNS resolution. Note the target used in each test so you don’t compare results from different routes.