Cross-platform rule-based proxy · Official manual

Shadowrocket for Mac Download and setup guide

Shadowrocket is a cross-platform client that can import existing servers or subscriptions and apply rule-based routing according to your configuration.

Current version 2.2.92 · iPhone / iPad: one-time $2.99 App Store purchase; other platforms are free

View the setup guide →
  • WireGuard
  • Global Routing
01 Devices and installers

Downloads for all platforms

iPhone / iPad: a one-time $2.99 App Store purchase. Mac, Windows, Android, and Linux versions are free, with installers available from this site. When downloading for another device, choose its platform directly rather than following the order for your current device.

iPhone / iPad

One-time App Store purchase: $2.99

Both devices use the same purchase. Check the App Store page for system requirements. On the product page, verify the developer and app ID before confirming your purchase. If you have already purchased the app and changed devices, look for it in the purchase history of the original account.

Mac

Free · Apple Silicon / Intel

Open About This Mac and check the Chip or Processor field. Choose the matching dmg rather than judging by the computer's appearance or purchase year. If macOS says the developer cannot be verified on first launch, verify the source, then follow the macOS security guidance on the download page.

Windows

Free · 64-bit exe

Go to Settings → System → About and confirm the system type before downloading the 64-bit installer. If SmartScreen appears, first make sure the file came from this site's download page. For organization-managed computers, follow your administrator's device policies.

Android

Free · arm64 apk

First confirm that your device supports arm64, then open the download page in a browser. If Android asks you to allow the current browser or file manager to install apps, verify the download source and grant temporary permission only to the app opening the file. You can turn off this permission after installation.

Linux

Free · deb / rpm / AppImage

Check which package format your distribution uses, then confirm the processor architecture. Install deb or rpm packages using your distribution's package manager. For AppImage, add execute permission to the downloaded file as instructed, then launch it.

View all platforms →

02 Modes and configuration

Rule-based routing and connection management

First identify whether you need to change one connection, one server, or the entire ruleset. Knowing the difference helps you decide whether to open Home, Config, or Settings.

Route connections according to matching rules

Open Global Routing in Home. Config uses the current rules to determine where connections go, Proxy routes traffic through the selected server, and Direct connects without a proxy. When using Config, first confirm which file is active, then check the specific rule and the fallback policy. If a domain does not behave as expected, check whether an earlier rule overrides it rather than reimporting a server or changing the entire configuration at once.

View routing modes →
DOMAIN-SUFFIX,example.com,PROXY

Example of a domain suffix match. Matching traffic uses PROXY.

03 First connection

Get started with Shadowrocket

The steps below use the iPhone or iPad interface as an example. Prepare an existing subscription URL or server details, test one connection first, then configure sync, rules, and On Demand.

  1. Add a server or subscription

    In Home, select Add Server. Choose the matching Type and enter the address, port, and credentials. For an existing subscription URL, choose Subscribe instead of pasting it into Host. Return to Home and select the saved entry.

  2. Choose a Global Routing mode

    Select Config to apply rules and confirm which configuration is active. To isolate routing issues, compare Proxy and Direct without changing the network or destination. If only Config fails, check the matching rule and fallback policy.

  3. Connect and verify

    Turn on the connection in Home. If prompted, authorize the VPN configuration you just requested. Run Connectivity Test, then try a familiar destination. If it fails, note the destination and routing mode before troubleshooting.

View the complete guide →

04 Access and verification

Verify the app and restore purchases

This official site and manual explain the two ways to get Shadowrocket, depending on your device. Before proceeding with pricing, accounts, or installation prompts, verify the store listing or installer source. Do not rely on a similar name or search result ranking.

App ID
932747118
  • Shadow Launch Technology Limited
  • Closed-source commercial app
  • 2 ways to get it
  1. Compare three details on the product page

    Open the App Store from the app verification guide. On the product page, first check the developer name: it should be Shadow Launch Technology Limited. Then compare the official icon shown on this page: a rocket with a blue-purple outline on a white background. Finally, check that the product link ends with id932747118. All three should refer to the same listing. If the name looks similar but the developer or app ID does not match, return to the download page and open the link again. Do not identify the app by an icon's color or name in search results.

    Check the App Store page for system requirements. If the page opens but the app cannot be installed, compare the compatibility information with your device's system details before deciding whether to update the system or use a compatible device. This is separate from whether the listing appears in search results.

  2. If the app does not appear in search, check your account's storefront

    This app is not listed on the mainland China App Store. Search results depend on the storefront associated with your current App Store account, not your phone's language or location. On iPhone or iPad, open Settings, tap your account name, then go to Media & Purchases → View Account → Country/Region to check the current storefront. Opening the US product page in a browser does not confirm whether your current purchase account can download the app.

    If the store says the app is unavailable in your region, first confirm that the account signed in to Media & Purchases is the one you plan to use for the purchase. If you need to change regions, review the prerequisites, such as account balance and subscriptions, on your account page. Changing the device language does not change the storefront. See Storefront and account region for details.

  3. Use the same account for purchases, device changes, and reinstallations

    The iPhone / iPad version is a one-time $2.99 purchase from the US App Store; the amount shown depends on your storefront. The Mac, Windows, Android, and Linux versions are free. iPhone and iPad share the same purchase. When changing devices or reinstalling, first confirm that the App Store is using the original purchase account, then find Shadowrocket in your purchased items. If you are still prompted to buy it, check the account and purchase history before confirming payment.

    Restoring a purchase restores eligibility to get the app; it does not recreate parameters you entered manually or automatically select your previous server. If you still have the old device, first check any saved configuration and sync status. After installing on the new device, confirm that the expected file is available in Config and the correct server is selected in Home, then test the connection.

  4. Distinguish the client from existing service details

    A one-time client purchase is not a service plan. The purchase record is for the client. The client reads your existing subscription, server details, or rules file; their validity period and traffic allowance are not determined by the purchase record. This site does not provide, sell, or recommend nodes or subscriptions. It only explains how to use information you already have.

    Before importing, identify whether you have a subscription URL, a set of server parameters, or a configuration file. A subscription URL refreshes server entries; manually entered details create a single entry; a configuration file defines how traffic is handled. Pasting a URL into the wrong field can cause an import error that has nothing to do with purchasing the client. When troubleshooting, describe the type of information and where the error appears, but do not share the full URL or authentication details.

  5. Update desktop and Android versions using installers from this site

    The iPhone / iPad version is a one-time $2.99 App Store purchase, and app updates are also handled through the App Store. The Mac, Windows, Android, and Linux versions are free; get the appropriate installer from this site's /dl/ path. Before downloading again, check which architecture or package format you used previously, especially the separate Apple Silicon and Intel Mac files and the Linux package and AppImage options.

    Before changing devices or updating, note the active configuration file, server, and mode. If the system blocks the first launch, verify the download URL and file type, then check the installation guidance for your system. Stop if the source is unknown or device policies do not allow installation. After updating, test the same destination again. This makes it easier to identify the cause than changing the network, server, and rules all at once.

05 Technical notes

Troubleshoot installation, battery use, and permissions

Choose an article based on when the issue occurs: check the package and system prompt if installation fails, background usage if the battery drains after connecting, or the system VPN configuration if authorization prompts keep appearing.

View all articles →