A cross-platform rules-based proxy client for importing existing servers or subscriptions and routing traffic by rules; iPhone / iPad: a one-time $2.99 App Store purchase; Mac, Windows, Android, and Linux versions: free.
Shadowrocket Rules & Routing and On Demand Connections
Global Routing determines how requests are routed; On Demand determines when a connection starts. Test these two settings separately, then check the server, configuration, or diagnostic results.
For example, to proxy only a few sites, place specific DOMAIN-SUFFIX rules before broader rules in Config, then use FINAL,DIRECT at the end for unmatched requests. First create a connection to one destination that should use PROXY and another that should use DIRECT. A webpage loading successfully does not confirm which route it used. If the result differs from what you expect, check the active file, rule order, and domain in the actual request first.
Before reviewing On Demand in Settings, complete one manual connection, confirm the server works, and note the current mode. After configuring the conditions, switch networks on the same device and observe whether the connection state changes accordingly. An automatic connection only means the trigger conditions were met; it does not mean every request will use a proxy. Global Routing still determines the request path. If the connection keeps restarting during testing, temporarily disable On Demand and repeat the manual connection comparison.
In Add Server, select Type first, then check Host, Port, and the other fields shown for that protocol. After scanning a QR code or importing details, review the entry again, especially line breaks, leading or trailing spaces, and transport parameters supplied with the server details. Save and test one existing server before entering the rest. If the test fails, keep the original record and change one item at a time to avoid confusing server parameter errors with routing issues.
After importing, check the groups and entries in the SERVER list, then select the server to use for the current connection. A subscription refresh may rename or remove the previously selected entry, so confirm your selection again. If an update fails, first check that the subscription can be retrieved over the current network, then ask the original provider to verify the link status. When reporting an issue, note when it occurred and any error message; there is no need to share the full subscription URL or QR code.
Before editing in Config, note the current filename and the rule you plan to change. If the device uses iCloud sync, check which file you are about to edit and keep a separate copy; sync is not a substitute for a backup. After moving to another device, even if a configuration with the same name is visible, check that it has been loaded, its rule references are valid, and the current mode in Home is correct. Test only after confirming these conditions; a visible configuration file does not prove that both devices are using the same routing.
Use Connectivity Test to compare the same entry on the current network, then switch networks once and test again. If the test succeeds but browsing still fails, check Global Routing, then record the upload and download changes in Data around one operation. Background traffic can affect Data readings, so they are useful for a brief comparison but not as a provider's usage statement. If only one site has a problem, continue by checking the matched rule and DNS resolution.
Get Shadowrocket by device
iPhone / iPad: a one-time $2.99 App Store purchase. Mac (Apple Silicon or Intel), Windows, Android, and Linux versions are free; installers are available from this site's /dl/shadowrocket/ directory. Device cards prioritize the platform detected on your device. If you are preparing an installer for another device, choose its platform and architecture.
The steps below use the iPhone / iPad interface as an example. Before starting, disconnect the client and open a page that normally works on the current network to confirm basic connectivity. Then prepare your own subscription link, server QR code, or details for manual entry, such as the protocol, host, and port. These are different ways to provide the same information; you do not need to add the same server more than once.
Add existing details in Add Server
Open Home and start the process from Add Server. If your provider gave you a subscription link, import it using Subscribe. For a server QR code, use Scan QR Code. If you only have text details, select Type first and fill in each field. Return to Home and confirm the new entry in the SERVER list, then select one server for the first test. Seeing a name in the list is not enough: if there are entries with the same name, open the details and check the protocol and address to avoid testing an old record by mistake.
Choose a mode in Global Routing
If you have a routing configuration ready to use, select Config and check the active file in Config. For a short-term proxy path check, use Proxy; to check access without a proxy, use Direct. This setting controls how traffic is handled; it does not replace an imported server or turn the connection on. For comparisons, keep the server and test destination fixed and change only the mode. When finished, switch back to the mode you normally use.
Start the connection from Home and test an actual request
Turn on the connection switch at the top of Home. When the system first asks to add a VPN configuration, confirm that the prompt was triggered by your action, then follow the system instructions. If the switch turns off immediately, check system permissions and any existing VPN status. If the connection stays on but access fails, first test a known working route, then check Connectivity Test, routing mode, and the current network. If only one domain fails, do not assume that all servers are affected.
When documenting an issue, note the connection switch state, network in use, Global Routing option, and affected destination. Change networks, servers, or configuration separately; retry the same action after each change to identify what affected the result. Before sharing troubleshooting notes, remove account details, subscription links, and server credentials.
Shadowrocket is a closed-source commercial app. To verify the iPhone / iPad version, check the developer, icon, and app ID in the store listing. For installers on Mac, Windows, or Android, use the relevant platform section on this site's download page. These channels are for different devices; a phone store purchase record does not determine whether the app can be installed on a computer or Android device.
Check the App Store storefront and listing
Open the product page from this site's App Store access guide. Confirm that the developer is Shadow Launch Technology Limited, the page URL ends in id932747118, and the icon has a white background with a blue-purple outline. If the name or icon looks similar, do not skip checking the developer and app ID; search ranking does not verify a listing's source. Check the App Store page for system requirements and compatible devices.
If the listing does not appear in search or the product page says it is unavailable in the current storefront, first check the region of the account used for App Store purchases. Device language, time zone, and physical location do not determine the storefront region. Product availability and currency can differ between storefronts; use the page shown to the current account as the reference. If you need to change the account region, first check the displayed balance, subscriptions, and payment requirements, then follow the account settings instructions.
One purchase can be used on iPhone and iPad
The iPhone / iPad version is a one-time $2.99 purchase in the US App Store. The Mac (Apple Silicon and Intel), Windows, Android, and Linux versions are free. The purchase belongs to the account used for the store purchase, not the device where the app was first installed. On another iPhone or iPad that meets the system requirements, sign in with the same purchase account and find the app in your purchased items.
If the store shows a purchase button instead of a redownload option during reinstallation, do not buy the app again immediately. Check whether the current store account is the original purchase account, search for the app by name in purchased items, and confirm that the listing has the same app ID. Restoring a purchase and restoring local settings are separate tasks: after reinstalling the app, check Config, SERVER, and Global Routing. If your details are not restored, import your saved configuration or your own subscription again. See the guide to restoring a purchase for the steps.
Distinguish app updates from subscription refreshes
App updates for iPhone / iPad are provided by the App Store. To update the Mac, Windows, Android, or Linux version, return to this site's download page and select the same platform and an installer for your device's architecture. An app update changes the client; a subscription refresh updates server entries provided by your provider. Save your current configuration before updating. Afterward, check the selected entry, rules file, and mode before deciding whether to refresh a subscription, so you do not change multiple conditions at once.
Connection and network guides
If the connection switch is already on, the next step depends on the symptom: check rules if only some domains fail; distinguish DNS resolution from server reachability when lookups are unstable; if you have not completed the first connection, start with the VPN configuration prompt and the status in Home.
Check the first-connection system prompt, Not Connected switch, Global Routing, Connectivity Test, and SERVER list to distinguish a disconnected state, a missing server selection, and a connection with access issues.
Compare three resolution methods, note the settings to record before making a change, and learn how to keep the test destination fixed before checking the current network and DNS selection in order.
Use domain rules for specific destinations and send other connections along the default route. See how rule order and comparison tests can reveal whether a broad rule is matching before the intended rule.