Shadowrocket is a cross-platform proxy client with multiple protocols and rule-based routing: iPhone / iPad access is a one-time App Store purchase; Mac, Windows, Android, and Linux versions are free.
iPhone / iPad access is a one-time $2.99 App Store purchase; check the App Store page for system requirements. Mac (Apple Silicon and Intel), Windows, Android, and Linux versions are free. Get their installers from /dl/shadowrocket/ on this site.
The “This device” label refers to the device currently browsing this site, which may not be the device where you plan to install Shadowrocket. When preparing an installer for another device, check its operating system and architecture. The browser can identify the system, but not the Mac chip type.
Desktop and Android installers are unsigned, so the system may show a warning during installation or the first launch. Check the download source and target platform, then read the installation instructions for your system. Do not open files from unknown sources.
Selecting a server, turning on the connection, and deciding how a request is routed are three separate actions. The examples below use the iPhone / iPad interface: a server provides connection parameters, the switch controls connection status, and Global Routing determines how requests are handled by the current configuration.
Open Global Routing from Home. Config handles requests according to the rules in the current configuration; Proxy sends included traffic through the selected proxy; Direct connects those requests directly, but does not turn off the connection switch. When troubleshooting, note the original mode, then compare the same destination. If the issue occurs only with Config, check the current configuration and matching policy first. Avoid changing the server at the same time, or it will be hard to tell which change mattered.
Global RoutingConfigProxyDirect
On Demand starts a connection when specified conditions are met; it does not decide whether an individual request uses a proxy or a direct connection. When viewing this option in Settings, first confirm that manual connection works, then select the conditions for automatic connection. After saving, test an action that meets the conditions, such as switching from cellular to a familiar Wi-Fi network. If the connection returns after you turn it off manually, check whether a condition is still met, then check the status in Home. There is no need to delete the server right away.
SettingsOn DemandHome
In Config, confirm which configuration file is enabled, then check its Rule section. Rules are matched in order. Put specific domain conditions before broader conditions that could override them, and use FINAL to set the policy for requests with no match. The example on the right first matches a domain suffix, then checks a geographic IP condition, and finally applies a fallback policy. Keep a copy of the original configuration before editing. To verify, use a known destination and check which rule matched instead of relying only on the connection switch.
DOMAIN-SUFFIXGEOIPFINALPROXY
When adding a server manually, select the protocol actually used by the server in Type under Add Server, then enter Host, Port, and any other required fields. The same address and port do not mean that protocols are interchangeable; for example, the Method for Shadowsocks must match the server. If fields are missing, check your existing configuration rather than trying arbitrary types. See protocol details for the fields and trade-offs of each protocol.
TypeHostPortMethod
If you already have a subscription URL, choose Subscribe from the add menu, enter the full URL, and save. Then return to Home and check SERVER. After updating a subscription, confirm that the previously selected entry is still there; similar names do not mean the configurations are identical. If you use iCloud sync, check the account and sync settings on each device, then verify what actually appears on the target device. Subscription updates and syncing between devices are separate processes, and neither replaces connection testing.
SubscribeHomeSERVERiCloud
If the switch is on but websites do not load, use Connectivity Test in Home to check the selected server, then test whether the destination is actually reachable. A test result only confirms a response to that test request at that moment; other domains may take a different route. Use Diagnostics to review relevant information, and compare traffic before and after the test in Data. These readings are client-side statistics; a single change cannot establish connection quality or billed usage.
HomeConnectivity TestDiagnosticsData
Global Routing
Config / Proxy / Direct
Config → Rule
Proxy → PROXY
Direct → DIRECT
Add Server
Type: Shadowsocks
Host: example.com
Port
Method
Add Server
└─ Subscribe
Home
└─ SERVER
Home
└─ Connectivity Test
Settings
└─ Diagnostics
Data
Start troubleshooting routing by reproducing the same request. Note the server, mode, and destination, then change one thing and compare the result. For example, when comparing Proxy with Config, keep the server and destination unchanged. Restore the original mode before checking rule order. This helps distinguish an unreachable server, a DNS issue, and an unexpected rule match.
First-time setup
Quick start for iPhone / iPad
These steps are for users who have installed Shadowrocket and already have server details or a subscription URL. Manual entry, QR code scanning, and subscription import are different methods. Choose the one that matches the information you have; there is no need to add the same details more than once.
Import with Add Server or Subscribe
Open the add menu from Home. If you have the details for a single server, check Type in Add Server, then fill in the required fields. If you have a server QR code, use Scan QR Code. For an existing subscription URL, choose Subscribe, save it, then return to Home and confirm that the entry appears under SERVER. If the list is still empty, check the import result and make sure the original details are complete. Do not enter a subscription URL in Host.
Select a server and check Global Routing
In SERVER, confirm that the server you want to use has a dot beside it. For rule-based routing, select Config and check which configuration file is active. To test the same destination, you can temporarily compare with Proxy or check the direct route with Direct. The dot indicates the current selection, not that the server has passed a test. After selecting another entry, test the connection again.
Turn on the switch and run Connectivity Test
Return to Home and turn on the connection switch. The first time, follow the system prompt to approve the VPN configuration used for the connection. Then run Connectivity Test and visit a known working destination. If the test responds but the destination does not open, treat them as separate results. Keep the current server and check the mode, DNS settings, and rule match in order. Use the same destination for comparisons, then restore any temporary changes when you finish.
Shadowrocket is a closed-source commercial app. To verify the iPhone / iPad version, check the developer, official icon, and app ID on the App Store product page. For desktop and Android versions, confirm that the installer came from this site’s download page; a filename or icon alone is not enough.
Developer: Check the full spelling of Shadow Launch Technology Limited, not shortened text in search results.
Official icon: Check the white icon with a blue-purple outlined rocket on the product page. The icon can help identify the app, but should not be the sole basis for a purchase.
App ID: Check that the end of the product link is id932747118. Use the same method to verify listings with similar names or icons.
App Store availability and account region
Whether the product appears in App Store search depends on the storefront used for purchases; the device’s display language does not set the storefront. If you cannot find it, open the product page to check whether the app is available in the current storefront, then check the country or region in your Apple Account settings. If the page appears but the device reports incompatibility, review the compatibility information on the product page. System requirements are as listed on the App Store page.
If the current storefront does not offer the app, do not substitute a search result with a similar name. Before changing your account region, read the account settings notices about any existing balance, subscriptions, and payment methods. Do not change regions just to recover a previously purchased app; check the original purchase record first.
Restore a purchase on another device
iPhone and iPad share the same purchase. When changing devices or reinstalling, first confirm that the App Store is signed in with the Apple Account originally used to purchase Shadowrocket, then look for it in purchased items. If the product page asks you to buy it again, check the account and purchase record before paying again. App purchase records and in-app settings are managed separately. After reinstalling the app, check whether your own server details, subscriptions, and current configuration have been restored.
Get app updates through the App Store, or enable automatic updates in system settings. To recheck the connection after an update, first look at the server marker and Global Routing mode in Home. If you used On Demand before changing devices, also confirm that the new device’s settings are as expected.
Desktop and Android installers
Get Mac, Windows, Android, and Linux installers from the platform sections on this site at /dl/shadowrocket/. To update, return to the section for your platform and get the matching package again. If you have a new computer, check its chip or architecture instead of reusing the previous device’s selection. Linux users should also confirm that the package format suits their distribution. If the system displays a warning or installation fails, check the file source, architecture, and installation method.
Reading index
Shadowrocket technical notes
The connection switch, rule results, and traffic readings answer different questions. First check whether a request completes, then whether it matches the expected policy, and finally compare traffic changes. Choose an article based on the issue you encounter; there is no need to redo the entire configuration.
The Data page summarizes traffic by server and app. Learn what each reading measures, why it may differ from carrier usage, and how to use the data to check routing rules.
The REJECT policy refuses matched requests. This article explains combining rules such as DOMAIN-SUFFIX with REJECT, rule matching order, the risk of false blocks, and the limits of the feature.
If the connection switch is on but webpages do not load, check the server status, Global Routing mode, DNS settings, and rule matches in order, with steps to test and restore each setting.