Official Guide · FAQ

Shadowrocket FAQ

Find answers by where the issue occurs: check the App Store listing and account before purchase, confirm your device specifications before installing, and narrow connection problems down to your network, server, or routing rules.

App Store

Purchase and authenticity

Check the product page, storefront, and purchase history.

How much does Shadowrocket cost? Does it include servers?

The iPhone and iPad app costs $2.99 as a one-time purchase on the US App Store; check your storefront’s product page for the current price. The Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free, with installers available only from this site at /dl/shadowrocket/. The one-time app purchase does not include a server subscription. Get subscription details or server information from your provider, then import them into the app.

How can I verify Shadowrocket on the App Store?

Open the App Store product page. Check the developer name, Shadow Launch Technology Limited, against the official icon and app ID 932747118 at the end of the link. The official icon shows a rocket outlined in blue and purple on a white background. Search results may show apps with similar names or icons, so don’t rely on just one detail. Then check the price and device compatibility for your storefront.

Why can’t I find Shadowrocket in the App Store?

Open the product page first and check whether it says the app is unavailable in your storefront or your device doesn’t meet the system requirements. To check your storefront on an iPhone or iPad, go to Settings → your name → Media & Purchases → View Account → Country/Region. If you need to change it, use Change Country or Region there and follow Apple’s instructions for your balance, subscriptions, and payment information. Changing your device’s display language does not change your storefront.

Do I need to buy Shadowrocket again after getting a new iPhone or reinstalling it?

Use the Apple Account that originally purchased the app. Open the account page in the App Store, find Shadowrocket in your purchased items, and tap the download icon. If you still see a purchase button, check which account is used for Media & Purchases and review your purchase history before taking any further action. Restoring the app and restoring your settings are separate tasks; make sure your configuration and server details are backed up before switching devices.

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

Yes. Check the App Store page for the system requirements. An iPhone purchase can also be used on iPad: sign in with the same Apple Account on your iPad and download the app from your purchased items. The layout may differ from iPhone in landscape mode. If you can’t find an option, try portrait orientation and look for Home, Config, and Settings. Before connecting, check the selected server and configuration.

Devices and installers

Installation and first launch

Choose the platform and architecture first, then handle any system prompts.

View downloads for all platforms

Does Shadowrocket work on Windows, Mac, Android, and Linux?

Yes. The iPhone and iPad app costs $2.99 as a one-time App Store purchase. The Mac, Windows, Android, and Linux versions are free, with installers for those four platforms available from this site at /dl/shadowrocket/. Choose the 64-bit .exe for Windows, the arm64 .apk for Android, the .dmg for your Mac’s chip, or the deb, rpm, or AppImage package for your Linux distribution. If your system blocks the installer, first verify its source and compatibility, then follow the installation instructions on the download page.

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

Open About This Mac from the Apple menu. If it shows Chip and an Apple M-series name, choose the Apple silicon version. If it shows Processor and includes Intel, choose the Intel version. The two .dmg files are built for different architectures, so don’t choose based only on your Mac’s model year. If you transferred the app from an old Mac, select the version for your new Mac’s chip.

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

First make sure the file came from this site’s download page and that you chose the correct platform and architecture. If Windows shows only a SmartScreen reputation warning, verify the file, then select More info → Run anyway. If macOS only says the developer can’t be verified, go to System Settings → Privacy & Security and check whether Open Anyway is available for the app. If malware is detected or your system administrator has blocked the app, stop. Don’t disable system-wide protection.

Why won’t the connection switch on Home turn on?

Select an imported server on Home, then turn on the connection switch. The first time you connect, the system may ask to add a VPN configuration. Make sure the prompt was triggered by the Shadowrocket you just opened, then follow the system instructions to allow it. If the switch immediately turns off, check whether another VPN is running or a device management policy is restricting VPN access. Keep the exact error message and don’t delete existing configurations yet.

Should I back up my configuration before updating Shadowrocket?

Save any configurations you’ve changed, and make sure you can reimport your server details. Check for and install updates from the App Store on iPhone and iPad; for Mac, Windows, Android, and Linux, choose the right installer again from this site’s download page. After updating, check the server selected on Home and the Global Routing setting, then test a familiar destination. If the result changes, compare each setting with your previous notes.

Subscribe

Subscriptions and server imports

Know the difference between a subscription URL, a single server, and a configuration profile.

View the first-connection guide

What should I check first if importing a subscription fails?

In Add Server, choose Subscribe and make sure you’ve pasted the full subscription URL provided by your service provider. Don’t enter an account page or a single server share link in Subscribe, and don’t remove any existing URL parameters. If authentication fails or the list comes back empty, ask your provider to confirm that the subscription is valid and its response format is supported. When reporting the issue, share only the error text—not the full subscription URL.

How do I update an imported subscription?

On Home, find the existing subscription group, open its action menu, and select Update. There’s no need to create another group for the same URL. After updating, check that your selected server is still listed. Reselect it if needed, then run Connectivity Test. If your provider has changed the subscription URL, verify the new address before updating the subscription entry.

Should I use Subscribe if I only have details for one server?

No. If you have details for just one server, select the matching protocol in Add Server, then enter the host, port, and required authentication details. If your provider has supplied a QR code, use Scan QR Code. After saving, select the new entry on Home and test it. Two entries with the same name may still use different protocols or ports.

Why didn’t importing a subscription change the routing rules in Config?

Subscriptions are generally used to maintain a server list; the configuration profile enabled in Config determines how routing rules are applied. Importing a URL with Subscribe does not replace the active configuration profile. To check how a domain is routed, select Config under Global Routing, then review the active profile and rule order. Save a copy of the original configuration before changing any rules so you can compare them.

How can I tell which server is selected when Home shows duplicate names?

Check which group the selected entry belongs to, then open its details and compare the protocol, host, and port instead of relying on its display name. Two entries can show the same host but use different ports or authentication details. If you imported the same subscription more than once, first make sure the group you plan to keep updates and connects properly. Then remove duplicates carefully so you don’t delete an entry that’s still in use.

Global Routing

Routing rules and troubleshooting

Test the same destination for comparison, changing one thing at a time.

View the settings guide

How do I choose a Global Routing mode?

Config routes traffic according to the rules in the active configuration profile, making it suitable for everyday use once you’ve checked the rules. Proxy sends traffic through the selected proxy and can help you briefly determine whether routing rules are causing an issue. Direct sends traffic straight to its destination and can be compared with the basic network connection when disconnected. During troubleshooting, switch modes one at a time and test the same destination. Restore your original setting when you’re done.

Why can’t I access the internet even though the switch is on?

An active connection switch means the device has established a connection; it doesn’t guarantee that every request can reach its destination. Disconnect and try opening a site that normally works directly on the same network. If it still won’t load, check the Wi-Fi sign-in page or mobile data. If it works while disconnected, reconnect and briefly switch to Proxy, then test the same destination. If it loads, check the Config rules first. If it still doesn’t, check the selected server, DNS, or destination site. Change one thing at a time.

How do I follow this guide when the app is in English?

Look for the English labels used in this guide: Home is where you select a server and connect, Config is where you view configuration profiles, Global Routing is where you change the routing mode, and Settings is where you review settings. If your system shows a separate language option for Shadowrocket, check the languages available there. Otherwise, use the English interface labels to find each option.

Should I adjust On Demand if background battery use is high?

On your iPhone or iPad, go to Settings → Battery and check Shadowrocket’s usage and background activity. Note whether battery drain coincides with frequent switches between Wi-Fi and mobile data. If you only need a connection on certain networks, narrow the On Demand triggers. If you need a continuous connection, first make sure reducing the triggers won’t interrupt a service you’re using. Compare similar time periods under similar network conditions rather than drawing conclusions from a single battery drop.

Why won’t a website load even though Connectivity Test succeeds?

The result of Connectivity Test only shows whether its test destination was reachable at that moment; it doesn’t verify access to the site you’re trying to visit. Retry the specific domain in a browser, then check which policy its request matched under Config. If it matched REJECT, the rule is blocking it. If it matched PROXY, check whether the selected server can reach that destination. Note the rule that matched before deciding whether to change its order or scope.

Related guides

If you’re new to Shadowrocket, start with the tutorial. If you only need to look up a term, go straight to the glossary.