Official manual · All platforms

Shadowrocket Help Center

A rule-based proxy client for multiple platforms for connecting to existing servers and routing by rules. iPhone / iPad: $2.99 one-time through the App Store; Mac / Windows / Android / Linux: free.

Current version Loading · iPhone / iPad: $2.99 one-time through the App Store; Mac, Windows, Android and Linux: free

Getting started: import and connection steps →
iPhone / iPad: $2.99 one-time · Free on other platforms

Shadowrocket features and interface

Settings reference →

First distinguish servers, subscriptions, and configuration files: servers store connection parameters; Subscribe updates a group of servers; Config determines how requests match rules. Importing one does not mean the other two are set up. The features below are grouped by task. Select a tile for key steps; examples explain rule syntax and do not include connection service details.

Match conditions, then apply a policy

Rule routing lets different requests use different handling. Check Rule in Config, then set Global Routing to Config in Home for rules to take effect during normal routing. DOMAIN-SUFFIX matches domain suffixes, IP-CIDR matches address ranges, and FINAL handles requests that did not match earlier rules. When checking a configuration, review rule order first, then confirm the target policy exists. Broad rules placed first can mask more specific rules later. Keep a copy of the original file, change one item at a time, and check match results against actual request logs.

Rule keywords →
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT

Verify the app · 2 ways to get it

App Store details and downloads from this site

For iPhone / iPad, verify the developer, official icon, and app ID. For Mac, Windows, Android, and Linux, choose an installer from this site's download page. Confirm the app identity and device type before importing.

App verification steps

Check the developer, icon, and app ID

Open the Shadowrocket App Store product page. The developer should be Shadow Launch Technology Limited, and the app ID should be 932747118. Also compare the official icon shown in this site's header: a white background with a blue-violet outlined design. Search result names and icons are only a starting point; open the product page and verify the developer and app ID rather than assuming similarly named listings are the same app. System requirements are as shown on the App Store page.

Shadowrocket is a closed-source commercial app. This manual explains features using interface terms and specific steps; ratings and download counts are not substitutes for verifying the app's identity. Desktop and Android users should start from this site's all-platforms download page. Installers are provided at /dl/shadowrocket/; choose the device and package format, then follow the system prompts to install.

Pricing and purchase coverage

iPhone / iPad: $2.99 one-time through the App Store; Mac / Windows / Android / Linux: free. App Store storefronts display prices in local currencies. The amount charged is shown on the product page and payment confirmation screen. iPhone and iPad can access the app through the purchased-items record for the same account. This purchase covers use of the client; it is not a recurring connection-service plan and does not generate server details.

A one-time client purchase is not a connection plan. This site does not provide, sell, or recommend nodes or subscriptions. Adding a server, scanning a QR code, and using Subscribe all require server information or a subscription that you already have. If you have the client but not those details, check with your own service provider rather than repeatedly switching files in Config.

App Store availability and account region

App Store search results depend on the storefront region associated with your Apple ID. If the app does not appear in the mainland China storefront, first check the region of your current store account, then see whether the product page is accessible. Change regions through the account settings in the system and review how balances, existing subscriptions, and payment methods may be affected. Changing your device's language or display region does not change the storefront region of your account.

Before purchasing, confirm that you are using a personal account you intend to keep, and retain your purchase record. Not finding the app in the store and a client connection failure are different issues: check the store and account for the former, and the server, network, and rules for the latter. Handling these separately avoids changing network settings before the app is installed.

Reinstalling, changing devices, and updates

To reinstall or move to a new iPhone / iPad, use the original purchase account to find the app in your purchased items and download it again. If you are prompted to purchase it again, check the account and purchase record before paying a second time. Reinstalling the app and restoring its configuration are separate tasks; back up and review the server selection, Config files, and automatic connection conditions from the original device.

Manage future iPhone / iPad updates through the App Store. Mac, Windows, Android, and Linux users can return to this site's download page for updated installers. Keep a copy of the active configuration before updating, then verify the existing connection path and review any new or changed settings. If the system blocks the first launch, follow the download page's installation guidance and check each source and system prompt; do not confuse an access failure with an installation prompt.

Get Shadowrocket for your device

All platforms →

There are two ways to get Shadowrocket: iPhone / iPad: $2.99 one-time through the App Store; Mac / Windows / Android / Linux: free. Each link below opens the relevant section of this site's download page. Device detection only prioritizes the current device; before installing, check the processor, system, and package format.

iPhone / iPad

$2.99 one-time through the App Store; free on other platforms. Both devices share the purchase record, and system requirements are as shown on the App Store page. After downloading, prepare your existing service details, then follow the guide to authorize the system connection configuration. Purchasing the app does not add servers automatically.

Mac

Free · Apple Silicon / Intel. Check the processor in About This Mac, then choose the matching dmg. If the first launch says the developer cannot be verified, confirm the file came from this site, then follow the download page's steps in System Settings under Privacy & Security.

Windows

Free. The download page provides a 64-bit installer. If SmartScreen displays a warning, first verify the download came from this site, then check for the Run anyway option under More info. After installation, check the client's connection settings and system network permissions separately.

Android

Free. Use the arm64 package from the download page. Follow the system prompt to allow the browser or file manager installing the app to Install unknown apps. If the built-in browser cannot download the file, open this site's download page in the system browser and continue. Revoke the installation permission afterward if you no longer need it.

Linux

Free · deb / rpm / AppImage. Check your distribution's package format and processor architecture first; AppImage requires execute permission. The download page provides package formats and steps. If you encounter a dependency or permission error, keep the full error message, resolve the installation issue, and then import your existing configuration.

Installers are not code-signed, so the system may display a warning on first launch. Follow the steps only for files confirmed to be from this site; do not disable system-wide protections just to complete one installation. See the installation guidance for prompts, steps, and commands.

Connect with existing service details: 3 steps

Full setup guide →

The preview below uses iPhone / iPad interface terms. Before starting, confirm that you have your own subscription or server information, and can distinguish a subscription URL from individual server parameters. For the first setup, establish one repeatable connection path before adding rules and automatic connection settings. That way, if an issue occurs, you can return to the last verified state.

01 / Home

Add a server or existing subscription

In Home, go to Add Server. For an individual server, choose the Type based on your details and enter Host, Port, and the relevant authentication fields. For an existing subscription, select Subscribe and save the complete URL. If you use Scan QR Code, open the imported details and check the parameters afterward. Scanning is an input method; it does not test the connection.

After saving, check that the expected entries appear in the SERVER group, then select a server to test. If the import is empty, check whether the URL was truncated, the subscription is valid, and the response is correct. Do not create multiple duplicate entries before confirming that the details are complete, and do not use a Config file URL as a server subscription URL.

02 / Global Routing

Confirm the mode and active configuration

For rule-based routing, select Config in Global Routing and confirm which file is active in Config. Proxy and Direct can help isolate an issue: the former checks the proxy path, and the latter checks a direct path. Selecting a mode does not replace server configuration; it cannot fill in missing parameters when server details are incorrect.

After importing a new configuration, first check that the policy names in Rule match your server selection, then review how FINAL is handled. Change one item at a time and keep the original file for comparison. If only Config fails, check DNS, rule order, and referenced resources before deleting all server details.

03 / Connectivity Test

Connect and verify actual requests

Return to Home and turn on the connection. On first use, follow the system prompt to allow the connection configuration to be added. After running Connectivity Test, open the website or app you actually need and check that its content loads. A test result is not identical to a real request, so the connection switch alone cannot confirm that every setting is correct.

If the connection fails, check in this order: current network → server parameters → Global Routing → Config and DNS. If only one website has an issue, note its domain and the time, then check which policy handled the request. Test Wi-Fi and cellular separately before enabling On Demand. Hide subscription credentials, passwords, and personal addresses when reporting an issue.

Purchases, protocols, and configuration migration

All articles →

Choose an article for your task: if you have not downloaded the app, verify the store details first; if you can already connect, review protocol parameters; if you are changing devices, make a recoverable backup first. Articles cover client operations and the use of information you already have; they do not provide connection services.