This guide uses the English interface on iPhone and iPad. It’s for anyone new to Shadowrocket who needs help identifying screens and options. Start on Home to check the connection, server and routing mode. Then open Config to review rules, Data to check traffic, or Settings to check automatic connections. Config can refer to either the Config screen or the option under Global Routing; they serve different purposes.
Home: Connection Status, Servers and Connectivity Test
Home is where you check the current connection status and select a server. Not Connected means Shadowrocket has not established a connection; it does not mean your device is offline. Connected means the VPN connection is active, but it does not guarantee that a particular website will load through the selected server. The first time you turn on the connection, your device may ask to add a VPN configuration. If the request is from Shadowrocket, approve it as prompted by the system, then return to Home and check the status. The interface may look different on Mac, Windows, Android and Linux, so the mobile tab locations may not apply.
Check the connection status
Open Home and check the top switch and its status. When troubleshooting access, note whether it says Connected or Not Connected first. This helps avoid mistaking results with the connection off for a proxy test.
Check the selected server
Check the selected entry in the SERVER list on Home. If the list contains multiple entries, note which one is selected. Entries with similar names may point to different connection endpoints.
Check the routing mode
Open Home → Global Routing and check whether Config, Proxy, Direct or Scene is selected. A selected server does not route ordinary direct connections through that server when the mode is Direct.
Run two separate tests
Return to Home and run Connectivity Test, then reload the affected page in a browser. The test checks connectivity using its own test method; reloading checks the specific destination. If the test succeeds but the destination remains unavailable, check the routing mode or the destination itself rather than relying on the test result alone.
Global Routing: Choosing Config, Proxy, Direct or Scene
Global Routing determines how Shadowrocket handles connections routed through it; the connection switch controls whether the VPN is running. Changing the routing mode does not disconnect the VPN. When troubleshooting, keep the server and network unchanged, switch only one option at a time, and retest the same destination to isolate the cause.
Config
RecommendedUse the rules in the current configuration file to choose a policy for each request. If none of the earlier rules match, check FINAL at the end of the file; no match does not automatically mean a direct connection.
Best for: Routing traffic by destination after checking that the rule file is enabled and configured.
Proxy
Route traffic handled by Shadowrocket through the proxy, rather than choosing Proxy or Direct for each request as Config does. If a destination works in Proxy but fails in Config, check which rule matches and the policy it applies.
Best for: Temporarily testing the proxy route. Restore the previous routing mode when you’re done.
Direct
Send connections handled by Shadowrocket directly, without using the selected proxy server. The VPN switch can remain on, so the VPN icon in the status bar does not tell you whether a request went through the proxy.
Best for: Keeping the VPN connection active while comparing results with a direct connection.
Scene
Choose routing behavior based on configured scenes and their conditions. If behavior changes after switching between Wi-Fi and cellular, check which scene is active and its associated routing settings. Don’t assume they match the previous network’s settings.
Best for: Switching routes based on conditions when scenes are configured for different network environments.
Config: Checking the Active Rule File and Match Order
The Config screen manages configuration files; Home → Global Routing → Config enables routing based on a configuration. Importing or editing a file does not mean the app is using it to evaluate requests. After making changes, check the active file on the Config screen, then return to Home and confirm the routing mode. PROXY and DIRECT in a rule are policies for that rule, not the app-wide Proxy or Direct mode.
Example Domain Rules
- Exact match
DOMAIN,api.example.com,DIRECT- Suffix match
DOMAIN-SUFFIX,example.com,PROXY- If no rule matches
FINAL,DIRECT
Place these three lines in [Rule] in the order shown. The exact-match rule comes first so a broader suffix rule does not match it first.
Check the result for each request
api.example.com- Matches
DOMAIN: useDIRECT. www.example.com- Matches
DOMAIN-SUFFIX: usePROXY. example.org- If neither earlier rule matches, use
DIRECTviaFINAL.
These results assume the three example lines are the complete rule set, the app matches by domain, and the routing mode is Config.
When troubleshooting, distinguish the domain from the destination IP. DOMAIN and DOMAIN-SUFFIX match domains; IP-CIDR matches an address range, such as 192.0.2.0/24; and GEOIP matches the geographic location associated with the destination IP, not your device’s location or the website’s language. If you test by entering an IP address directly, the result cannot verify a rule written for a domain. A single webpage may also load resources from multiple domains, so loading the main page does not mean every request follows the same policy.
Data and Settings: Where to Check Traffic and Automatic Connections
Data shows traffic statistics recorded by the app; Settings controls app behavior. If the connection comes back after you disconnect manually, first check Settings → On Demand. If the connection stays on but you want to confirm whether the app has recorded new traffic, check Data. Traffic totals and connection status answer different questions and are not interchangeable.
Choose where to check based on what you see
Data: Check traffic changes
- Note the upload and download totals for the current period, make a new request, then return to Data and see whether the counters changed.
- In-app counters are not a service provider’s billing records. Background connections can also use traffic, while cached pages may generate little or no new traffic during a visit.
Settings: Check automatic connections
- Open Settings → On Demand. Check whether it’s enabled, which conditions apply to the current Wi-Fi or cellular network, and what connection behavior is set for them.
- To test a manual connection, note the current settings, temporarily turn off On Demand, then return to Home and use the connection switch. Restore the original settings after testing.
On Demand controls when the VPN connects or disconnects automatically. Global Routing controls how connections entering Shadowrocket are routed. Data displays traffic statistics.
Common Interface Questions
Why didn’t changing Config affect the result?
First, check Home → Global Routing and make sure Config is selected. Then open Config and confirm the file you just saved is active. Finally, check whether a broader rule above the one you’re testing matched first, and reload the destination page. Don’t use a page that has already finished loading to judge whether a change took effect.
Why didn’t updating a subscription change the rules?
Updating a server subscription and updating a configuration file are separate actions. First, check the updated entries in the SERVER list on Home and confirm that the server you need is selected. Then check the rule file in Config. If you need to add or update a subscription URL, get it from your service provider.
Why is the VPN icon still showing after switching to Direct?
Direct changes the routing method; it does not turn off the VPN. To end the Shadowrocket connection, turn off the connection switch on Home and confirm the status says Not Connected. If it reconnects automatically, check the current network’s trigger conditions under Settings → On Demand.
Why can’t I open a webpage even though Connectivity Test returned a result?
A successful test only confirms that the destination and method used for that test worked. Keep the network and server the same, check the webpage using the current routing mode, then compare the result with Proxy or Direct. If it fails only in Config, return to Config and check which rule matches the domain actually accessed and which policy that rule applies.
Download Shadowrocket and Get Started
Get Shadowrocket for iPhone and iPad from the App Store for a one-time payment of $2.99. Check the App Store listing for system requirements. Verify the developer, Shadow Launch Technology Limited, the official app icon and app ID 932747118. The Mac (Apple Silicon and Intel), Windows, Android and Linux versions are free; download their installers from this site’s download page.