Rule-based proxy client for all platforms · Official guide

ShadowrocketGuide & Downloads

Available across platforms with rule-based routing. iPhone / iPad: a one-time $2.99 purchase on the App Store. Mac, Windows, Android, and Linux versions are free.

Current version v2.2.92 · Mac, Windows, Android, and Linux versions are free

  • Global Routing
  • On Demand
  • Subscribe

Feature reference

Routing setup & connection management

Keep three things distinct: the server determines where a connection can go, rules determine which requests use a proxy, and Global Routing determines whether rules are applied for the current configuration. When a connection fails, note the current selections and check them one at a time. Changing the server, policy, and network environment together makes results difficult to compare.

Route traffic by match order

In Home, set Global Routing to Config, then check the match order under Rule in the active configuration. Rules are usually evaluated from top to bottom. Put domains that need special handling before broader rules, and leave FINAL as the policy for requests with no match. The syntax on the right is for reference, not a complete configuration to apply as-is. After editing, test the same known address again. Confirm that the request matched the expected rule and that an earlier entry did not handle it first.

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

Read about proxy modes and routing rules

Download options

All platforms How to get it

iPhone / iPad: a one-time $2.99 purchase on the App Store; check the App Store page for system requirements. Mac, Windows, Android, and Linux versions are free, with installers available from this site at /dl/. Choose based on the device and processor you use. If preparing an installer for another device, you do not need to choose the option marked for your current device.

View all platforms

First connection

Add a server, choose a mode, and test the connection

The steps below use iPhone / iPad as an example. Before you begin, have your existing server parameters or subscription ready, and choose an address you can use to test the current network. Start with one manual connection, then set automatic trigger conditions as needed. This makes it easier to tell whether an issue is related to importing, routing, or a network change.

  1. Add existing details in Add Server or Subscribe

    To add a single server manually, open Add Server from Home, choose Type, then fill in the required fields using the existing parameters. To add a group of servers, enter the link obtained from your service provider in Subscribe. After saving or importing, return to Home and find and select the entry you want to test in SERVER.

    An entry appearing in the list only confirms that it was entered or imported. If you cannot find the server you just added, first check whether it went into the expected group, then verify its name, protocol, and address. Do not import it repeatedly to test connectivity. For managing multiple subscription groups or moving entries, see the server management manual.

  2. Choose a mode in Global Routing for your current goal

    To check whether rules are working, select Config and verify the active configuration. To test whether the proxy works first, temporarily select Proxy. To check basic connectivity without a proxy, select Direct. Config, Proxy, and Direct handle connections differently; switching modes does not rewrite rules in the configuration file.

    When comparing test results, try to use the same server, destination, and network. If Proxy works but the same destination does not work in Config, check whether a different policy matched. After testing, switch back to the mode you actually need so a temporary setting does not become your daily setting.

  3. Turn on the switch in Home and test access

    Return to Home and turn on the connection switch. If the system prompts you to add a VPN configuration for the first time, first confirm that the prompt came from the Shadowrocket action you just took, then follow the system instructions. After the connection status changes, run Connectivity Test and then open the address you selected earlier. An enabled switch and access to the destination are two separate checks.

    If the destination is still unreachable, first check that the device itself is online, then verify the server selection and Global Routing. If only certain addresses have issues, check the relevant rules, DNS, and Diagnostics. Change one thing at a time during testing and record the results before and after each change so you can restore the last known working settings.

Read the complete guide

Verify the official listing

App identity & purchases

Official Shadowrocket app icon
App
Shadowrocket
Developer
Shadow Launch Technology Limited
App ID
932747118

Check three details on the App Store product page

Open the App Store product page from the iPhone / iPad option on the Getting the App page. First confirm the developer is Shadow Launch Technology Limited. Then compare the white background and blue-purple outline with the official icon on this page. Finally, check that the product page link contains id932747118. When names and icons look similar, the app ID helps distinguish listings. If a search result does not match these details, return to the product page and verify it rather than relying on search ranking or name alone.

Check the account's storefront before checking availability

The App Store displays products based on the region associated with the purchasing account; the app is not listed in the mainland China storefront. If you cannot find it in search, open Settings, go to Media & Purchases for your Apple Account, and check the account's country or region. The device language and your current location do not replace this check. If you plan to change the account region, first check that your balance, active subscriptions, and payment method meet the system requirements. If you only need to restore a purchase, first check the original purchasing account and purchase history.

After switching devices, restore the app and then check the configuration

iPhone and iPad use the same one-time purchase under the same purchasing account. When switching devices or reinstalling, sign in to the original purchasing account, open App Store purchases, find Shadowrocket, and download it again. If the purchase does not appear, first confirm which account is used for Media & Purchases, then check availability in the current storefront. Restoring the app does not restore the server list. If the old device is still usable, note the current configuration and groups first. After installing on the new device, check the required files and entries one by one.

App pricing and connection services are separate

iPhone / iPad: a one-time $2.99 purchase in the US App Store; prices in other storefronts are shown on their product pages. Mac (Apple Silicon and Intel), Windows, Android, and Linux versions are free. Shadowrocket is a closed-source commercial app. A one-time app purchase is not a connection plan. This site provides app downloads and the official guide; it does not provide, sell, or recommend servers or subscriptions. Use your existing server details to configure a connection, and get subscription links from your service provider.

Use the relevant platform's download channel for updates

Check for updates in the App Store on iPhone / iPad. For Mac, Windows, Android, and Linux, get the corresponding installer again from this site's download page; files are provided through /dl/. Before updating, note the currently active configuration and keep a recoverable copy if needed. After updating, open the configuration and server you used before and test the connection. If behavior changes, check the current selections and system permissions before editing routing rules.

Further reading

Rule syntax, connection troubleshooting, and app verification

Choose a topic based on what you are seeing: before editing a configuration, understand the match scope of each keyword; if the switch is on but access fails, test the server, mode, and DNS separately; if store listings share a name, verify the app identity before proceeding.

View all articles