Official Guide · All Platforms

Shadowrocket Guide & Rule Setup

Shadowrocket is a cross-platform proxy client with multiple protocols and rule-based routing: iPhone / iPad access is a one-time App Store purchase; Mac, Windows, Android, and Linux versions are free.

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

First connection: follow the quick start guide

Download options

Shadowrocket for all platforms

iPhone / iPad access is a one-time $2.99 App Store purchase; check the App Store page for system requirements. Mac (Apple Silicon and Intel), Windows, Android, and Linux versions are free. Get their installers from /dl/shadowrocket/ on this site.

The “This device” label refers to the device currently browsing this site, which may not be the device where you plan to install Shadowrocket. When preparing an installer for another device, check its operating system and architecture. The browser can identify the system, but not the Mac chip type.

Desktop and Android installers are unsigned, so the system may show a warning during installation or the first launch. Check the download source and target platform, then read the installation instructions for your system. Do not open files from unknown sources.

View all platforms

Feature reference

Connection modes, routing rules, and diagnostics

Selecting a server, turning on the connection, and deciding how a request is routed are three separate actions. The examples below use the iPhone / iPad interface: a server provides connection parameters, the switch controls connection status, and Global Routing determines how requests are handled by the current configuration.

Global Routing
Config / Proxy / Direct

Config → Rule
Proxy  → PROXY
Direct → DIRECT

Start troubleshooting routing by reproducing the same request. Note the server, mode, and destination, then change one thing and compare the result. For example, when comparing Proxy with Config, keep the server and destination unchanged. Restore the original mode before checking rule order. This helps distinguish an unreachable server, a DNS issue, and an unexpected rule match.

First-time setup

Quick start for iPhone / iPad

These steps are for users who have installed Shadowrocket and already have server details or a subscription URL. Manual entry, QR code scanning, and subscription import are different methods. Choose the one that matches the information you have; there is no need to add the same details more than once.

  1. Import with Add Server or Subscribe

    Open the add menu from Home. If you have the details for a single server, check Type in Add Server, then fill in the required fields. If you have a server QR code, use Scan QR Code. For an existing subscription URL, choose Subscribe, save it, then return to Home and confirm that the entry appears under SERVER. If the list is still empty, check the import result and make sure the original details are complete. Do not enter a subscription URL in Host.

  2. Select a server and check Global Routing

    In SERVER, confirm that the server you want to use has a dot beside it. For rule-based routing, select Config and check which configuration file is active. To test the same destination, you can temporarily compare with Proxy or check the direct route with Direct. The dot indicates the current selection, not that the server has passed a test. After selecting another entry, test the connection again.

  3. Turn on the switch and run Connectivity Test

    Return to Home and turn on the connection switch. The first time, follow the system prompt to approve the VPN configuration used for the connection. Then run Connectivity Test and visit a known working destination. If the test responds but the destination does not open, treat them as separate results. Keep the current server and check the mode, DNS settings, and rule match in order. Use the same destination for comparisons, then restore any temporary changes when you finish.

View the full guide

Product information

Verify the app, purchases, and recovery

Shadowrocket is a closed-source commercial app. To verify the iPhone / iPad version, check the developer, official icon, and app ID on the App Store product page. For desktop and Android versions, confirm that the installer came from this site’s download page; a filename or icon alone is not enough.

Check three details on the product page

  1. Developer: Check the full spelling of Shadow Launch Technology Limited, not shortened text in search results.
  2. Official icon: Check the white icon with a blue-purple outlined rocket on the product page. The icon can help identify the app, but should not be the sole basis for a purchase.
  3. App ID: Check that the end of the product link is id932747118. Use the same method to verify listings with similar names or icons.

App Store availability and account region

Whether the product appears in App Store search depends on the storefront used for purchases; the device’s display language does not set the storefront. If you cannot find it, open the product page to check whether the app is available in the current storefront, then check the country or region in your Apple Account settings. If the page appears but the device reports incompatibility, review the compatibility information on the product page. System requirements are as listed on the App Store page.

If the current storefront does not offer the app, do not substitute a search result with a similar name. Before changing your account region, read the account settings notices about any existing balance, subscriptions, and payment methods. Do not change regions just to recover a previously purchased app; check the original purchase record first.

Restore a purchase on another device

iPhone and iPad share the same purchase. When changing devices or reinstalling, first confirm that the App Store is signed in with the Apple Account originally used to purchase Shadowrocket, then look for it in purchased items. If the product page asks you to buy it again, check the account and purchase record before paying again. App purchase records and in-app settings are managed separately. After reinstalling the app, check whether your own server details, subscriptions, and current configuration have been restored.

Get app updates through the App Store, or enable automatic updates in system settings. To recheck the connection after an update, first look at the server marker and Global Routing mode in Home. If you used On Demand before changing devices, also confirm that the new device’s settings are as expected.

Desktop and Android installers

Get Mac, Windows, Android, and Linux installers from the platform sections on this site at /dl/shadowrocket/. To update, return to the section for your platform and get the matching package again. If you have a new computer, check its chip or architecture instead of reusing the previous device’s selection. Linux users should also confirm that the package format suits their distribution. If the system displays a warning or installation fails, check the file source, architecture, and installation method.

Reading index

Shadowrocket technical notes

The connection switch, rule results, and traffic readings answer different questions. First check whether a request completes, then whether it matches the expected policy, and finally compare traffic changes. Choose an article based on the issue you encounter; there is no need to redo the entire configuration.

Download Shadowrocket