Official ManualGet the App and Set Up a Connection

ShadowrocketSetup Guide

Shadowrocket is a cross-platform client that routes connections according to rules. The iPhone / iPad version costs $2.99 as a one-time App Store purchase; the Mac, Windows, Android, and Linux versions are free.

Current version v2.2.92 · Free for Mac, Windows, Android, and Linux

First connection tutorial →

Global RoutingOn DemandConnectivity Test

Initial setup

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

View the full tutorial →
  1. Step 01

    Add existing details in Home

    For a single server entry, open Add Server, check Type, and fill in the corresponding fields. If you have a subscription URL that manages a group of servers, choose Subscribe to import it. Return to Home and confirm that the entries appear in the SERVER group. Importing saves connection details; it does not establish a connection. First identify which server you want to test—you don't need to change routing rules yet.

  2. Step 02

    Check Global Routing

    Config routes traffic according to the active configuration, Proxy sends everything through the proxy, and Direct connects directly. To test the rules in your configuration, select Config and make sure the active configuration is the one you just checked. To tell whether the proxy connection is failing or a rule is routing traffic incorrectly, briefly switch modes and compare. Note the original setting and restore it after testing.

  3. Step 03

    Connect and test in Home

    Select the server you want to use and confirm the dot appears next to it, then turn on the connection switch. On the first connection, follow the system prompt to approve adding a VPN configuration. Use Connectivity Test to check the selected server, then try a destination you use regularly. A successful test doesn't mean every destination will work. If only certain destinations fail, check their matching rules first; there's no need to reimport the entire server group.

Two ways to get the app

Choose a Shadowrocket download for your device

The iPhone / iPad version costs $2.99 as a one-time App Store purchase; Mac, Windows, Android, and Linux versions are free, with installers available from this site at /dl/. When switching devices, choose the download for the new device's operating system rather than reusing an installer from the old one. If the system displays a prompt, first check the download source and package type, then compare the prompt with the installation instructions.

See all platforms →

Configuration and diagnostics

Shadowrocket features

First identify whether you need to change a server, when the connection starts, or how a particular destination is routed. Check server details in SERVER; On Demand conditions control when a connection starts; Global Routing and the active configuration determine whether a destination goes through a server.

Rules & Routing

Set a route for each destination based on matching conditions.

In Home, set Global Routing to Config, then open Config and check the [Rule] section of the active file. Rules are matched in order, and the first match determines whether traffic uses PROXY, DIRECT, or REJECT. FINAL applies only if no earlier rule matches. To handle a specific domain differently from its subdomains, place its DOMAIN rule before a broader DOMAIN-SUFFIX rule. Change one rule at a time when testing so you can identify what caused the result.

DOMAIN-SUFFIX,example.com,PROXY
See how to set the routing mode →

Purchases and restores

How to verify and get the genuine Shadowrocket app

Developer Shadow Launch Technology Limited App ID 932747118 Two ways to get the app and pricing

Check the developer, icon, and App ID on the product page

Search results may show similarly named apps. Open the App Store product page from the download page, then confirm the developer is Shadow Launch Technology Limited. Compare the store icon with the official icon used on this site, and check that the product page URL ends in id932747118. Similar names and icons aren't enough—verify both the developer and App ID. If either doesn't match, return to the product page and check again rather than choosing based on search result order.

If the app doesn't appear in the store, check your account's region

App Store availability depends on the storefront associated with the Apple Account used for Media & Purchases. If you can't find the app or its product page says it's unavailable, check your account's current country or region and confirm the product is offered in that storefront. Your device language and system region are separate from your store account's region; changing the display language won't change what's available to buy. Before changing your account region, check your balance, subscriptions, and payment method as prompted by the system. Check the App Store page for system requirements.

Check your purchase history when reinstalling or switching devices

The iPhone / iPad version costs $2.99 as a one-time purchase in the US App Store, and one purchase can be used on both types of device. The Mac, Windows, Android, and Linux versions are free. On a new device, sign in to the App Store with the account used for the original purchase and find Shadowrocket in your purchase history. If the page still asks you to pay, check that you're using the right account and that the app is available in your current storefront. Purchase history lets you restore the app; it doesn't transfer configuration or server details. If your old device still works, first confirm which settings you need to keep.

Buying the client doesn't buy a server plan

Shadowrocket is a closed-source commercial app. Your purchase grants the right to use the client; it doesn't include a server, subscription URL, or traffic allowance. This site does not provide, sell, or recommend servers or subscriptions. Before connecting, make sure you already have your own server details or a subscription URL from a service provider you already use. If the server's port, authentication method, or subscription URL changes, your app purchase won't update those details automatically.

Update through the appropriate channel for each platform

Check for updates in the App Store on iPhone / iPad. For Mac, Windows, Android, and Linux, choose a new installer by operating system and architecture from this site's download page. Before updating, consider keeping a recoverable copy of your current configuration, especially manually maintained rules and individually added server entries. After updating, test the connection with the same server, Global Routing setting, and destination. If anything changes, this makes it easier to tell whether the configuration changed or the connection itself is having a problem.

Related reading

Rules and connection guides

View all articles →