Shadowrocket Official Manual / Features and Settings
Shadowrocket Routing Modes
First, check Global Routing in Home, then review the rules, servers, and connection conditions. If access fails, change one setting at a time and retest the same destination.
- Global Routing
- How connections are handled
- On Demand
- When connections start
- Data
- How much data was recorded
Three Global Routing modes
Open Global Routing in Home and choose Config (Config), Proxy (Proxy), or Direct (Direct). This controls how traffic handled by the client is routed; it does not determine when a connection starts or change the rules saved in Config. The interface terms below are used as reference points; menu locations vary by platform.
| Mode | How it works | When to use it |
|---|---|---|
Config (Config) |
Matches traffic against the active configuration's rules and applies the matching policy. | Use this when connections need different handling by domain or address. Check which configuration is active, then identify the rule matching the destination. |
Proxy (Proxy) |
Rather than routing traffic rule by rule, sends connections covered by this mode through the selected proxy server. | Use this briefly when you have a server and need to test whether it can reach a particular destination. Switch back to your usual mode when finished. |
Direct (Direct) |
While the client remains connected, sends the relevant traffic without routing it through a proxy server. | Use this to check whether the current network can reach a destination directly. To test with the client fully disabled, disconnect it separately. |
For example, if a site loads in Proxy mode but fails in Config, first check whether the expected policy matched instead of switching servers right away. If the same destination fails through the proxy but works with a direct connection, check the server details and proxy route. Keep the same Wi-Fi or cellular network for both tests, and start a fresh request; existing connections may continue using the previous route.
ProxyandDirectare modes;PROXYandDIRECTare policies in a configuration. Selecting a global mode is not the same as choosing the policy matched by a rule.
Rule types and routing policies
In Config, find the active configuration and open its rule list. Then return to Home and make sure Global Routing is set to Config. Rules define matching conditions and actions: DOMAIN matches an exact hostname, DOMAIN-SUFFIX matches a domain and its subdomains, and DOMAIN-KEYWORD matches a string in the hostname and can cover more hosts. To target a single host, start with DOMAIN so similarly named hosts are not included.
IP-CIDR and IP-CIDR6 match IPv4 and IPv6 ranges, respectively. GEOIP matches based on the geographic classification of an address, not its domain suffix. USER-AGENT depends on whether the relevant request identifier is available; do not assume every connection provides it. If a destination can be reached by hostname or directly by address, test both methods separately.
PROXY routes matching connections through a proxy, DIRECT connects directly, and REJECT blocks the connection. This example illustrates rule order: one host connects directly, other hosts under the same domain use a proxy, and FINAL handles all remaining requests.
DOMAIN,docs.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
Rules are generally checked in order, and the policy for the first match is applied. If you move the first two example rules, docs.example.com will match the broader suffix rule first. Keep a copy of the original configuration before editing, put specific rules before broader ones, and check the fallback policy last. After saving, verify that the edited file is active. Changes made only in a preview, or edits to a configuration that is not enabled, cannot be verified by subsequent access tests.
Importing subscriptions and managing servers
A subscription keeps a set of existing server entries up to date; adding a server manually is useful when configuring a single known endpoint. If you have a subscription URL from a provider, open Add Server in Home, choose Subscribe, enter the URL, and save. If you have the details for one server, choose the matching protocol under Add Server, then enter the address, port, and required fields. Do not enter a subscription URL in a single server's address field.
After importing, return to the server list in Home and check that the entry appears. Select one and run Connectivity Test. Results depend on the test method and destination; after a successful test, also try the actual destination using the Global Routing mode you plan to use. If the test fails, first verify the protocol, address, port, and other original details. Then check whether the problem affects one server or several entries in the same subscription.
Before refreshing a subscription, note which entry you are using. A remote update may change names, addresses, or the number of entries, and an old entry may no longer be available. Subscription URLs may contain access credentials; do not share the full link in shared documents, public screenshots, or diagnostic logs. This site explains how to use subscription or server details you already have; it does not provide, sell, or recommend these services.
On Demand connections
On Demand starts a connection when specified network conditions are met; it does not choose a routing rule on the fly for each visit. First, confirm that a manual connection works from Home. Then find On Demand in Settings and configure its conditions using the options available on your platform. Start with an easy-to-repeat scenario, such as switching from Wi-Fi to cellular, and check whether the connection starts as expected.
When retesting, check both when a connection should start and when it should not. If the connection comes back after you disconnect manually, first check whether the current network still meets the On Demand trigger conditions. To test a manual connection only, temporarily turn off On Demand and turn it back on when troubleshooting is done. If you see frequent reconnects or a change in standby battery use, check whether the network keeps switching and compare similar time periods before narrowing the trigger conditions.
Data usage statistics
Check the traffic recorded by the client in Data. First confirm whether the display shows a cumulative total or a specific period, and whether the value is for uploads or downloads. To measure the traffic added by an action, note the starting value, repeat the same activity on the same network, then note the ending value. This preserves the history and makes it easier to relate the difference to the time of the test than clearing the stats.
Background sync, media preloading, and repeated requests can all increase the numbers. If several apps are active during the same period, the total difference alone cannot show how much traffic a particular request used. Data reflects the client's own statistics; it is not the same as system cellular usage or a provider's bill. To check which policy handled a visit, review the rule match or diagnostic log rather than inferring it from traffic figures.
Common Settings
Record the current settings and values first, then change only what relates to the issue. For resolution problems, check DNS; for inconsistent test results, check Test Method; for automatic reconnects, check On Demand. Avoid changing several settings at once, or it will be hard to tell which change fixed the connection.
DNS: domain name resolution
DNS controls how domain names are resolved. Check the current values in Settings and see whether the active Config defines DNS options. If the network is working normally, leave the settings as they are. If you need to make a change, first determine whether the problem affects regular domains or only local network names. Change one value at a time, then retest the same domain on the same network. Existing connections or cached results may delay the effect; successful resolution does not guarantee that a connection can be established.
Test Method: connectivity test method
Test Method selects how connectivity is tested. Check the available options in Settings, then return to Home and run Connectivity Test on the same server. When comparing entries, keep the method, destination, and network conditions the same. Different methods measure different parts of the connection, so their results may not be directly comparable. Low latency does not replace testing actual access, and it does not indicate throughput.
Today Widget: quick access
On devices that support it, Today Widget lets you check status or use available quick actions from a system widget. First check the option in Settings, then add the widget from the system's widget screen. If the panel does not update promptly, use the connection status shown in Home. Change routing modes and check the active configuration in the client itself.
iCloud sync: use configurations across devices
To use the same configuration on devices that support iCloud, first check the sync option and what it covers in Settings, then confirm that each device is signed in to the intended account. Back up important configurations before enabling sync, and use an easy-to-identify configuration to verify that it reaches the other device. Seeing the file does not mean it is enabled or that connection access has transferred; check the active configuration on the receiving device and test its connection separately.
Diagnostics: troubleshoot connection failures
Open Diagnostics in Settings, reproduce the issue with a specific destination, and note the time, network type, and current Global Routing mode. If the tool shows request details, use the available information to distinguish DNS resolution failures, unexpected rule routing, and server connection failures. A single timeout entry is not enough to conclude that the server is down. Before sharing diagnostic information, remove subscription URLs, account details, private domains, and unnecessary browsing records.
How to get and use Shadowrocket across platforms
Get the iPhone / iPad version from the App Store product page. It costs $2.99 as a one-time purchase in the US store and can be used on iPhone and iPad after purchase. Check the App Store listing for system requirements. The Mac (Apple silicon / Intel), Windows, Android, and Linux versions are free; installers are available from this site at /dl/. To verify the App Store listing, check the developer name, Shadow Launch Technology Limited, the official icon, and app ID 932747118.
A one-time app purchase does not include a connectivity service plan. Use your own existing server details or subscription to configure a connection. Follow the setup guide for initial configuration. To download the app or find installation and first-launch instructions for each platform, visit the all-platform downloads page.