Official site · Official manual

Shadowrocket Setup & downloads

Cross-platform rule-based proxy client with guidance on importing subscriptions and rule-based routing. iPhone / iPad: $2.99 once on the App Store; Mac, Windows, Android and Linux: free.

Current version Loading · iPhone / iPad: $2.99 once; Mac, Windows, Android and Linux versions are free

Trojan Config On Demand
iOS / iPadOS / macOS / Windows / Android / Linux Global Routing · Rule-based routing 2 ways to get the app

DOWNLOAD / GET IT FOR YOUR DEVICE

Shadowrocket on every platform

Check your device and processor, then open the relevant download section. Shadowrocket is available for phones, tablets and computers. Check existing server parameters against the fields on each platform; installing the app does not configure a connection.

iPhone / iPad

$2.99 once on the App Store; Mac, Windows, Android and Linux are free.

iPhone is convenient for switching servers on the go; iPad makes it easier to review parameters and manage configurations side by side. One Apple ID purchase can be used on both devices. To download again, first check your purchased items. System requirements are as listed on the App Store page.

Mac

Free · Apple Silicon / Intel; iPhone / iPad: $2.99 once on the App Store; Windows, Android and Linux are free.

Open “About This Mac” to check whether your Mac has an Apple chip or an Intel processor, then choose the corresponding installer. Downloads are provided separately for both architectures; do not identify yours by appearance or purchase year. Save a copy of your existing configuration before migrating it.

Windows

Free; iPhone / iPad: $2.99 once on the App Store; Mac, Android and Linux are free.

The download page provides a 64-bit Windows installer. Before configuring the app, check that your local network works, then enter your existing server details. If only one app cannot connect, check whether it uses the system proxy and which rule matches its request.

Android

Free; iPhone / iPad: $2.99 once on the App Store; Mac, Windows and Linux are free.

The download page provides an arm64 package. After installation, import your own subscription and check the server Type, Host and Port. When the system first asks to establish a VPN connection, review the permission prompt. If the connection drops in the background, check the device’s battery and background activity settings.

Linux

Free · deb / rpm / AppImage; iPhone / iPad: $2.99 once on the App Store; Mac, Windows and Android are free.

Choose deb, rpm or AppImage according to your distribution’s package format, and check your device architecture. AppImage needs execute permission before its first run. If the interface opens but requests fail, check the desktop session’s proxy settings separately from the client’s connection status.

View all platforms →

REFERENCE / FEATURES

Rule-based routing and connection settings

Server parameters determine how to establish a connection; Global Routing determines which requests use it. Understand the difference before enabling features. Interface terms below remain in English so you can match them to the app.

Global Routing and rule order

In Global Routing, Config matches requests against the current configuration, Proxy sends eligible requests through the selected proxy, and Direct connects without a proxy. To use rule-based routing, check the current configuration first, then select Config. Rules are generally matched in order, so put specific domain conditions before catch-all rules. FINAL handles requests that did not match earlier rules. After making a change, test the same destination. Do not change both the server and rules at once, or it will be difficult to identify what affected the result.

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

If you are unsure about DOMAIN-SUFFIX, GEOIP or FINAL, first identify what each rule matches, then choose a policy. The order of servers in the list affects selection and lookup, not the rule order in Config.

View the quick glossary →

QUICKSTART / STEPS

First connection in three steps

The steps below follow a common iPhone / iPad workflow. Before starting, have your existing subscription or server details ready, and make sure your local network works with the proxy off. Installing the client does not automatically create a usable server. If any parameters are missing, get the complete information from your service provider first.

  1. Add Server: import, then check

    Open Add Server from Home. For an existing subscription, use Subscribe; to enter details for an individual server, choose the Type and fill in the fields; for an existing QR code, use Scan QR Code. After saving, return to the server list and check that the entry appears in the expected group and has a recognizable name. QR codes and clipboard contents may include credentials. Check their source before importing and do not share the full contents afterward.

    If the list is empty, distinguish between an address that was not saved, a failed subscription update and unrecognized response content. For manual entry, first check that Host does not include an unintended protocol prefix, Port is in the correct field, and credentials contain no extra spaces. Do not combine fields from multiple protocols in one server entry.

  2. Global Routing: choose how requests connect

    Select the server you want to test, then check Global Routing. Config mode routes traffic according to the current configuration; Proxy mode is useful for comparing the proxy path during troubleshooting; Direct mode checks direct connectivity. Before choosing Config, confirm that PROXY, DIRECT and the final policy in the configuration match your expectations. Do not enable a file simply because it is present.

    For the first test, keep conditions simple and use the same destination page. If Proxy works but Config does not, check the rules, DNS and policy selection first. If both modes fail, return to the server parameters and local network. Switching modes does not fix authentication errors or change the server access provided by your service provider.

  3. Connection switch: allow access and test requests

    Turn on the switch at the top of Home and confirm the VPN configuration when prompted by the system. Once a connection status appears, run Connectivity Test, then open the app you want to use. A system indication that a connection was established only confirms that the process reached a certain stage; it does not mean every domain is reachable. Check the specific request and error details.

    For problems, check in this order: “local network → server authentication → mode and rules → DNS and destination service.” Change one setting per test and note what happens before and after. Set up On Demand only after manual connections are stable. When using multiple devices, validate the configuration on one device before arranging sync or backups.

View the complete guide →

IDENTITY / ACCESS AND PURCHASE

Verify the app and usage scope

  1. 01 / Developer and icon

    Check three details on the store page

    On the App Store product page, check the developer, Shadow Launch Technology Limited, the official icon and the app ID 932747118. The official icon has a blue-purple outline on a white background; the icon at the top of this page is the same. Similar names in search results are not enough to confirm an app’s identity. Open its product details and check each item.

    iPhone / iPad: $2.99 once on the App Store; Mac, Windows, Android and Linux versions are free. Do not attribute the price or reviews of other listings to Shadowrocket, and do not rely on search ranking to identify the app. For desktop and Android, open the download page on this site; installers are provided through this site’s download paths.

    See how to verify the app →
  2. 02 / Storefront and account region

    Check your current App Store storefront

    This app is currently unavailable on the mainland China App Store. If you cannot find it, first check the region of the Apple ID used for “Media & Purchases,” then check availability in that storefront. Device language, system region and store account region are separate settings. Check the current App Store product page for availability.

    If you need to change your account region, use the “Country/Region” setting in your Apple Account and first review the listed requirements for balance, payment methods and existing services. Do not repeatedly change device settings just to affect search results. Check the App Store page for system requirements and confirm your device meets them before downloading.

    Storefront and region guidance →
  3. 03 / Purchased items and recovery

    One purchase for iPhone and iPad

    iPhone / iPad: $2.99 once on the App Store; Mac, Windows, Android and Linux: free. The purchase can be shared between iPhone and iPad using the same Apple ID. When changing devices or reinstalling, use the original purchase account to check your purchased items, then download again. App purchase history and server parameters stored inside the app are separate; restoring the app does not necessarily restore all local settings.

    If the store still displays a price, check the current purchase account, purchase history and product ID before considering another purchase. Before resetting an old device, back up configurations as needed and keep your subscription information safe. For iCloud content, confirm that syncing has completed, not just that the switch is on.

    Restore from purchased items →

App purchase ≠ network service

Shadowrocket is a closed-source commercial app. It reads server details, establishes connections and applies routing rules. iPhone / iPad: $2.99 once on the App Store; Mac, Windows, Android and Linux: free. Neither way of getting the app includes network service. This site does not provide, sell or recommend nodes or subscriptions; it explains how to manage information you already have.

Get subscription links from your service provider. Confirm link validity, permitted devices, available servers and usage limits under the terms of your existing service. Data statistics in the client may use a different measurement scope from your provider’s records; the number in one interface cannot determine the bill on the other side. If the list is empty after purchase, import your details rather than waiting for servers to appear automatically.

Update the client and subscription separately

Update the iPhone / iPad app through the App Store. For Mac, Windows, Android and Linux, get the corresponding installer from this site’s download page. The current version on the page is read dynamically from the download manifest. If the version has not loaded, open the download page and check your platform; do not infer current release details from example parameters in an article. Follow system prompts during installation and permission approval.

Subscribe updates server content; it does not upgrade the app. Updating a Config file is a separate operation. After a subscription update, check that the currently selected entry still exists. Keep a working copy before updating the client or replacing a configuration. If a problem occurs, identify whether the app settings, server list or rules changed, then narrow down the troubleshooting scope.

Continue to the subscription and server management manual →

READING / TOPIC GUIDES

Recent Shadowrocket articles

After your first connection, read guides relevant to your situation. Start by identifying the mode and request path, then adjust individual rules. Examples explain formats and limitations; they do not replace the actual parameters for your server.

View all articles →