SHADOWROCKET · OFFICIAL MANUAL

Shadowrocket FAQ

Before installing, check your device and download source. For connection issues, first determine whether the subscription wasn't imported, the connection wasn't established, or requests aren't being routed as expected despite a connection.

Verify the App and Make a Purchase

First verify the App Store listing, then check your store region or purchase history.

How can I verify Shadowrocket on the App Store?

Open the App Store product page and check the app name, Shadowrocket, the developer, Shadow Launch Technology Limited, and the app ID 932747118 at the end of the product page URL. Then compare it with the rocket icon with a white background and blue-purple outline in this site's header. Matching only the icon or app name is not enough. If the developer or app ID differs, return to the product page link and check again.

Can't find Shadowrocket in the App Store? Check this first

Open the product page directly first. If it says the app isn't available in your country or region, on your iPhone or iPad go to Settings, then Apple Account, Media & Purchases, View Account, and Country/Region to check your App Store region. Device language and store region are separate settings. If you need to change your region, follow Apple's country or region change process and first review the requirements for your balance, subscriptions, and payment method.

Can I install Shadowrocket on iPad if I already bought it on iPhone?

You can get Shadowrocket for iPad from the App Store. Check the App Store listing for system requirements. If you already bought it on iPhone, sign in to the App Store on your iPad with the Apple Account used for the purchase, find Shadowrocket in your purchased items, and download it again at no extra cost. The layout may differ in landscape mode; look for labels such as Home and Config.

Can't find a previous purchase after changing or reinstalling your device?

First check which Apple Account you used for the App Store purchase, then review that account's purchase history and current store region. If the product page still shows a purchase button, don't pay again yet; check your purchase history to see whether the order is associated with the current account. Redownloading restores the app, not server details, subscriptions, or Config. Back up any data you want to keep before changing devices.

How much does Shadowrocket cost? Does the purchase include servers?

The iPhone and iPad app is $2.99 as a one-time purchase on the US App Store; prices may vary by storefront. The Mac, Windows, Android, and Linux versions are free. A one-time app purchase does not include a server plan. This site does not provide, sell, or recommend servers or subscriptions. To use the connection features, bring your own subscription or server details.

Download, Install & Open for the First Time

Choose the installer that matches your device. If a warning appears, distinguish between a source verification issue, an architecture mismatch, and a damaged file.

Can I use Shadowrocket on desktop or Android? Where can I download it?

Yes. The iPhone and iPad app is $2.99 as a one-time purchase on the US App Store. The Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free. Choose an installer for those platforms from the all-platform download page. Files are hosted under /dl/shadowrocket/ on this site. Check your operating system and processor architecture before installing, especially when choosing between the two Mac installers.

Which Mac version should I choose: Apple silicon or Intel?

Open About This Mac from the Apple menu. If Chip shows an Apple M-series chip, choose Mac Apple Silicon. If Processor shows Intel, choose Mac Intel. Check the information on the Mac where you plan to install the app rather than guessing based on its purchase year. If downloading for another Mac, check that computer first too.

Windows or Mac blocks the installer. How can I tell whether it's safe to proceed?

First make sure the file came from this site's download page and matches your operating system and architecture. If the warning only says the publisher can't be verified, on Windows check the available run option under More info in SmartScreen. On macOS, after trying to open the file once, check System Settings under Privacy & Security for an Open Anyway option. If you see a malware or damaged-file warning, or the device is managed by your organization, don't force it to run. Download the file again or contact your administrator.

Can't open an Android or Linux installer after downloading?

On Android, first check that your device supports an architecture listed on the download page. If Android says your browser can't install apps, verify the file source, then follow the system prompt to temporarily allow installs for the browser or file manager you're using. You can revoke that permission afterward. On Linux, check that you selected the package type for your distribution. For an AppImage, make sure the file has execute permission. If the system reports missing dependencies, note the error and compare it with the installation instructions on the download page.

Import Subscriptions and Servers

Use your existing subscription or server details. First check the import result, then confirm which server is selected.

Subscribe import failed: how can I tell whether the link or network is the problem?

In Subscribe, paste the full link provided by your service provider again. Check that it starts and ends correctly, has no extra spaces at the end, and includes all query parameters. If the app says the address is invalid, check the pasted link first. If it times out, see whether a regular webpage loads, then retry once on another working network. If access is denied or the link has expired, check with the original provider. Subscription links may contain access credentials; don't post them publicly.

Subscription imported, but nothing changed after updating. Why?

In Home, first make sure you updated the intended subscription group, not another group or a manually added SERVER. A successful update means the list was fetched again; its entries may stay the same if the provider hasn't changed anything. If the selected server disappears after an update, choose an available entry from that group and test the connection again. If an update fails, keep the old group so you can still use it if reimporting isn't possible.

Which fields are easy to get wrong when adding a server with Add Server?

Choose the protocol provided by your service provider, then enter the address, port, and required authentication details separately. Don't paste an address that includes the port into the address field, or reuse settings from a different protocol. If your details include transport or encryption options, follow those details rather than guessing from an error. After saving, check in Home that the newly added server is selected, then run Connectivity Test.

What's the difference between Subscribe and Config?

Subscribe imports and updates an existing server list. Config manages configuration files, whose rules determine how different requests are handled. A successful subscription update doesn't mean the active configuration has changed. If a server is missing, check the subscription group first. If the server is there but only certain websites behave unexpectedly, check the active Config and rule order. Keep a working backup before replacing a configuration.

Rules & Routing and Troubleshooting

Examples use the iPhone and iPad interface. First check whether you're connected, then test the server and rules.

In Global Routing, when should I use Config, Proxy, or Direct?

Config handles traffic according to the active configuration, so different requests can match PROXY, DIRECT, or REJECT. Proxy sends all traffic handled by the client through the proxy, which can help briefly check whether a server is working. Direct sends that traffic straight through, which can help test the local network route. When troubleshooting, change only one mode at a time and test the same URL. Restore your usual mode afterward.

The connection switch in Home won't turn on. What should I check first?

First make sure a valid SERVER is selected in Home. The first time you connect, your iPhone or iPad may ask to add a VPN configuration. Confirm the request is from Shadowrocket, then follow the system prompt to allow it. If you dismissed the request earlier, try again from Home. If the switch turns off immediately, note the message on screen and check whether another VPN is already running. If the device is managed, ask your administrator whether connections are allowed.

It says connected, but webpages won't load. How can I troubleshoot it step by step?

Disconnect and try opening a regular webpage on the same network to rule out a Wi-Fi sign-in page or network issue. Then connect Shadowrocket and run Connectivity Test for the selected SERVER. If the test passes but some websites still fail, test the same URL in Proxy and Config. If the issue occurs only in Config, check which rule matches and the FINAL rule. If you see a DNS resolution error, check your DNS settings. Don't change the server, rules, and DNS all at once.

The app interface is in English. How do I find settings mentioned in the manual?

Look for the exact labels shown in the app: Home shows servers and the connection switch, Config lets you select and manage configurations, Data shows traffic usage, and Settings contains common options. If a guide mentions Global Routing, look for the entry with that name in Home. Its position may change in landscape or split-screen layouts, so follow the label rather than its location.

Battery use increased after connecting. How can I check whether the connection keeps restarting?

First check the battery page in your system settings to see when power use increased, then compare it with traffic in Shadowrocket's Data. Traffic statistics aren't battery readings, so one number alone can't identify the cause. If you often switch between Wi-Fi and mobile data, check whether On Demand reconnects in those situations. Pause On Demand during periods when you don't need automatic connections, then compare similar usage periods under similar network conditions. Restore it afterward if needed.