Shadowrocket Rule Routing Guide
Shadowrocket is a multi-platform client for importing existing subscriptions or server details and setting up rule-based routing by destination.
iPhone / iPad: $2.99 one-time purchase on the App Store; Mac / Windows / Android / Linux: free
View the first-connection steps
- Global Routing
- On Demand
- WireGuard
01 Platform Access
Get Shadowrocket for Your Device
Check your device and operating system, then open the relevant platform page. Get the iPhone / iPad version from the App Store; check the App Store listing for system requirements. Download packages for other platforms from this site.
iPhone / iPad
Check the developer and system requirements on the product page. If the app is already associated with your purchase account, check your purchased items on a new device before deciding whether to buy it.
App Store · $2.99 one-time purchaseMac
Check the chip or processor in About This Mac. Choose the Apple Silicon version for a Mac marked as having an Apple chip, or the Intel version for a Mac with an Intel processor.
Free · Apple Silicon / IntelWindows
Check the system type in System Information before downloading, and confirm it matches the package listed on this site. If SmartScreen appears, verify the package source first.
FreeAndroid
First check whether your device supports arm64. If the built-in browser cannot complete the download, reopen this site's download page in the system browser and choose a package from the Android section.
Free · arm64Linux
Choose deb or rpm according to your distribution's package management system. If you plan to use AppImage, also check the processor architecture and system compatibility.
Free · deb / rpm / AppImage02 Settings Index
Rules, Connections, and Configuration
If you already have a subscription or server details, verify the connection before adjusting routing policies. Change one setting at a time to identify whether an issue comes from server parameters, a configuration file, or connection conditions.
Rule
To choose a connection method by destination, set Global Routing to Config in Home, then check which file is active in Config. Config selects a policy according to its rules; Proxy uses the selected server, while Direct connects directly. Rules are matched from top to bottom, and the first match determines how a request is handled. Put specific domains before broader conditions and place FINAL at the end to handle requests that match no earlier rule.
DOMAIN-SUFFIX,example.com,PROXY
On Demand
To connect automatically when specified network conditions are met, first verify a connection manually in Home, then check On Demand in Settings. Switch between commonly used Wi‑Fi and cellular networks to confirm when the rule is triggered. If the connection returns after you turn it off manually, check whether a trigger condition is still active. Temporarily turn off On Demand while troubleshooting to avoid automatic connections interfering with tests.
Settings → On Demand
Protocols
When adding a server manually, choose the protocol in Type under Add Server to match the existing server, then enter the supplied parameters. Shadowsocks, VMess, VLESS, Trojan, and WireGuard do not use exactly the same fields. A host can run different services, so the same address does not replace checking the protocol. After saving, run an initial check with Connectivity Test. If it fails, compare Type, Host, and Port first.
Add Server → Type
Subscribe
If you already have a subscription URL, choose Subscribe in the add screen and import the full URL. Return to Home and check whether the SERVER group contains the expected entries. When your provider gives you a new URL, distinguish between updating an existing group and adding a new one so that old entries are not mistaken for the latest results. If a previously selected entry disappears after refreshing, select an existing entry again and verify the connection. Hide the subscription URL before sharing screenshots.
Subscribe → SERVER
Config
Before editing, confirm which file is active in Config and keep a copy of the original. After making changes, return to Home and check Global Routing. Saved rules will not route traffic if Direct or Proxy is selected instead. When using iCloud sync across devices, check which file is visible after syncing and whether it is active on each device, then test with the same destination.
FINAL,DIRECT
Diagnostics
If a connection behaves unexpectedly, use Connectivity Test in Home to check the selected entry, then review diagnostic information under Diagnostics in Settings. A successful test only confirms that this test returned a result; it does not show that every destination is accessible as expected. If only one site has an issue, check the matching rule first. Data can help you observe traffic changes; compare readings over similar periods.
Connectivity Test → Diagnostics
03 Product and Purchase Checks
Check the Listing, Purchase History, and Packages
Shadowrocket is closed-source commercial software. This official manual covers how to get, configure, and troubleshoot the client. For your first download, choose the channel for your device, then verify the product listing or package.
- 2 access options
- App ID 932747118
Developer
Shadow Launch Technology Limited
-
Check three details on the App Store
Open the Shadowrocket App Store product page. First, check the developer name: it should be Shadow Launch Technology Limited. Next, compare the official icon shown here: a white background with a blue-violet outlined design. Finally, check that the App ID at the end of the product page URL is 932747118. A name in the page title or the nickname sometimes used in a description can help with an initial identification, but it does not replace these three checks.
If you open the product page from a link someone sent you, follow the same checks in the same order. If the icon looks similar but the developer or App ID differs, return to the site and open the product page from here. Once you find the correct listing, check its compatibility section. For iPhone / iPad system requirements, refer to the App Store listing. Before switching devices, compare these requirements with the new device's system information; do not assume it will install just because it opened on the old device.
-
If you cannot find it, check your account's store region
App Store availability depends on the store region associated with the Apple ID used for Media & Purchases. Your physical location, device language, or the region of a web page does not indicate which store your account currently uses. If the app does not appear in search results in the China mainland store, open the product page from this site first to distinguish between “not found in search” and “not available in the current store.”
To check your account region, open Media & Purchases under your Apple Account in device settings, then view the country or region in your account information. If the page opens but the store says the app is unavailable in your current region, follow the store's message. If the page says your device is incompatible, check the compatibility section. These messages point to different issues, and changing your device's display language will not resolve them. See the store availability guide for detailed steps.
-
One-time purchase and restoring purchases
The iPhone / iPad version is listed at $2.99 as a one-time purchase in the US App Store; the price shown in the relevant store applies. The Mac / Windows / Android / Linux versions are free. The same Apple ID used for the purchase can use it on eligible iPhone and iPad devices, so you do not need to buy it again for each device. If two devices use different purchase accounts, first check which account holds the original purchase.
After changing devices or reinstalling, sign in with the original purchase account and look for Shadowrocket in your App Store purchased items. Download it again from that entry. If you cannot find the record, first check which account is signed in to Media & Purchases, then look for the original purchase; do not buy again directly from search results. Restoring a purchase provides access to the app; it does not restore local rule files, subscriptions, or server details. If the old device is still available, confirm which configurations need to be transferred and keep them safe before switching.
-
A client purchase is not a service plan
Buying the app provides access to the client; it does not add server entries to your account or create a subscription link. This site does not provide, sell, or recommend nodes or subscriptions. If you already have a subscription URL, import its existing entries with Subscribe. If you already have the parameters for an individual server, enter them with Add Server using the relevant protocol. Before importing, identify whether you have a subscription URL, individual server parameters, or a configuration file for routing: these serve different purposes and are not interchangeable.
When troubleshooting for the first time, distinguish between “the app is installed,” “the server is reachable,” and “the destination is routed according to the rules.” Check the currently selected entry in Home, test that entry with Connectivity Test, and check the destination rule in Config. If a subscription has expired or server parameters have changed, check the original service information; reinstalling the app or changing Global Routing will not update the service's validity period. To document an issue, note when it occurred, the connection method, and the message shown. Do not post addresses or passwords publicly.
-
Packages and updates for other platforms
Mac, Windows, Android, and Linux versions are free. Get the iPhone / iPad version from the App Store; it is a one-time $2.99 purchase in the US store. Packages for other platforms are provided through this site's
/dl/shadowrocket/path. Choose your device on the download page and check its architecture: Apple Silicon and Intel Macs use different packages; check for arm64 on Android; and check the distribution, architecture, and package format on Linux. The same file extension does not mean a package supports the same device.If the system blocks the first launch, compare the download source and selected architecture, then follow the installation instructions for your platform. Do not continue if you cannot confirm the source. Updates also depend on the device: check the App Store for iPhone / iPad updates, and return to this site's download page for packages for other platforms. Before replacing an installation, keep a copy of your custom rules and connection settings. If behavior changes after an update, first confirm that the active file is the same as before, then adjust individual rules as needed.
04 Technical Notes
Installation, Connections, and Battery Troubleshooting
Choose an article for the issue you are experiencing. If you are new to the app, first distinguish the connection toggle from Global Routing. If a connection works but battery use changes, check the On Demand trigger conditions.
Shadowrocket battery troubleshooting: choosing between On Demand and a persistent connection
First distinguish the power used to maintain a background connection from the power used during active use. Then compare both options under similar network conditions and over similar periods. Finally, use the trigger history to decide whether to narrow the scope of On Demand.
View troubleshooting steps Download & InstallInstall Shadowrocket on Mac and Windows: choosing Apple Silicon or Intel and opening the app for the first time
Check your device in About This Mac or Windows System Information, identify whether an installation prompt comes from the system or the app, and follow the relevant steps.
Getting Started10 Shadowrocket questions for new users: Home, Config, Global Routing, and the connection toggle
A guide to ten common points of confusion when getting started, including the connection toggle, current routing mode, Config switching, and subscription updates.