Official Manual

Shadowrocket Config Center

Cross-platform client download and setup guide: import an existing server or subscription, choose rule-based routing, then test the connection.

Current version 2.2.92iPhone / iPad $2.99 one-time · Mac / Windows / Android / Linux free

Read the guide

01 Feature Reference

Routing, imports, and diagnostics

First identify whether the issue concerns connection timing, server details, or traffic routing. The connection toggle, selected server, and rule match each answer a different question. One working correctly does not mean the others are correct.

Choose a mode, then inspect the rules

  • From Home, open Global Routing. When Config is selected, traffic is routed by the active configuration. Verify which file is in use before checking its rules.

  • Proxy and Direct provide a one-off comparison between proxying and a direct connection. After testing, switch back to your regular mode. A temporary comparison does not mean the rules are fixed.

  • Rules are evaluated from top to bottom. Place narrower rules before broader ones. After editing, retry the same destination and confirm that FINAL still behaves as expected.

See how to use Global Routing
[Rule]Match order
  1. DOMAIN-SUFFIX,example.com,PROXY
  2. GEOIP,CN,DIRECT
  3. FINAL,PROXY
example.comExample domain
  • First match uses PROXY
  • Only unmatched traffic continues to FINAL

02 Platform downloads

Get Shadowrocket for your device

Two ways to get Shadowrocket: iPhone / iPad from the App Store for a one-time $2.99; Mac / Windows / Android / Linux versions are free, with installers distributed from this site at /dl/. The links below open the details for each device on the download page.

View all platforms

03 First-time setup

Three steps from import to testing

The interface paths below use iPhone / iPad as an example. Before starting, prepare an existing subscription or server details, and choose a destination you can normally access for testing. Check the result at each step before continuing.

  1. Add Server: import based on your details

    In Home, open Add Server, select the protocol under Type, then enter the address, port, and authentication details. If unsure, check the original details.

    Use Subscribe to import an existing link. Back in Home, confirm the entries appear, and recheck your selection after an update. Importing does not test reachability.

    See how to import and update
  2. Global Routing: choose where traffic goes

    Config follows the active configuration, Proxy uses the proxy, and Direct connects without it. If a domain is routed unexpectedly, check for an earlier matching rule.

    To compare modes, keep the server and destination fixed. Record the result, then restore your original mode. A difference alone does not identify a faulty rule.

    See how to choose a mode
  3. Home: connect and visit the destination

    In Home, select the intended entry and turn on the connection. Follow the first-time VPN setup prompt only if your action triggered it. The toggle alone does not prove reachability.

    Run Connectivity Test, then open your test page. If the results differ, note the network, mode, and destination. Check server reachability, DNS, and routing one at a time.

    See connection troubleshooting
View the full guide

04 Verify your purchase

Authenticity, purchases, and device changes

Verify the download source and store listing before managing your account, restoring a purchase, or updating. Shadowrocket is a closed-source commercial app; this page is the entry point to the official Shadowrocket website and manual.

Official Shadowrocket app icon
Shadow Launch Technology Limited App ID: 932747118
Verify the official listing
  1. Check the developer, icon, and app ID

    Open the App Store product page from the download page. Check that the developer is Shadow Launch Technology Limited, compare the listing with the official icon on the left, and confirm the product URL ends in id932747118. Do not rely on an abbreviated name, search ranking, or icon color alone. For similar listings, all three checks should point to the same product.

    If the search result shows only brief details, open its product page to verify, or return to the download page and reopen the listing. The app ID identifies the listing; it is not an order number. Check your purchase history for orders rather than relying on search results.

  2. Store availability depends on your account region

    If you cannot find the product in the mainland China App Store, check the country or region used by your account under “Apple ID → Media & Purchases” in system settings. The system language and your device's physical location are separate from the store region. Changing the language does not change where the product is available.

    If you need to change the store region, first check whether your account balance, active subscriptions, payment method, or Family Sharing will be affected, then follow the instructions in system settings. If the store says the item is unavailable in your region, keep your original purchase record for reference rather than choosing a similar listing.

    Read about App Store regions
  3. One-time purchase and restoring on a new device

    On the US App Store, Shadowrocket costs $2.99 as a one-time purchase for iPhone / iPad, and the same purchase can be used on both device types. The Mac / Windows / Android / Linux versions are free. The displayed price is subject to the store page; system requirements are as listed on the App Store page.

    When switching devices or reinstalling, use the original purchase account to check your App Store purchases and reinstall the app. If it is not in the list, first check the account used for Media & Purchases and the original order, then check the store region. Restoring the app is separate from restoring your server list, subscriptions, and configuration. Before reinstalling, identify which settings you need to keep.

    See how to restore a purchase
  4. App purchase ≠ service subscription

    Purchasing the client grants the right to use the app. Imported servers or subscriptions are service details you already have. Buying, reinstalling, or updating the app does not generate servers, renew an existing subscription, or change its availability. This site does not provide, sell, or recommend servers or subscriptions.

    If the app opens normally but a list update fails, determine whether the subscription URL is unreachable, the service details have changed, or the client's connection settings differ from what you expect. Keep the original entry for comparison while troubleshooting. Do not share complete subscription URLs, authentication details, or configuration backups.

    Troubleshoot subscription updates
  5. Update channels and platform choice

    Check iPhone / iPad app updates in the App Store; automatic updates can be managed in system settings. For Mac, Windows, Android, and Linux, get the corresponding installer again from this site's download page. For Mac, choose Apple Silicon or Intel as appropriate; for Linux, check the architecture and package type. Do not reuse a package selected for an old device on a new one.

    Before updating, note the active Config and frequently used server entries, and back up important configurations using the method provided by the app. After updating, check that the files and entries are still as expected, then test the same destination on the same network. This helps distinguish changes after an update from network fluctuations.

    View client download options

05 Technical notes

Store listings, configuration files, and setup

Choose a note for the issue at hand: check the store region if the app is missing from search, identify the sections if a configuration file is unclear, or start with the connection toggle and mode for a first connection.

Store & Account

Can't find Shadowrocket in the mainland China App Store: how Apple ID region affects store availability

Follow the system menus to check the store used for Media & Purchases, then compare the product page's availability. The article distinguishes account region, device language, and app availability, and lists balances, subscriptions, and payment settings to check before changing regions. To restore a purchase, first confirm which account was used, then check your purchase history.

Getting Started

How to use Shadowrocket: answers to 10 common beginner questions

Find answers to first-time questions about Home, Global Routing, and subscription updates. If a page does not open after connecting, first check whether the issue affects every destination, then review the server, mode, and request to find what to inspect next.

View all articles