Official site · Official guide

Shadowrocket Mobile Setup, installation and usage guide

Cross-platform client for managing connections with rules. Supports rule-based routing; iPhone / iPad: $2.99 one-time in the App Store; other platforms are free.

Free downloads

Free for Mac, Windows, Android and Linux

Current version v · Mac, Windows, Android and Linux versions are free; iPhone / iPad are a one-time App Store purchase for $2.99.

iPhone / iPad

One-time App Store purchase: $2.99

One purchase covers iPhone / iPad; Mac, Windows, Android and Linux versions are free. Check the App Store page for system requirements.

First-time setup: subscription import and connection steps →

Shadowrocket features and configuration

Match rules in order, then apply the corresponding policy

Rule routing determines which policy handles a connection. On Home, select Config under Global Routing to have the client process requests using the current configuration. Rules are usually evaluated from top to bottom; the first match determines the result, while FINAL handles requests that did not match earlier rules. Before editing, confirm that the policy name exists, then check the domain, address range and rule order. When troubleshooting a website, check which rule actually matched instead of judging traffic flow only by whether a server is selected.

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

Get Shadowrocket for every platform

iPhone / iPad: $2.99 one-time in the App Store; Mac, Windows, Android and Linux versions are free. Choose installation instructions by device instead of guessing from a filename.

iPhone / iPad

$2.99 one-time in the App Store; other platforms are free. Both devices share one purchase. Check the App Store page for system requirements. First confirm the app and the account used for the purchase, then check the acquisition status shown on the store page.

Mac

Free, with separate installers for Apple Silicon and Intel; iPhone / iPad are a one-time App Store purchase for $2.99. Check the chip in About This Mac, then choose the matching file on the download page to avoid selecting the wrong architecture.

Windows

Free, with a 64-bit installer; iPhone / iPad are a one-time App Store purchase for $2.99. Quit any running client before installation. When it is complete, check existing configuration and system network status before testing the connection.

Android

Free, with an arm64 package; iPhone / iPad are a one-time App Store purchase for $2.99. Open the download page in your system browser, check the saved file and its source, then follow the system prompts to grant installation permission.

Linux

Free, with deb, rpm and AppImage packages; iPhone / iPad are a one-time App Store purchase for $2.99. Choose a file according to your distribution and package manager, read the permission notes, then follow the relevant installation steps.

View all platforms →

First installation: verify the source, then handle system prompts

Get desktop and Android installers from this site's download page. Files are hosted under /dl/shadowrocket/ on this site. The system may block the first launch. If Windows displays a SmartScreen prompt, confirm the file came from this site, then select “More info → Run anyway” to continue. On Mac, find “Open Anyway” for the app under “Privacy & Security.” On Android, allow “Install unknown apps” for the browser or file manager you are using; you can revoke this permission afterward.

AppImage on Linux requires execute permission; install deb and rpm packages using your distribution's package management process. If Mac displays a warning such as “is damaged,” first verify the file source and installation location, then follow the specific steps on the download page. Do not disable the system's overall security settings. Prompt wording varies by system; the installation permission guide brings the steps together so you can check them before proceeding.

Verify the app and understand the purchase

Before importing a configuration, distinguish app purchases, installation sources and connection services.

App verification

Developer, icon and app ID

On the App Store product page, verify the name Shadowrocket, the official icon and the developer Shadow Launch Technology Limited. The app ID is 932747118 and also appears in the product page URL. Search results may include similarly named apps, so open the details page to verify it instead of relying only on the name or listing position.

Shadowrocket is closed-source commercial software. Client features and purchase status are shown on the relevant product page and in the app. For desktop and Android, use the installation packages on this site's download page; do not rely on similar names, file icons or webpage descriptions to verify a source.

When checking the store, make sure you are viewing the app details, not an article, search suggestion or another listing. Save the product page link so you can use the same app details to check purchases, updates and purchase restoration later, reducing confusion if search results change.

How to verify the app →
Two ways to get it

Purchases and restoring on a new device

iPhone / iPad: $2.99 one-time in the App Store. Mac, Windows, Android and Linux versions are free. The store displays the local currency for your storefront, so check the amount before paying. iPhone and iPad share one purchase. Use the purchasing account to restore it on a compatible device; reinstalling does not mean you need to buy it again.

After changing devices, first check the account used for “Media & Purchases,” then find Shadowrocket in App Store purchases. If a price is still shown, check the account, purchase history and app ID before considering another payment. Restoring an app purchase and restoring configuration are separate tasks; rules and server details from the old device need to be checked separately.

This app may not be available in the mainland China App Store. App visibility depends on the store region, so check the region of the account used for purchases, not just the device language. Before changing regions, review the balance, subscriptions and payment method requirements shown on the account page.

Read the App Store guide →
Service scope

Buying the client ≠ buying a connection plan

Shadowrocket manages existing server details and connection rules. Getting the app does not include a connection service. This site does not provide, sell or recommend servers or subscriptions. Get subscription links from your service provider. If using your own server, prepare its protocol, address, port and authentication details first.

A successful import means the client has read the content; it does not guarantee that the remote service is available. Check service duration, server status and authentication changes with your service provider. The client's connectivity tests, rule records and Diagnostics can help locate a problem, but cannot replace the remote service itself.

Keep any configuration you need before updating the app. Update iPhone / iPad through the App Store; get desktop and Android installers from this site's download page. After updating, check the current configuration, selected server and Global Routing before resuming your usual workflow, so you do not mistake a settings change for a connection service issue.

Subscriptions, servers and Config →

First connection: import, choose a mode, verify

The preview below uses the iPhone / iPad interface. Check the result at each step before moving on.

  1. Step 01

    Add Server: import existing details

    First identify whether you have a subscription link, a single server link or server details to enter manually. Get subscription links from your service provider; in Add Server, select Subscribe and enter the complete URL. For a single server, choose Type based on the original details, check Host, Port and authentication fields, then save and return to Home to view the SERVER group.

    If using Scan QR Code, first confirm the source of the QR code and check the result after scanning. If the list is empty after import, stop here and check the address and update result. Do not change Global Routing or repeatedly toggle the connection first. Once the entry appears, select one server for the initial test and avoid changing multiple configurations at the same time.

  2. Step 02

    Global Routing: choose Config / Proxy / Direct

    Config processes connections using the rules in the current configuration, suitable when you have existing rules and want to route traffic by destination. Proxy handles traffic managed by the client using the proxy, which helps with targeted connection comparisons. Direct connects without a proxy. Do not assume that requests are going through the selected server just because the top-level switch is on.

    When using Config for the first time, open Config to confirm the active file and check the policy names referenced by its rules. During troubleshooting, note the original mode, change one setting for comparison, then restore the original setting after the test. A mode describes how traffic is handled; it does not guarantee access to every destination. Results also depend on the rules, server and current network.

  3. Step 03

    Home: connect and verify real access

    After confirming the server and mode, turn on the connection switch. If the system asks for VPN configuration permission for the first time, verify the app name and follow the system prompts. Return to Home to check the connection status, run Connectivity Test for an initial check, then visit the actual destination you need. Check test responses and access to the actual page separately rather than relying on just one.

    If the connection fails, first check whether the local network works, then verify server authentication and protocol settings. If only some destinations fail, check matched rules, DNS and remote status. Change one setting at a time and record what happens before and after. If the connection resumes after being turned off, check the On Demand conditions in Settings to avoid mistaking automatic reconnection for a faulty switch.

Read the complete guide →

Distinguish three items before configuring

A server entry describes where to connect and which protocol and authentication to use. A subscription updates a set of server details from a remote source. Config determines rules and related handling. These three work together but are not interchangeable. Changing servers may leave the rules unchanged, and updating a subscription does not switch the active configuration. Checking in this order is usually easier than deleting everything and starting over.

When preparing information for help, note the screen, current mode, failed destination and error message. Server passwords, subscription URLs and QR codes may contain access credentials, so do not include them in public screenshots. Keep a verified working configuration to help distinguish problems caused by recent changes from changes in the network itself.

Frequently asked questions

The connection is on. Why is traffic still going direct?

First check whether Global Routing is set to Direct. If it is set to Config, check the rule and policy that matched the destination. The switch controls connection status; it does not determine where every request goes. See the quick reference for definitions.

Why didn't the active configuration change after updating a subscription?

The subscription list and Config are separate. After updating the server list, also check the selected server and active configuration. See subscriptions and configurations for details.

Does a latency response mean actual access is working?

Not necessarily. Test Method, the test destination and the actual request path may differ. Check destination access, matched rules and Diagnostics together. See connection and diagnostics terms.

Connection setup and troubleshooting articles

Start with the specific issue, identify where it occurs, then change the relevant setting.

View all articles →