01 / Verify three details in the App Store
Open the product page and check the name Shadowrocket, the developer Shadow Launch Technology Limited, and app ID 932747118. Compare the official icon as well; do not rely only on a name or similar image in search results. The app ID is shown in the product page URL, and developer details should be checked on the product page. System requirements are as listed on the App Store page; confirm your device meets them before purchasing.
Mac, Windows, Android, and Linux use a different access method from mobile app stores: choose the relevant platform on this site's download page. Installers are provided through /dl/shadowrocket/. If the system blocks the first launch, read the prompt and follow the platform-specific instructions; do not disable all system protections as an installation step.
02 / Store visibility depends on account region
If Shadowrocket does not appear in the mainland China App Store, first check the country or region for the Apple ID used for Media & Purchases. Device language, the region shown in system settings, and the store account region are separate settings; changing the device language does not change the store account. Before changing the account region, follow the system prompts about account balance, active subscriptions, and payment details. The requirements shown on your account page determine whether you can change it.
Do not install a similarly named listing just because search returns no results, and do not treat store visibility as a client connection issue. Store access comes before installing the app; connection troubleshooting applies after the app, server settings, and network are in place. The blog article about store regions explains where to check and what to consider before making changes.
Store regions and visibility →
03 / Two price tiers and restoring a purchase
In the US App Store, iPhone / iPad costs $2.99 as a one-time purchase; other storefronts show local currency. Mac, Windows, Android, and Linux versions are free. On iPhone and iPad using the same purchase account, you can restore the app from your purchase history. If the product page still shows a price after changing devices, check the account and purchase history before paying again.
Handle app updates and server updates separately. Update the iPhone / iPad app through the App Store; get new desktop, Android, and Linux versions from this site's download page. Subscribe updates subscription contents, not the app. Before reinstalling or updating, keep local configuration and necessary server details. Afterward, confirm the current selection instead of only checking whether the app opens.
Device migration and restore steps →
04 / App purchase ≠ service plan
The client stores servers, establishes connections, and applies rules; destinations depend on your existing server details. Get subscription URLs from your provider. This site does not provide, sell, or recommend nodes or subscriptions, and an app purchase is not proof of a network service. If the server list is empty after purchase, that does not mean the purchase failed; use the manual to import your own details.
Subscription URLs may contain access credentials. Remove the full URL, passwords, and identifying details before sharing screenshots, configuration files, or diagnostic records. A reproducible description of the error, selected mode, and testing sequence is enough to help narrow down the issue. Read rule files as well: check for unwanted routing or blocking conditions before enabling them rather than treating the entire configuration as an attachment that needs no review.
05 / Choose the next section by symptom
If you have a subscription but do not know where to add it, start with Subscribe and import in server management. If the switch is on but sites remain inaccessible, follow the verification steps in the user guide. If only some destinations fail, check Config match order and Global Routing. This separates three issues—nothing imported yet, an unavailable server, and different rule handling—without requiring you to delete and reinstall the app each time.
When reporting an issue, include the network type, whether all servers fail, the Connectivity Test result, and the adjustments already tried. Change one condition at a time during testing, then restore the original setting. The FAQ groups guidance by product verification, downloads and installation, subscription import, and rule troubleshooting. For specific fields, use the current app interface and your existing server details as the reference.
Troubleshoot by issue →