Rule matching
Put the condition and policy on the same line.
Shadowrocket is a rule-based proxy client for every platform. Import existing server details or a subscription and route traffic by rule. The iPhone / iPad app is a one-time $2.99 purchase on the App Store; the Mac, Windows, Android, and Linux versions are free.
Current package version v2.2.92 · iPhone / iPad: one-time $2.99 purchase; Mac, Windows, Android, and Linux versions are free.
Put the condition and policy on the same line.
Use an existing link; the example below is fictitious.
Configure when to connect separately from how to route traffic.
CONFIGURATION
Start by distinguishing three things: server details determine where to connect, a configuration file determines the route for each request, and the connection switch determines whether the client handles traffic. When troubleshooting, check them in that order. Changing several settings at once makes it harder to identify the cause.
RULE ROUTING
In Home, select Config under Global Routing to have the client check rules in the active configuration file one by one. Put exceptions for specific domains before broader rules. Requests that do not match earlier conditions are handled by the final FINAL rule. To compare connection behavior temporarily, switch to Proxy or Direct and compare the results. When finished, switch back to Config and confirm which file is selected. Otherwise, your test may not be using the rules you just saved.
ON DEMAND
Open On Demand in Settings and check which network conditions should trigger a connection. On-demand settings control when to connect; they do not replace Global Routing, which determines whether requests use a proxy or go direct. First confirm that a manual connection works on your current network. Then switch to the network you want to test and check whether the trigger works. If manual connections work but automatic connections do not, check whether the conditions cover the current network and which VPN configuration is enabled in the system. Do not start by changing server settings.
PROTOCOLS
In Add Server, set Type first, then fill in Host, Port, and the fields required by the selected protocol using your existing server details. Authentication requirements vary by type. If a field disappears after you change the type, that does not mean its value was lost; the selected type may not use it. If the connection fails after you copy the details, check the protocol, host, port, and credentials one by one, and remove any extra spaces at the beginning or end. Do not guess the server configuration by repeatedly switching protocols.
SUBSCRIBE
If you already have a subscription URL, choose Subscribe in Add Server, paste the full URL provided by your service provider, and save it. Return to Home and check that the group appears and the entries you intend to use are still listed. A successful subscription update means the client retrieved the list; it does not mean every server is reachable. If an update fails, first check that the URL is complete, the network is available, and the link has not been replaced. Before sharing a screenshot of the problem, hide query parameters and credentials in the URL.
CONFIG & DIAGNOSTICS
In Config, confirm which configuration file is selected and save a recoverable copy of the original before editing. If you use multiple devices, check which items can sync under the app's iCloud settings; do not treat syncing as a configuration backup. If the connection is unstable, use Connectivity Test in Home to check the server, then review traffic statistics in Data and Diagnostics in Settings. An increase in traffic only shows that requests passed through the client; it does not tell you which rule matched a particular destination.
First check whether Global Routing is set to Config, then check the currently selected item in Config. If both are correct, note the hostname you actually visited; do not rely only on the domain shown at the end of the address bar, as the page content may come from another host. Check for broader matching rules before the target rule, and confirm which policy handles unmatched requests. Change one thing at a time and retest the same destination on the same network to verify that the rule, rather than a network change, caused the result.
Temporarily turn off On Demand and connect manually on the current network. If that works, turn On Demand back on and switch the same device to a network that should clearly trigger a connection. Note the connection status before and after switching networks. Do not change the server or rule file at the same time. If it still does not trigger, check the VPN configuration currently enabled in the system and the trigger conditions in the app. If manual connection also fails, restore a working basic connection before troubleshooting automatic triggers.
Without changing your routing configuration, first confirm the device itself can access the internet. Then use Connectivity Test to check the selected server. If the test fails, return to Add Server and compare the existing details, starting with whether Type, Host, and Port belong to the same server entry. Then check the authentication fields required by the protocol. A successful test does not mean every destination is accessible; verify using the actual destination as well.
First determine whether the list could not be updated or whether it updated but a server in the list cannot connect. For an update failure, check that the subscription URL is complete, the network is available, and the link provided by your service provider is still valid. If the list updated, check the selected entry and server details. If the old group is still there, keep it for comparison until you have checked the URL. If you need to record an error message, include only the error text and hide the subscription URL, identifying parameters, and server credentials.
Restoring Shadowrocket from the App Store restores the client, not all settings from the previous device. After reopening the app, check the subscription groups, saved servers, and currently selected item in Config separately. If you had enabled settings related to iCloud, first check whether the items eligible for syncing have reached the new device. Restore anything else from a saved configuration or the original details. Verify a manual connection before restoring on-demand conditions.
PLATFORM DOWNLOADS
The iPhone / iPad app costs $2.99 as a one-time purchase on the App Store. Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free; download their packages from the /dl/shadowrocket/ path on this site's download page. The links below show options for the relevant device first; opening a card does not start installation.
Check system requirements on the App Store. To reinstall, use the original account’s purchase history.
Open About This Mac, then pick the disk image for your chip or processor.
Check System Information for your system type before choosing a package.
Check your device architecture. If the in-app browser can’t download the file, use your browser app.
Choose a package that matches your processor and Linux distribution.
FIRST CONNECTION
The steps below use the iPhone / iPad interface as an example. Have your existing server details or subscription URL ready, and confirm the device can access the internet before enabling the proxy. If the first connection fails, this helps rule out the device's basic network connection as the cause.
If you have details for a single server, go to Add Server from Home, check Type, fill in each field, save, and return to the list. If you have a subscription URL, import it with Subscribe to populate the list from the subscription. There is no need to add the same entry twice. After saving, check the SERVER group and confirm that the selected server is the one you intend to test, not an entry left over from an earlier session. Manually added servers and subscription entries may have similar names, so check their source before choosing. You do not need to post URLs or credentials publicly to check the page.
Global Routing modeTo route requests by rules, first confirm the active file in Config, then return to Home and set Global Routing to Config. To see whether a problem is related to rules, compare Proxy and Direct on the same network. Change only the mode during the test; do not switch servers, configuration files, or networks at the same time. If the result differs only in rule mode, check the file and rule order first. Note the mode used before testing and restore your usual setting afterward so a temporary choice is not mistaken for the previous configuration.
Return to Home and turn on the connection switch. When the system first asks to add a VPN configuration, confirm the request was triggered by the Shadowrocket app you just opened, then follow the system prompt to allow it. Once the connection status changes, run Connectivity Test, then visit one destination expected to go direct and another expected to use the proxy. If either result is unexpected, note the network type, current mode, configuration file, and error message. An enabled connection switch alone does not confirm that traffic is working as intended. If both destinations fail, disconnect temporarily and test the same destination again to see whether the basic network connection is affected too.
STORE VERIFICATION
Open Shadowrocket's App Store product page. First confirm the developer is Shadow Launch Technology Limited, then compare the official icon, which has a white background and a blue-violet outlined rocket. Finally, check for id932747118 in the product page URL. Search results may show similar names and icons; the Chinese nickname for Shadowrocket is not proof that a listing is genuine. Check the product details, not just the search result summary. The developer name and App ID should appear on the same product page. If either does not match, do not treat that listing as the app described in this manual.
App availability depends on the App Store storefront used by your account, not just your device's language or system region. If you cannot find the app, first check the product page for availability in that storefront. Then open Media & Purchases in your Apple Account settings and check the account and country or region currently used to get apps. Shadowrocket is not available on the mainland China storefront. Opening the US product page is for reference only and does not change your account's storefront. If the app is available in your storefront but will not download, check device restrictions and compatibility. For iPhone / iPad system requirements, refer to the App Store listing. For help distinguishing store messages, see the App Store guide.
The iPhone / iPad app is a one-time $2.99 purchase on the US App Store; prices vary by storefront. The Mac, Windows, Android, and Linux versions are free. One purchase covers both iPhone and iPad; you do not need to buy it separately for each device. When switching devices or reinstalling, open the App Store with the account used for the original purchase, go to Purchased, find Shadowrocket, and download it again. If you see a price instead of a redownload option, check the account and storefront before purchasing again. Redownloading restores the app itself; check separately whether existing subscriptions, manually added servers, and local rules were synced or backed up.
The app opening normally does not mean your existing servers are still available. Likewise, a subscription update failing temporarily does not indicate a problem with your purchase. When troubleshooting a connection, first identify whether the issue occurs while getting the app, importing details, or accessing a destination. For app access issues, check the store or download page. For changes to an existing service, check its original service details. For routing mode and rules, review Home and Config one setting at a time.
Check for updates to the iPhone and iPad app in the App Store; you can use the system's automatic update settings. For Mac, Windows, Android, and Linux, get the corresponding package again from this site's download page. Do not judge a package's version or source by a similar-looking filename. Before updating, note the current mode and configuration file, and keep any necessary local backups. After updating, test a manual connection, then check that subscription updates, rule-based routing, and On Demand still work as expected. If the system displays an installation prompt, verify the download source and consult the installation instructions for that platform. Do not allow files from unknown sources.
READING NOTES
Choose a guide based on the issue: if a domain sometimes fails to load, start with the DNS resolution path; if you have a link but are unsure where to enter it, identify the link type; if only the routing result is wrong, check rule conditions and order.
Learn how System DNS, Custom DNS, and DNS over HTTPS resolve domains, when to use each, and how to troubleshoot connection failures caused by DNS resolution problems.
Explore the structure of ss://, vmess://, vless://, and trojan:// share links. Compare how individual links and subscription URLs are imported and updated. All examples are fictitious.
Learn what DOMAIN, DOMAIN-SUFFIX, DOMAIN-KEYWORD, GEOIP, IP-CIDR, and FINAL match, how rules are evaluated from top to bottom, and how to use PROXY / DIRECT / REJECT.