Official Manual

Shadowrocket Rule Routing Guide

Shadowrocket is a multi-platform client for importing existing subscriptions or server details and setting up rule-based routing by destination.

iPhone / iPad: $2.99 one-time purchase on the App Store; Mac / Windows / Android / Linux: free

View the first-connection steps

  • Global Routing
  • On Demand
  • WireGuard

Rules, Connections, and Configuration

If you already have a subscription or server details, verify the connection before adjusting routing policies. Change one setting at a time to identify whether an issue comes from server parameters, a configuration file, or connection conditions.

Rule

To choose a connection method by destination, set Global Routing to Config in Home, then check which file is active in Config. Config selects a policy according to its rules; Proxy uses the selected server, while Direct connects directly. Rules are matched from top to bottom, and the first match determines how a request is handled. Put specific domains before broader conditions and place FINAL at the end to handle requests that match no earlier rule.

DOMAIN-SUFFIX,example.com,PROXY

Check the Listing, Purchase History, and Packages

Shadowrocket is closed-source commercial software. This official manual covers how to get, configure, and troubleshoot the client. For your first download, choose the channel for your device, then verify the product listing or package.

Official Shadowrocket icon
  • 2 access options
  • App ID 932747118

Developer
Shadow Launch Technology Limited

  1. Check three details on the App Store

    Open the Shadowrocket App Store product page. First, check the developer name: it should be Shadow Launch Technology Limited. Next, compare the official icon shown here: a white background with a blue-violet outlined design. Finally, check that the App ID at the end of the product page URL is 932747118. A name in the page title or the nickname sometimes used in a description can help with an initial identification, but it does not replace these three checks.

    If you open the product page from a link someone sent you, follow the same checks in the same order. If the icon looks similar but the developer or App ID differs, return to the site and open the product page from here. Once you find the correct listing, check its compatibility section. For iPhone / iPad system requirements, refer to the App Store listing. Before switching devices, compare these requirements with the new device's system information; do not assume it will install just because it opened on the old device.

  2. If you cannot find it, check your account's store region

    App Store availability depends on the store region associated with the Apple ID used for Media & Purchases. Your physical location, device language, or the region of a web page does not indicate which store your account currently uses. If the app does not appear in search results in the China mainland store, open the product page from this site first to distinguish between “not found in search” and “not available in the current store.”

    To check your account region, open Media & Purchases under your Apple Account in device settings, then view the country or region in your account information. If the page opens but the store says the app is unavailable in your current region, follow the store's message. If the page says your device is incompatible, check the compatibility section. These messages point to different issues, and changing your device's display language will not resolve them. See the store availability guide for detailed steps.

  3. One-time purchase and restoring purchases

    The iPhone / iPad version is listed at $2.99 as a one-time purchase in the US App Store; the price shown in the relevant store applies. The Mac / Windows / Android / Linux versions are free. The same Apple ID used for the purchase can use it on eligible iPhone and iPad devices, so you do not need to buy it again for each device. If two devices use different purchase accounts, first check which account holds the original purchase.

    After changing devices or reinstalling, sign in with the original purchase account and look for Shadowrocket in your App Store purchased items. Download it again from that entry. If you cannot find the record, first check which account is signed in to Media & Purchases, then look for the original purchase; do not buy again directly from search results. Restoring a purchase provides access to the app; it does not restore local rule files, subscriptions, or server details. If the old device is still available, confirm which configurations need to be transferred and keep them safe before switching.

  4. A client purchase is not a service plan

    Buying the app provides access to the client; it does not add server entries to your account or create a subscription link. This site does not provide, sell, or recommend nodes or subscriptions. If you already have a subscription URL, import its existing entries with Subscribe. If you already have the parameters for an individual server, enter them with Add Server using the relevant protocol. Before importing, identify whether you have a subscription URL, individual server parameters, or a configuration file for routing: these serve different purposes and are not interchangeable.

    When troubleshooting for the first time, distinguish between “the app is installed,” “the server is reachable,” and “the destination is routed according to the rules.” Check the currently selected entry in Home, test that entry with Connectivity Test, and check the destination rule in Config. If a subscription has expired or server parameters have changed, check the original service information; reinstalling the app or changing Global Routing will not update the service's validity period. To document an issue, note when it occurred, the connection method, and the message shown. Do not post addresses or passwords publicly.

  5. Packages and updates for other platforms

    Mac, Windows, Android, and Linux versions are free. Get the iPhone / iPad version from the App Store; it is a one-time $2.99 purchase in the US store. Packages for other platforms are provided through this site's /dl/shadowrocket/ path. Choose your device on the download page and check its architecture: Apple Silicon and Intel Macs use different packages; check for arm64 on Android; and check the distribution, architecture, and package format on Linux. The same file extension does not mean a package supports the same device.

    If the system blocks the first launch, compare the download source and selected architecture, then follow the installation instructions for your platform. Do not continue if you cannot confirm the source. Updates also depend on the device: check the App Store for iPhone / iPad updates, and return to this site's download page for packages for other platforms. Before replacing an installation, keep a copy of your custom rules and connection settings. If behavior changes after an update, first confirm that the active file is the same as before, then adjust individual rules as needed.