This guide uses the iPhone / iPad interface and is for anyone new to Shadowrocket or unsure about the two meanings of Config. Use it to find the right place for each task: check connection and routing on Home, review the active rules in Config, view traffic stats in Data, and check app options such as On Demand in Settings.
Home: Connection, Servers, and Global Routing
Home brings together connection status, the server list, and Global Routing. The connection switch shows whether the connection is enabled. The server selection determines which server is used when traffic is routed through the current proxy. Global Routing determines how traffic is routed. An enabled switch alone does not tell you whether a particular website is using the proxy or whether it will be reachable.
Select a server
Select one of your existing servers from the list on Home. If the list is empty and you already have a subscription, add it via Home → “+” → Type → Subscribe. After saving, return to Home and check that the server appears. Saving a subscription URL and successfully retrieving its entries are separate steps.
Check the routing mode
Go to Home → Global Routing. To route traffic by rules, select Config, then check which file is active on the Config page. Editing a file that is not enabled will not change the rules currently in use.
Turn on the connection
Return to Home and turn on the connection switch. The first time you connect, follow the system prompt to approve adding a VPN configuration. Once the switch shows that you are connected, open the page you want to test and note the connection status and the page’s result separately.
Proxy, Direct, Config, and Scene: Four Routing Modes
In Home → Global Routing, these four terms are routing modes, not server protocols. Switching modes changes how traffic is routed; it does not change the protocol of an existing server. The comparisons below describe traffic handled by Shadowrocket, not necessarily every type of system traffic on your device.
Config
RecommendedChoose a policy based on the rules in the current configuration. A matching direct rule can use DIRECT, and a matching proxy rule can use PROXY. If no earlier rule matches, the policy specified by FINAL applies.
Use when: You have a configuration and need to route connections differently based on their destinations.
Proxy
Routes traffic through the proxy without applying Config’s per-rule routing. If a destination works in Proxy mode but not in Config mode, compare the paths each mode uses before concluding that a rule is wrong.
Use when: You want to check whether the proxy route works.
Direct
Routes traffic directly, bypassing the selected proxy server. This is not the same as turning off the connection; Home may still show that the connection is enabled.
Use when: You want to check whether a destination is reachable over a direct connection.
Scene
Selects a routing mode based on the conditions configured for a scene. Check whether the current network meets those conditions and which routing mode the scene uses; the word Scene alone does not reveal the actual route.
Use when: You have scenes set up for different network environments and need routing to change based on conditions.
Config: Configuration Files and PROXY / DIRECT Rules
As a page name, Config is where you view, select, and edit configuration files. As a Global Routing option, Config means routing traffic according to the active configuration. Another common source of confusion is capitalization and context: Proxy / Direct in the menu are routing modes, while PROXY / DIRECT at the end of a rule are policies for that specific rule. Seeing PROXY in a rule does not mean you should switch Global Routing to Proxy.
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
This example illustrates how rules work: when a matchable domain is example.com or one of its subdomains, the first rule specifies PROXY. Requests that do not match the first rule use DIRECT, as specified by FINAL. A real configuration may also include rules that match network addresses, such as IP-CIDR. A webpage may request resources from multiple domains, so the domain in the address bar does not represent every request the page makes.
Keep a copy of the original configuration before making changes, and confirm which file you are editing. When testing, keep the server and network the same and change one thing at a time. If you switch servers, change routing modes, and edit rules all at once, you will not know which change restored access.
Data and Settings: Check Stats and App Behavior Separately
Use Data to view traffic stats and Settings to adjust app behavior. Data helps you see whether traffic has been recorded; Settings is where you check options such as On Demand. An increase in traffic only means that data was transferred within the stats’ scope. It cannot identify which rule matched a domain, and the figures are not a service provider’s billing statement.
Choose a section based on what you’re seeing
Data: Check for changes in traffic stats
- Before testing, note the traffic figures currently shown. Make a new request, then return to Data and check for a change.
- When you revisit the same page, caching may reduce the number of new requests. Apps running in the background may also generate traffic, so don’t attribute the entire increase in stats to one webpage.
Settings: Check automatic connection
- Go to Settings → On Demand to see whether it is enabled and whether the selected conditions apply to your current network.
- To check whether the connection stays off after you disconnect manually, note the original settings first. Temporarily turn off On Demand, return to Home and test again, then restore the original settings.
On Demand affects when a connection is established. Once connected, the route is still determined by Global Routing.
Common Questions: Find the Next Step in the Interface
I changed Config. Why didn’t the result change?
First, go to Home → Global Routing and make sure Config is selected. Then open Config and confirm that the file you edited is the one in use. Next, check whether an earlier rule matches the destination. Once an earlier rule matches, later rules are not evaluated for that same match.
Connectivity Test shows a result. Why won’t the webpage load?
A test result reflects that particular probe; it does not confirm that the destination webpage or all its resources are reachable. Note the server and Global Routing mode shown on Home, then retry the same destination on the same network. If it fails only in Config mode, first check which route the rules assign to the destination. If it also fails in Proxy mode, check the selected server and whether the destination is reachable.
I refreshed my subscription. Why didn’t the rules in Config change?
First, check what you refreshed. On Home, see whether the subscription entry in the server list has updated. To check a rules file, open Config and review the active file and its contents. Updating a server subscription does not update rules in a separate configuration file.
I selected Direct. Why does Home still show connected?
Direct changes the routing mode, not the connection status. To disconnect, use the connection switch on Home. If it reconnects automatically, check the trigger conditions under Settings → On Demand.