When you first open Shadowrocket, use the iPhone or iPad interface as a guide: check connection status and Global Routing in Home, review your configuration file in Config, view traffic stats in Data, and check On Demand in Settings. Config appears in two places: the Config tab at the bottom manages files, while Config under Global Routing means traffic is handled according to the current configuration's rules.
Home: Connection Status, Proxy Entries, and Global Routing
Home is the connection tab in the bottom navigation. Check the connection switch, Global Routing, and your proxy entry list here. The selected item in the list shows which proxy entry is chosen; the switch shows whether the connection is on; Global Routing determines how traffic handled by Shadowrocket is routed. These answer different questions: an entry can be selected while the switch is off, and even with the switch on, a request may be routed directly by a rule.
If you already have a proxy service, note the name of the entry currently in use on Home. The list may contain similarly named entries, so record the current selection before switching; you can restore it after testing. The “+” in the upper-right corner of Home adds an entry. It does not start the connection or switch configuration files.
Proxy, Direct, Config, and Scene: Choosing a Global Routing Mode
Open Global Routing from Home. Its options apply to traffic handled by Shadowrocket; they do not guarantee how all network traffic on your device is handled. Choosing Direct does not turn off the connection switch on Home: one changes the traffic handling mode, the other changes the connection status.
Config
RecommendedMatches traffic against the rules in the current configuration file. Requests can use PROXY, use DIRECT, or follow another policy specified in the configuration. For requests that match no earlier rule, check how FINAL handles them.
Best for: An existing rules-based configuration where different requests should be handled by their matching rules.
Proxy
Routes traffic handled by Shadowrocket through a proxy, without applying the individual routing rules in Config. If the proxy service is unavailable, switching to Proxy will not fix the service itself.
Best for: A known network and proxy entry, when you want to check temporarily whether requests can reach their destinations through the proxy.
Direct
Routes traffic handled by Shadowrocket directly, without using the selected proxy server. Home may still show the connection as on.
Best for: Keeping the connection on while comparing the direct result for the same destination.
Scene
Selects a routing mode based on the configured Scene conditions. When checking a Scene, verify both that the current network meets its conditions and which mode the Scene specifies.
Best for: Applying different routing modes on different networks when Scenes are configured.
Config: Check the File Before Reading Its Rules
Open Config from the bottom navigation. First confirm which configuration file is in use, then review its [Rule] section. A file appearing in the list does not mean it is selected, and selecting a file does not mean Global Routing is set to Config. Check both to determine whether the rules you are viewing are being used for routing.
Domain matching
- Rule section
[Rule]- Domain suffix
DOMAIN-SUFFIX,example.com,PROXY- Applies to
example.comand its subdomains, such aswww.example.com- Action
PROXYroutes through the proxy
This is an example rule; it does not mean the current file contains this line.
Address Matching and the Fallback Rule
- Address range
IP-CIDR,192.0.2.0/24,DIRECT,no-resolve- Existing destination IP address
- For example,
192.0.2.25, within this example range - DNS resolution
no-resolvemeans the domain is not actively resolved to match this rule- Fallback policy
FINAL,DIRECT
FINAL applies to requests that did not match any preceding rule. It does not override a rule that has already matched.
Rules are checked from top to bottom, and the first match determines the policy. If the file also contains GEOIP, it matches based on the country or region associated with the destination IP, not the domain suffix in the URL. For example, if an earlier DOMAIN-SUFFIX rule matches, do not use a later GEOIP or FINAL rule to explain how that request is routed. When reading a file, identify the match target first, then check the rule order and the policy in the last column. If no-resolve appears at the end, it is a parameter, not a policy name.
Data: Use Traffic Changes to Check the Connection
Data is the traffic statistics tab in the bottom navigation, not the place to choose a Global Routing mode. Cumulative totals may include traffic from before your test. To see the effect of one action, note the starting values instead of looking only at which number is largest afterward.
- Note the baseline. Open Data and record the counts and units shown. Do not compare a value in KB directly with one in MB.
- Make one request. Keep the routing mode and proxy entry on Home unchanged, then open a familiar webpage. Avoid refreshing other pages or starting a download at the same time.
- Check the same view again. Compare the values before and after. An increase means traffic was recorded, but it may not all come from this request. Little or no visible change may be due to caching or display precision. To assess routing, check Global Routing and the current configuration; total traffic is not a substitute for evaluating rules individually.
Settings and On Demand: Check Why the Connection Starts Automatically
Settings is the settings tab in the bottom navigation. Use Settings → On Demand to check On Demand settings: they determine the network conditions under which a connection is established, not whether a particular domain uses PROXY or DIRECT. If the connection status changes after switching between Wi-Fi and cellular, check this setting first, then check Global Routing.
Open On Demand settings
Open Settings from the bottom navigation, then tap On Demand. Note whether it was enabled so you can restore the original setting after troubleshooting.
Check the network conditions
Review the network conditions set in On Demand and compare them with the network in use when the issue occurred: Wi-Fi or cellular. Check one condition at a time, without changing the configuration file.
Check the connection switch
Return to Home and check the switch. To test again, reproduce the original network change with the same settings and see whether the connection is re-established. Leave Global Routing unchanged so the two changes are not conflated.
FAQ: What If the Same Term Appears in Different Places?
I changed the file in Config. Why aren’t the rules being applied?
First, confirm the selected file in the Config tab at the bottom. Then go to Home → Global Routing and make sure Config is selected. Once both are correct, check whether an earlier rule matches the destination; do not look only at the line you just edited.
I selected Direct. Why is the switch on Home still on?
Direct is a traffic handling mode, not a disconnect command. To compare the direct result, leave the switch on. To stop the connection, return to Home and turn off the connection switch. If the connection starts again, check the On Demand conditions under Settings → On Demand.
The connection is on. Why won’t one webpage load?
Note the full domain, including any subdomain such as www, then check Home → Global Routing. If Config is selected, look for rules that may match the domain, then check FINAL. To compare, keep the network and selected proxy entry unchanged, switch the routing mode once, and try again. Restore the original setting after the test. A difference in access results is a reason to investigate the routing path, but one test alone cannot identify a specific rule as the cause.
Get Shadowrocket and Browse the Guides
Get Shadowrocket for iPhone and iPad on the App Store for a one-time payment of $2.99. The developer is Shadow Launch Technology Limited; check the App Store listing for system requirements. Versions for Mac (Apple silicon and Intel), Windows, Android, and Linux are free and available from this site's download page. This site provides access to the app and usage guides, not proxy services.