Official Manual · App Store Guide

Shadowrocket App Store Guide

Get Shadowrocket for iPhone / iPad from the App Store for a one-time US price of $2.99; the Mac (Apple silicon and Intel) / Windows / Android / Linux versions are free. Choose your platform and package format on the Download page; installers are provided on this site at /dl/shadowrocket/. If a computer or Android device blocks the first installation, check the download source and platform, then see the installation notes and one-time approval steps for your system. If the device is managed, contact its administrator.

This page is a reference for getting and restoring the app. It helps identify whether an issue involves the App Store, purchase history, or device downloads. If installation is complete, the Getting Started guide walks you through importing your existing subscription or server details, selecting Global Routing, and verifying the connection. Start with Chapter 1 for a first-time installation; jump to Chapter 5 when moving to a new device or reinstalling.

01 / App Store region

App Store region and availability

To check whether you can get the app, first look at the storefront in the App Store on your device, then check whether the product page lets you proceed. A product-page URL can point to a different storefront; opening the page in a browser does not guarantee that your account can make a purchase. Likewise, not finding the listing in search does not mean the app has been removed from every storefront. When the information conflicts, note the exact message on the product page: is the app unavailable in this storefront, incompatible with the device, or does the account need verification? Each message calls for a different fix.

Distinguish the product-page storefront from your device's storefront

In a product-page URL, /us/ indicates that the link points to the US storefront. This part of the address does not change the country or region of your Apple Account, nor does it mean the App Store on your device has switched storefronts. Opening the link in a browser may take you to the App Store or leave you on a web preview. To check whether you can actually get the app, view the page in the App Store on the target iPhone or iPad and follow the system message shown when you purchase or redownload it.

The system language, date format, location, and App Store storefront are separate settings. An interface in Simplified Chinese can show a product page from the US storefront; changing the system language to English does not necessarily change the storefront conditions. Note the prices, buttons, and status shown on the device separately from what you saw in a document or chat. In particular, don't infer the storefront region from the payment currency alone. Check the account region directly using the steps in the next chapter.

Check whether the page opens before checking whether you can get the app

When you first look for the app, note exactly where the issue occurs: no search results, a region message on the product page, a listing that won't let you purchase, or a download that starts and then stops. This app isn't available in the mainland China storefront. If your device explicitly says the app isn't available in the current storefront, repeating the search, refreshing the page, or restarting the device won't change its availability. A button visible in a web preview is not proof that the app is available to get. To check the account status, return to the App Store and read its message rather than guessing from the search results.

What you seeCheck firstNext step
No search resultsSearch terms, storefront, and content restrictionsOpen the product page to check the app ID and system message.
Page opens in a browser, but the App Store says it's unavailable in this regionThe account's country or regionCheck the actual storefront; don't use the region in the URL as a substitute for the account setting.
Listing is visible, but the device says it's incompatibleSystem requirements for the target deviceCheck compatibility on the App Store page; don't retry the purchase.
Cloud download icon appearsAccount used to get the app and current download availabilityFollow the restore-purchases steps; if it fails, note the exact message.

Visibility, purchase availability, and installability are not the same

Visibility means the current entry can display the listing. Being able to purchase also depends on the account, billing, and storefront requirements. Installation depends on the target device's system, available storage, and download status. This is why the same link can show different buttons on two devices. Even when both devices belong to the same person, the result can differ if they use different Media & Purchases accounts, one is restricted, or one doesn't meet the compatibility requirements. Troubleshoot on the device you intend to use; don't treat success on another device as proof that everything checks out.

For iPhone and iPad, refer to the system requirements shown on the App Store page. After confirming the storefront, check compatibility on the target device: seeing the product page doesn't mean that device can install the app.

Record the App Store, account, and device details separately

If you need to continue troubleshooting later, note the current storefront, whether the target device is an iPhone or iPad, whether the product page opens, and the exact message shown at the last step. If you've already purchased the app, also check whether Shadowrocket appears in the purchase history for the same account. Don't record account passwords, verification codes, full payment details, or subscription links. These notes help you pick up where you left off without repeating checks you've already passed or mistaking a download error for a reason to change regions.

02 / Check your account

Check your App Store and account

First, identify which Apple Account handles App Store transactions. The account used to sync photos, notes, and backups may differ from the one used for Media & Purchases. This is easy to mix up when setting up a new device, restoring a backup, or continuing on an older device: you may appear to be signed in at the top of Settings while the purchase history belongs to another account. This difference affects both which storefront shows the app and where to find the order. The name at the top of the device settings isn't enough to confirm the purchasing account.

Check the country or region under Media & Purchases

  1. On the target iPhone or iPad, open Settings and tap the account name at the top. Before opening Media & Purchases, make sure this is the device you intend to use to purchase or install the app.
  2. Tap Media & Purchases, then choose View Account. If the system asks you to verify your identity, complete the steps in the system prompt. Don't use a browser's saved sign-in status to infer which Media & Purchases account is active on the device.
  3. Open Country/Region to see the storefront associated with the current account. This is only a check; you don't need to submit a region change. If the interface looks different, use the Country/Region option on the account page.
  4. Return to the App Store, tap your profile picture to check the store account, then open the Shadowrocket product page. Look for a storefront message, purchase button, or cloud download icon. Note the detail relevant to what you're trying to do.

Identify the task before choosing which account to check

For a first-time purchase, check whether the listing is available in the current storefront and whether the account can complete the transaction. For a device transfer or reinstall, first check whether the current Media & Purchases account is the one used for the original purchase. To view a family member's purchases, distinguish the purchaser from the person downloading the app. These are different paths, even when they all involve the same device. For example, if the app isn't in your personal purchase list during a reinstall, don't immediately buy it again with another account. Check the original order first to see which account owns the purchase.

If the device was previously set up by another family member, similar account names, email aliases, or device names can make it harder to tell accounts apart. Compare the Media & Purchases account shown in the App Store with the original order rather than relying on the fact that the app icon used to be on the Home Screen. The app may have been installed through a purchase, downloaded from a family member's shared purchases, or transferred as an icon that was still waiting to download. None of these alone proves that the current account has a purchase record.

Check the requirements before changing the region

Country or Region is an Apple Account setting, not an option for an individual app. Change it through the system flow only if your actual place of residence or billing situation has changed and you need to update it. Enter accurate billing details as required by the new storefront. Before submitting, resolve any conditions listed by the system. An account balance, pending refund or preorder, or an Apple subscription that needs to be canceled may temporarily prevent a region change. Address the items shown first; don't change regions while repeatedly trying the same purchase.

Family group status can also affect a region change. After switching storefronts, the availability or redownload conditions for content from the previous storefront may change. Before moving to a new device, check whether you can get your usual content there, and keep any client configuration you're entitled to export. There's no need to leave a family group or change billing details just to troubleshoot a missing search result. If the system asks you to update family settings, first understand which shared purchases could be affected, then let the account holder decide whether to proceed.

Resolve account prompts before proceeding to purchase confirmation

If the account page won't open, the system repeatedly asks for verification, or billing is still being processed, resolve the account issue before checking the product page again. Don't keep tapping the purchase button to test whether the issue is fixed; you may keep reaching the same confirmation screen and make it harder to tell which actions were submitted. After reopening the App Store, check the account and region once. If they match your expectations and the product page is actionable, use the next chapter to verify the listing. If the account changed between attempts, check for downloads in progress or shared purchases you need to keep track of.

03 / Verify the app

Check the developer, official icon, and app ID

To confirm the Shadowrocket listing, check the developer, official icon, and app ID together. The displayed name can help you find it, but it's not a unique identifier; similar names, promotional images, or icons aren't enough to confirm an app on their own. Start from the product page linked in this manual, then verify the details in the App Store on your target device rather than choosing based on search-result ranking. If any detail doesn't match, stop. Don't confirm a purchase or install the app just to get a closer look at the icon.

Developer: check the product details, not a recommendation card

Open the full Shadowrocket product page in the App Store and look for the developer near the title or in the listing details. The developer should be Shadow Launch Technology Limited. Recommendation cards, editorial headings, and names mentioned in reviews are not the developer field for the current listing. If you first see a search collection or list, open the specific product before checking. A line break in the text doesn't mean the name is wrong, but missing text or a different organization name is not a match.

Official icon: compare the full image, not a single detail

The official icon has a white background with a blue-violet outlined design. View it in the App Store listing and compare it with the official icon in this site's header. Device appearance, Home Screen icon styles, or cropping can affect how it looks, so don't judge it by the background color alone. A Home Screen icon can help you find an installed app, but it can't confirm that the listing you're about to purchase is the same one. Verify the product page currently open, not a shared-link preview, search thumbnail, or old screenshot from someone else.

App ID: check the final digits in the product-page URL

In the browser address, check that the host is apps.apple.com, then confirm that the product path ends with id932747118. The number 932747118 is the app ID for this listing. The App Store on a device usually doesn't show this number beside the title. You can copy the link from the product page's share menu, check the id part of the address, then return to the App Store to verify the developer and icon. The storefront part of the URL points to a regional product page; it isn't a substitute for the app ID.

CheckWhat to look forCommon mistake
DeveloperShadow Launch Technology LimitedMistaking a recommendation heading or search ad for the developer.
Official iconOfficial icon with a white background and blue-violet outlineChecking only the Home Screen icon's color.
App ID932747118Mistaking the storefront segment or another number in the link for the app ID.

Don't use the purchase button as a substitute for verification

The same product can show different actions to different accounts. An account that hasn't acquired the app may see a purchase button; an account that already has it may see a download icon; and an installed app may show an Open button. These buttons mainly reflect the current device and account status, not the product's identity. If a listing with the same name doesn't look right, compare the three items above. Even if two products look similar, different app IDs mean they aren't the same listing. If you've already purchased the app, check the order first rather than assuming it's no longer valid because the list shows a Get button.

Make one final check before the transaction

After confirming the product page, the system's purchase confirmation usually shows the item being purchased. Use it for one final cross-check: you're on the target device, the App Store is using the expected account, and the item name matches the listing you just verified. If you leave the page, switch accounts, or reopen the app from a new search result, verify the developer and app ID again instead of relying on the previous page. For Mac, Windows, Android, and Linux, choose the appropriate installer on the Download page; don't use an App Store listing to identify files for those platforms.

If the developer and icon match but the app ID doesn't, stop and reopen the App Store product page from the link at the bottom of this page. Once all three match, check the purchase or restore status.

04 / First purchase

Purchase steps and what the one-time payment covers

There are two ways to get the app: the iPhone / iPad version is a one-time App Store purchase, priced at $2.99 in the US; the Mac / Windows / Android / Linux versions are free. The amount and currency shown on the confirmation page for your current storefront are the ones that apply. The iPhone and iPad versions share the same app purchase for an eligible account. Redownloading on a particular device still depends on storefront availability, system compatibility, and purchase status. Before the transaction, confirm that the device can install the app and that you're using the intended account. Don't use the price shown on another device as the amount for this purchase.

Open the system purchase confirmation from the product page

On the target iPhone or iPad, open the product page, verify the developer, icon, and app ID as described in Chapter 3, and check the target device's requirements in the compatibility information. Confirm that this is your first time getting the app, then tap the purchase button. Follow the system prompts to verify the device or account. On the confirmation screen, check the app name, billing amount, and account. If the account or amount isn't what you expected, go back and check the storefront and Media & Purchases account. Don't proceed until you've confirmed them.

Accounts with Family approval, device restrictions, or additional payment verification may show a pending status after submission instead of starting the download immediately. Check whether the system says it's awaiting approval, verifying billing, or downloading. For an approval request, the family member with approval permissions should review it. For a billing issue, the account holder should resolve it in the purchase settings. Don't submit the same request repeatedly, and don't treat links in texts, emails, or chats as App Store payment confirmations.

The one-time purchase covers the app, not a network service

One-time app purchase ≠ network subscription. An App Store transaction gives you the right to use the Shadowrocket app. Opening it for the first time doesn't import a server or subscription, and it doesn't establish a connection. To configure a connection, import your own existing subscription or server details using the Getting Started guide. This manual does not provide, sell, or recommend proxy nodes or subscriptions, and you don't need to share your server address, access credentials, or subscription link. An App Store order can't recover configuration materials that you store separately.

App updates and configuration updates are easy to confuse. App Store updates the app itself and is controlled by the system's update settings. Subscribe or Config in the app handles your own subscriptions and configuration; that's a separate process. Even when the App Store says the app is up to date, that doesn't mean your subscription has been refreshed. Likewise, updating a subscription won't fix an App Store billing error or change the account's storefront. When checking whether an update worked, first identify what was updated.

Check purchase confirmation, order history, and installation separately

After a successful purchase, you can check your purchase history in the App Store account area. If the icon hasn't appeared on the Home Screen yet, that doesn't mean the order wasn't placed; the download may still be queued or paused because of low storage. Likewise, a pending charge shown by a bank or payment provider doesn't replace the App Store order status. Check the app and transaction status in Apple's purchase history first, then decide whether to wait, restart the download, or resolve a billing issue. If the app already shows a download option under purchases, don't submit another transaction.

If the app is installed on an old device but the new device still shows a purchase button, compare the Media & Purchases accounts and storefronts on both devices, then check the original purchase history. The new device may not have retrieved the original order yet, or it may be using another account. If you previously got the app from a family member's purchases, follow the Family Sharing steps in the next chapter instead of treating the family member's record as your own. Only reconsider a first-time purchase after confirming that no applicable personal purchase or family-shared purchase exists.

Keep different information before and after purchase

Before purchasing, note only the expected storefront, target device, and verified app ID. After confirmation, keep the order in your account for future reference; there's no need to copy payment details. If you're preparing to move from an old device, separately back up any client configuration you're entitled to keep. Keeping orders and configuration separate makes it easier to answer two different questions when changing devices: can you redownload the app from the store, and can you restore your previous settings after opening it?

05 / Restore purchases

Moving or reinstalling: redownload from purchases

If you've purchased Shadowrocket, first use the original Media & Purchases account to find it in your purchases, then redownload it from the list. Normally, the same account won't be charged again for an eligible purchase that remains available to download. This restores the app itself; it doesn't guarantee that your server list, current Config, or switch settings will be restored too. If you still have the old device, check whether it contains the configuration you need before erasing or handing it over. A purchase record is not a backup of app data.

Redownload on a new device

  1. On the new device, check Media & Purchases in Settings and make sure it's using the account that originally purchased Shadowrocket. If you still have the old device, compare the Media & Purchases accounts on both; don't rely only on the name at the top of Settings.
  2. Open the App Store, tap your profile picture, and open the app list. Depending on your system interface, this entry may be called Apps or Purchased. If you're in a family group, select your own purchases first.
  3. Check Not on this device or search the list for Shadowrocket. If it doesn't appear in the list of apps that aren't currently installed, check the full app list and see whether it's already installed or waiting to download.
  4. Once you find the listing, verify its identity and tap the cloud download icon. When installation finishes, open it from the Home Screen or App Store. Check the Home and Config status before deciding whether to import your own configuration.

The order is there, but the app isn't in the download list

Purchase history and the redownload list serve different purposes. Purchase history shows transactions; the redownload list provides apps that are currently available to download. If you found the app in purchase history but not in the list, first check whether you hid it. Look for hidden purchases in your App Store account settings, unhide the app, then refresh the app list. Also check whether the current storefront still offers the app and whether the target device meets the system requirements on the product page. An order still being present doesn't change the device's installation requirements.

If you know you aren't using the original purchasing account, check whether you bought the app yourself with another account or downloaded it from a family member's shared purchases. If you got it through Family Sharing, check the member list as described in the next chapter. The app's download availability may change if the purchaser leaves the group or sharing settings change. If the purchase was refunded or canceled, use the order status as the reference. A missing download option doesn't always mean the purchase was hidden.

After a device transfer, an icon doesn't mean installation is complete

After transferring data from an old device, the Shadowrocket icon may appear before the App Store actually begins downloading the app. If the icon says Waiting, its progress circle stops, or tapping it does nothing, check the download status and current account in the App Store. If other apps are queued too, don't keep removing the icon to speed things up; resolve the device-wide download queue or storage issue first. Wait until the app opens normally before checking its data. A waiting icon doesn't mean the app itself can't run.

Once the app opens, check configuration and system permissions

Return to Home to check whether your server or subscription is present, then open Config to check the selected configuration. If your old data didn't transfer, import it again from wherever you saved it, then check Global Routing for your intended use. If the app opens but doesn't connect, check whether the system needs you to approve the VPN configuration again. System permissions on a new device may differ from those on the old one, so don't assume that the previous switch state means the new device is connected. Check authorization, rule selection, and connectivity separately.

The steps are simple: check the original account's order, then the purchased-app download option, then the new device's data. If the old device holds the only copy of your client configuration, first check whether you can preserve it or retrieve it from its original source before removing the app. For details on the relevant entries and missing-list cases, see the technical notes on restoring purchases after a device transfer or reinstall. After reinstalling, return to the Getting Started guide to verify the setup separately.

06 / Family purchases

Family Sharing: eligibility and where to download

Check Family Sharing at two levels: whether the product page lists the app as eligible for Family Sharing, and whether family settings allow members to share purchases. Being in the same family group doesn't combine everyone's personal orders. Shared purchases remain associated with the original purchasing account, and other members get the app from the family purchases list. If a family member can't find the app, first check the listing and sharing status rather than repeatedly searching their personal purchase history.

Have the organizer and purchaser check their settings separately

The family organizer should check the group members and Purchase Sharing status in the device's family settings, and confirm that the person who wants to download the app is a member. The purchaser should check their App Store purchase history to confirm the app is still eligible and see whether it has been hidden. A hidden purchase may not appear for other family members. If the Media & Purchases account has changed, also confirm that the current account used for Purchase Sharing is the one that owns the order. Seeing the same family identity at the top of Settings isn't enough to confirm this.

Next, open the Shadowrocket product page on the target device and check the App Sharing information shown by the store to confirm eligibility and availability in the current storefront. Family purchase sharing usually requires members to use the same App Store country or region. If one member can see the product page and another can't, compare their actual storefronts before considering rebuilding the family group. Changing sharing settings can affect other purchases in the group, so don't change them just to test a single app.

Download from the purchaser's app list

  1. On their own device, the family member should open the App Store and tap their profile picture to find the apps or purchases entry. They should continue using their own Media & Purchases account; there's no need to sign the purchaser's account in on the device.
  2. In the family member section, select the original purchaser and search for Shadowrocket. Personal apps and family member lists may be next to each other. If you can't find the app, first make sure you've selected the purchaser rather than your own name.
  3. Open the listing from the member's list, verify the developer and app ID, then tap the available download icon. If you see a purchase confirmation instead, stop and check sharing eligibility and settings; don't treat that screen as proof that sharing is active.
  4. After installation, each family member configures their own app. Family download access doesn't transfer Config, server details, subscription credentials, or VPN authorization on the device. Check each device separately after opening the app.

Distinguish approval, billing, and redownload eligibility

When a child account requests the app, the system may show a Family approval prompt. The responsible adult should check the system notification to identify the app and requester, confirm whether the request is for a shared download or a new purchase, and then decide how to proceed. Approving a request doesn't transfer the purchase to the child's account or guarantee that the target device meets the installation requirements. If content restrictions apply, first check the product-page information and device content settings. A parent or device administrator should decide whether to adjust them; children shouldn't bypass restrictions on their own devices.

Family payment settings and Purchase Sharing are also separate. The account and system confirmation page show how a paid item will be billed; using a family payment method doesn't mean every member owns the same order. When moving to a new device or redownloading later, first check whether the current account purchased the app independently or originally downloaded it from a family member's purchase list, then follow the right restore path. If the downloader leaves the group or the purchaser stops sharing, don't expect the app to remain available in the family list for a future reinstall.

If a shared app is missing, troubleshoot only the relevant scope

If only Shadowrocket is missing, first check the purchaser, hidden status, product eligibility, and storefront for that app. If multiple apps that should be shared are missing, check the family group and Purchase Sharing settings. If one device has an issue while another device used by the same member works, start with the affected device's Media & Purchases account and restrictions. Check one item at a time and return to the member list to verify the result. This helps distinguish listing eligibility from family settings and avoids changing unrelated purchases.

08 / Download and first launch

Interrupted downloads, installation failures, and first launch

If you find the correct product but can't download it, troubleshoot based on when the issue occurs: before the download starts, check the App Store and account messages; if progress starts and then stops, check the download queue, network, and storage; if installation succeeds but there's no connection, check the app configuration and system authorization. Don't switch accounts or reinstall repeatedly across these stages, and don't delete the old device's app while it still holds configuration you may need to fix the new device.

Tapping the button doesn't start the download

Check whether the App Store says verification is required, billing is unresolved, Family approval is pending, or the device is incompatible. Resolve the issue shown first. If you suspect incompatibility, open the product page's compatibility information and check the system status under About on the target device. Use the system requirements shown on the App Store page. If the device doesn't meet them, signing into the store repeatedly or changing download networks won't change compatibility.

Progress appears, then waits or pauses

First check whether the device is still restoring a backup or downloading other apps in bulk. Then open Settings and check available storage. Installation uses temporary space, so the app size shown on the page isn't enough to estimate what's needed. If space is low, start with content that you have backed up and can get again; don't delete Shadowrocket data that hasn't been transferred yet. Check that the current network can load the App Store. If the system restricts downloads over mobile data, choose an available network according to your data settings.

If the icon on the Home Screen shows a waiting status, resume the download if the system offers that option, or long-press the icon to see whether you can prioritize it. Handle one stuck app at a time and wait before deciding what to try next. If other apps fail too, investigate the network, system restrictions, or storage first. If only this listing fails, return to the product page and check whether it's still available to download. Don't make app deletion your first step, especially when the issue involves an update or reinstall and old data may still be on the device.

The app opens, but there's no connection yet

If Home opens, the App Store installation is complete. Next, check whether you've imported your own subscription or server details, review the current configuration in Config, and choose Global Routing for your use case. The first time you connect, the system may ask permission to add a VPN configuration. This is device authorization, not another purchase. If you previously denied or removed the configuration, see the technical notes on the VPN configuration prompt. If the device is organization-managed, check with the administrator before adding the configuration.

Use a sample rule to distinguish installation from routing

The [Rule] snippet below is from a .conf file. It shows how rules are read when Global Routing is set to Config. It isn't a complete configuration file and doesn't include a working server. After installing the app and importing your own configuration, you can use the snippet to follow the rule order. Don't use these lines to overwrite your existing configuration or test a purchase. example.com is a sample domain, not a subscription or connection service.

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,DIRECT

DOMAIN-SUFFIX applies PROXY to the example domain and its subdomains. GEOIP assigns DIRECT to addresses that match the corresponding geographic condition, and the final FINAL rule assigns a default policy to requests that didn't match an earlier rule. In actual use, PROXY still requires a working proxy configuration. If Global Routing is set to Proxy or Direct rather than Config, don't attribute that behavior directly to the order of these rules. For step-by-step help importing a configuration and verifying a connection, see the Getting Started guide.

When describing the issue to someone else, first say whether it occurs at purchase confirmation, download progress, or client connection, then quote the relevant system message. Don't share subscription links, account credentials, or order screenshots containing private information.

Product page

View Shadowrocket in the App Store

For iPhone / iPad. Refer to the App Store page for system requirements.

View in the App StoreShadowrocket

Next: choose a download for your platform, or follow the Getting Started guide after installation to import your existing configuration and verify the connection.