Shadowrocket Official Manual

Shadowrocket FAQ

Find answers by issue: verify how you got the app and which device you use, then check subscription imports, connection status, and routing policies.

Verify the app and purchase

Check the App Store listing, device requirements, and original purchasing account.

How do I get Shadowrocket? Does the purchase include server access?

Get the iPhone and iPad version from the App Store for a one-time US$2.99 purchase; check the store listing for the current price. The Mac (Apple Silicon and Intel), Windows, Android, and Linux versions are free. Get their installers from this site at /dl/ via the all-platform downloads page. A one-time app purchase does not include a service plan. Have your own subscription or server details ready before connecting; this site does not provide, sell, or recommend subscriptions or servers.

How can I verify the genuine app when there are other apps with the same name in the App Store?

Check three details on the App Store product page: the developer is Shadow Launch Technology Limited, the icon matches the official icon at the top of this site, and the product page URL ends in id932747118. Search results may show apps with similar names or icons. Before paying, open the product page and verify the developer and app ID.

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

First, check which storefront is selected and whether the product page is available there. The app is not listed in the mainland China storefront; changing your device language does not change your storefront. On your iPhone or iPad, open Settings, tap your profile, then go to Media & Purchases, View Account, and Country/Region to check your current region. If you need to change regions, follow the Change Country or Region process there. Follow the system prompts if you encounter balance or subscription restrictions.

Can I install Shadowrocket on an iPad? What are the system requirements?

Yes. The iPhone and iPad versions use the same App Store listing. Check the App Store page for the current system requirements. On your iPad, check Compatibility on the product page, then compare it with the version shown under Settings > General > About. If your device does not meet the requirements, first check whether a system update is available. Do not substitute another app with the same name.

Do I need to buy Shadowrocket again when I switch to a new iPhone or iPad?

You do not need to buy the same listing again, as long as you use the original purchasing account and the app is still available to redownload. Find the app in your App Store purchase history. If the product page shows a purchase button again, first check the account used for Media & Purchases and your storefront region instead of paying again. After reinstalling, check whether your existing subscription and Config have been transferred; reinstalling the app alone does not restore your configuration.

Installation and first launch

Choose an installer for your hardware, then distinguish system security prompts from first-connection authorization.

View installation instructions by platform
Can I use Shadowrocket on a computer or Android? Which installer should I choose?

Yes. The iPhone and iPad versions cost US$2.99 as a one-time App Store purchase in the US storefront; the Mac, Windows, Android, and Linux versions are free. Choose your operating system on the all-platform downloads page: check that Windows is 64-bit, that Android is arm64, and choose deb, rpm, or AppImage for Linux based on your distribution and installation method. Download installers only from this site at /dl/. If you see a security prompt on first launch, verify the source, then follow the instructions for your platform below.

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

Open About This Mac from the Apple menu. If you see a Chip section with a name beginning with Apple, choose the Apple Silicon version. If you see a Processor section listing Intel, choose the Intel version. Both installers use the .dmg extension, so choose based on your hardware, not your macOS version. If you see an incompatibility warning at launch, check your chip type and download the matching installer; do not mistake an architecture mismatch for a permissions issue.

How do I handle security prompts when installing Shadowrocket for the first time on Windows, Mac, or Android?

These installers are not code-signed. For routine prompts, first confirm the file came from this site at /dl/ and matches your device. If Windows SmartScreen shows More info and Run anyway, verify the source before choosing to continue for that file only. On macOS, if Privacy & Security offers Open Anyway for the app, verify the source before using that option. If Android asks you to allow installation of unknown apps, grant permission only to the source app you are using for this installation, then revoke it afterward. If the system explicitly reports malware or a damaged file, or your device is managed by an organization, stop the installation. Do not disable system-wide protection or bypass management restrictions.

Why does the connection switch on Home turn itself off after I enable it?

First, confirm that a server is available and selected on Home. The first time you connect, your iPhone or iPad may ask to add a VPN configuration. If you canceled the prompt before, try again from Home and confirm only after checking the app name in the prompt. If the connection still drops immediately, disconnect any other VPN you use and try once more. Managed devices may restrict adding configurations; ask your administrator for help, and do not remove configurations installed by your organization.

The interface is in English. Where should I look for features?

Start by learning a few key sections: Home lets you select a server and check connection status; Config shows configuration files; Settings contains app settings; and Data shows traffic statistics. To add a server manually, look for Add Server. To import an existing subscription, choose Subscribe on the add screen. When following a guide, use the English labels shown in the app; you do not need to change your device language first.

Import subscriptions and servers

If you already have a subscription link or server details, first distinguish between importing, updating, and selecting a server.

View the import and first-connection guide
Subscription import failed: how can I tell whether the link is wrong or I chose the wrong type?

In Add Server, make sure the type is Subscribe, then paste the complete subscription link provided by your existing service provider. Compare it with the original to check the beginning, end, and query parameters. Remove spaces or line breaks introduced when copying, but do not change or delete any parameters. If it still fails with Subscribe selected, note the error type and network conditions, then ask the provider to confirm that the link is valid and returns the expected format. Do not share the full link in screenshots or posts.

When adding a server manually, which fields should I check?

In Add Server, first select the protocol type specified by your provider, then check the address, port, and authentication details required for that protocol. If the provider specifies TLS or a transport method, enter those values as given; do not substitute settings from another protocol. After saving, return to Home, make sure the new server is selected, and run Connectivity Test. When troubleshooting, note only the protocol type and error message; do not share authentication details.

How do I update an imported subscription, and what should I check afterward?

On Home, find the relevant subscription group and use its action menu to update it. When the update finishes, check that the list has refreshed and that your previously selected server is still listed. If it has been removed, select a server from the updated list and run Connectivity Test. If the update fails, keep the existing group, confirm that the network is reachable and the original link is still valid, then decide whether to import it again.

A subscription was added, but the server list is empty. What should I check?

First, make sure you are viewing the group you just added and wait for the current update to finish. If the group is still empty, try updating it again with the same link on a working network. An accessible link does not necessarily return a usable server list. If the list remains empty, ask your provider whether the response matches the subscription or mistakenly returns a sign-in page, notice page, or empty list. Check the response before replacing the subscription link.

Rules & Routing

Check your local network and server route first, then narrow the issue down to rules or DNS settings.

View interface labels and rule terminology
How do I choose Config, Proxy, or Direct in Global Routing?

Config uses the rules in your current configuration file to decide where requests go, making it suitable for everyday routing. Proxy sends requests through the selected server, which is useful for briefly checking the proxy route. Direct sends requests without using a proxy server, making it useful for comparison with your local network. When troubleshooting, test the same destination, change only one mode at a time, and restore your original setting when you are done.

It says connected, but webpages won't load. What should I check first?

Disconnect first, then use the same network to open a webpage you can normally access directly. This confirms that Wi-Fi or mobile data is working. Reconnect to Shadowrocket, check the selected server on Home, and run Connectivity Test. If the test fails, check the server details and network first. If only certain domains fail, check the current Global Routing mode and whether Config includes a matching REJECT, DIRECT, or DNS setting. Avoid changing the server and configuration at the same time, or it will be difficult to tell which change mattered.

Connectivity Test passes, but some apps still can't connect. Why?

Connectivity Test reports only the route and destination used for that test; it does not guarantee access for every app, domain, or request. First check whether the issue can be reproduced on the same network, then review the domains used by the app and your current routing policy. If the same destination works in Proxy but fails in Config, check the rule order and which policy actually matched before changing servers.

Some domains won't load after I changed DNS settings. What should I do?

Note your current Config and the DNS settings before and after the change. On the same network, test one affected domain and one working domain, then revert the DNS setting you just changed and test again. If only certain domains still fail, check whether an earlier rule matches them and whether the requests are ultimately using the expected policy. Restore a working setup first, then test the new setting on its own.

My device seems to use more battery after connecting. How can I tell if On Demand is triggering repeatedly?

Check the Battery page in system Settings and note when the battery is being used. Then check whether you are frequently switching between Wi-Fi and mobile data. Review the On Demand conditions in the app. If you do not need on-demand connections, temporarily disable them and compare usage over periods with similar network conditions and activity. Signal strength and data transfer also affect battery use, so a single reading is not enough to identify the cause. Restore your preferred settings after the comparison.