Official Manual · All Platforms

Shadowrocket Setup andRules Guide

Shadowrocket is a cross-platform proxy client with traffic rules. The iPhone / iPad app costs $2.99 as a one-time App Store purchase; versions for Mac, Windows, Android, and Linux are free.

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

First connection: Quick start →

Global RoutingOn DemandHysteria2
Configuration Reference / [Rule]Example snippet
VerifiedRule section

[Rule] section

Rules are evaluated from top to bottom; the first match takes effect.

DOMAIN-SUFFIX,example.com,PROXY
DOMAIN-KEYWORD,example,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT
View the full configuration reference →

Client features and where to configure them

First identify whether you need to change the connection method, server details, or matching rules, then open the corresponding screen. The connection toggle, selected server, and active configuration each serve a different purpose; keep them separate when troubleshooting.

Matching and policies

Traffic rules

To route traffic using the active configuration’s rules, select Config under Global Routing on Home. Proxy forwards traffic through the selected server; Direct connects without a proxy. Use them to compare results. When editing rules, place exceptions for individual domains before broader rules, then use FINAL for requests with no match. If a domain is not being proxied as expected, find the first rule it matches and check the policy assigned to that rule.

DOMAIN-SUFFIX,example.com,PROXY
Match first, then apply the policy

Quick start: add server details and test the connection

Have your own server details or subscription ready. For the first test, keep your existing configuration and use one server with a familiar destination. Adjust rules only after confirming the connection works.

Step 01

Add Server or Subscribe

Use Add Server to enter your existing server details, or Subscribe to import your subscription URL. Return to Home, expand the SERVER group, and select one entry to test. If names are similar, verify the protocol and address.

Step 02

Choose Global Routing

Use Config to apply your rules. For comparison, use Proxy to test the selected server or Direct to test the network itself. Keep the network and destination the same, then restore your usual mode.

Step 03

Turn on the connection and test

Turn on the connection in Home and approve any first-time system prompts. Run Connectivity Test, then open a familiar site in your browser. The toggle alone does not tell you whether a request was routed as expected.

Read the full setup guide →

Why does the test fail after a successful import?

A successful import only confirms that the client can read the details. Check the selected entry’s Host, Port, and authentication fields first. Then follow the quick start test sequence to distinguish a server connection failure from a rule mismatch or an unreachable test destination.

Why don’t my rules apply after switching to Proxy?

Proxy forwards traffic through the selected server and does not evaluate rules one by one as Config does. Switch back to Config and make sure the expected configuration file is selected. If the result is still unexpected, check whether a broader rule appears earlier in the list.

What should I check first if a problem starts after changing networks?

First confirm that the new network works, then retest with the same server and destination. If only the connection timing has changed, check On Demand in Settings. If just one destination will not load, check the routing rule for that request first.

Downloads for every platform

Get Shadowrocket for iPhone / iPad from the App Store for a one-time US App Store price of $2.99. Mac, Windows, Android, and Linux versions are free, with installers available from this site at /dl/. Confirm your device and system, then choose a file in the matching section.

Browse all platforms →

If you are unsure which architecture your computer uses, check the system information before downloading. If a desktop or Android device asks you to confirm the installation source, make sure the file came from this site’s page for the correct platform, then read the installation instructions for your system. There is no need to disable your system’s global protections to install an app.

Verify the app, purchases, and updates

Shadowrocket is a closed-source commercial app. Store searches may show listings with similar names. Before paying, verify the developer, icon, and app ID together on the product page; do not rely on the name or search ranking alone.

Official Shadowrocket icon: a blue-purple outlined rocket on a white background
Developer
Shadow Launch Technology Limited
App ID
932747118

How to verify the official app →

Verify the app on its product page

First, confirm the product name is Shadowrocket, then check that the developer is Shadow Launch Technology Limited. Compare the product icon with the image on this page, and make sure the product page URL ends in id932747118. If any of the three details do not match, return to the download page and reopen the product page before making a purchase.

Check the store region and system requirements

Your device’s language and your store account’s region are separate settings. If you cannot find the app, check the current store region, then open the product link from the download page to see its availability in that storefront; changing your search terms will not change the store catalog. If the product page opens but installation is unavailable, check its compatibility information. For iPhone / iPad, refer to the App Store listing for system requirements.

First-time purchases, restores, and updates

The iPhone / iPad app is a one-time US App Store purchase for $2.99. If both devices meet the compatibility requirements, the app can be used on both with the same purchase account. Mac, Windows, Android, and Linux versions are free. When changing devices or reinstalling, first check your purchases using the original account, then investigate account or region settings if needed. Purchase history helps you find the app again; it does not replace backups of server details or configuration files.

Update the iPhone / iPad app through the App Store. Mac, Windows, Android, and Linux users can download the installer for their platform again from this site’s download page. Before changing devices, note the configuration and custom rules you use. If traffic to a destination behaves differently after an update, check the selected server, configuration, and Global Routing mode before changing rules.

A one-time app purchase is not a service plan. The purchase covers use of the app, not servers or subscriptions. This official website and manual do not provide, sell, or recommend servers or subscriptions. Import server details you already have or a subscription from your own provider. Protect your credentials when making backups or sharing troubleshooting information.

Tips and guides

Browse by issue: learn the difference between share links and subscriptions, verify lookalike apps, or find settings by their interface labels.

Browse all articles →