If you have a working configuration, use Config for everyday rule-based routing. Temporarily switch to Proxy to check whether a rule is sending traffic the wrong way, or use Direct to test your local network connection. This guide explains how the three modes relate to rules, proxy selection, and the connection toggle, with troubleshooting steps that change one variable at a time. Examples use the Home screen on iPhone and iPad and assume you already have a service provider and a working configuration.
Choose a mode: Config for everyday use, switch temporarily to troubleshoot
In Shadowrocket, Global Routing determines how intercepted traffic is routed. It is not a server list or a connection toggle: selecting Proxy does not establish a connection, and selecting Config does not send every request through a proxy. The actual route also depends on the active configuration, policy selection, and whether the connection is working.
Config (rule-based routing)
RecommendedRoutes traffic according to the rules in the active configuration. Requests matching DIRECT connect directly; requests matching a proxy policy use that route. Requests that match no earlier rule are handled by the policy specified in FINAL.
Best for: everyday use when you have correct rules and need to route destinations differently.
Proxy (proxy routing)
Routes ordinary intercepted traffic through a proxy instead of deciding whether to proxy or connect directly based on individual configuration rules. A working proxy route is still required, and system traffic scope and exclusion settings still apply.
Best for: temporarily checking the proxy route and testing whether rules are causing access issues.
Direct (direct routing)
Routes intercepted traffic directly, without using a proxy server as the exit. This changes the routing mode; it does not turn off Shadowrocket’s connection.
Best for: checking whether your current Wi-Fi or cellular network can reach a destination directly.
If Scene also appears in the list, treat it as a way to select routing based on configured scenes—not as an option that automatically fixes network problems. Check the scene conditions and related settings before using it. This guide keeps the environment fixed and compares Config, Proxy, and Direct manually to avoid adding variables.
Know the difference: Home, Config, and Settings
Home shows the connection status, lets you select a server, and provides Global Routing controls. The Config page is where you manage configuration files, while Settings contains other operating options. Note that Config has two meanings: Config in the routing menu is a routing mode; the Config page at the bottom is where you select and edit files.
- On Home, note the selected server and Global Routing mode. Record the names only; do not share connection credentials.
- Go to Home → Global Routing and select Config, Proxy, or Direct. Return and check the display to confirm the change.
- If you selected Config, open the Config page and make sure the file you want to use is enabled. Importing a file into the list does not enable it.
- Return to Home, check that the connection toggle is in the expected state, then make a new request. When connecting for the first time, follow the system prompt to allow the required VPN configuration.
How Config matches rules: check the order, then FINAL
Config means “use the active configuration,” not “send some websites directly and proxy everything else” by default. Rules are usually evaluated from top to bottom, and the first matching rule determines the policy. Changing the order can therefore change the result. FINAL handles requests that match no earlier rule and should be the last rule in the list.
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY
This rule snippet illustrates matching order; it is not a complete configuration file. PROXY means a proxy policy. Before using it, confirm that the policy is referenced in your active configuration and that its route works. DIRECT means a direct connection. Do not replace your existing configuration with this snippet or remove existing DNS or policy settings.
DOMAIN-SUFFIX,example.com,PROXY: matches example.com and its subdomains by domain suffix and selects the proxy policy. The domain here is only an example of the syntax.IP-CIDR,192.168.0.0/16,DIRECT,no-resolve: matches this IPv4 range and connects directly;no-resolvemeans the domain is not actively resolved for this IP rule.GEOIP,CN,DIRECT: matches based on geographic data for the destination IP and connects directly. A website’s display language alone does not determine whether this rule matches.FINAL,PROXY: sends requests that match no earlier rule through a proxy. If you change it toFINAL,DIRECT, unmatched requests will connect directly.
So if some requests connect directly with Config selected, that may be exactly what the configuration is designed to do. To investigate, first find the rule that matches the destination, then check whether its policy is correct. Rules select how traffic is handled; they cannot fix server authentication errors or restore an unavailable proxy route. See the configuration field reference for details.
Troubleshoot with Proxy and Direct: change one variable at a time
If the same destination fails in Config, do not change the server, DNS, subscription, and network all at once. Even if access returns, you will not know which change helped. Keep one network, one server, and one test destination fixed, then switch modes to get comparable results.
Compare routes: test rule-based and direct connections separately
Config fails? Try Proxy
- Keep the Wi-Fi network, server, and test destination the same.
- Record whether a new request succeeds in Config.
- Switch to Proxy and make the same request again.
- If only Proxy works, first check the matching rule, policy group, and whether both tests used the same actual route.
Need to verify direct access? Try Direct
- Choose a destination that should be reachable directly on your current network.
- Switch to Direct and make the request again.
- If direct access also fails, check network sign-in, DNS, and the destination service’s status.
- If needed, test on cellular and record this network change separately.
In short: success with Proxy only narrows down what to investigate; success with Direct only shows that the destination is reachable directly on the current network. Neither result alone proves that the entire configuration is correct.
A browser may reuse an existing connection or show cached content, so a page that still loads after switching does not necessarily mean the new route was used. Make a new request. If needed, close and reopen the destination app, or disconnect and reconnect Shadowrocket if appropriate. Do not rely only on the status bar icon to identify the route used for a particular request.
- Record the test conditions, such as “same Wi-Fi, same server, same destination.”
- Record the result of a new request in Config, Proxy, and Direct separately. Note only success, timeout, or the specific error—do not present a guess as a conclusion.
- Check the connection log for the destination, matching rule, and actual policy. Use the information shown in the current interface.
- After identifying and changing one setting, return to Config and test again to confirm the change works for everyday routing.
FAQs: switching modes, local networks, and subscription updates
Still timing out in Proxy? Could a rule still be blocking the request?
Not necessarily. First check the selected server on Home, then verify the server address, port, authentication details, and protocol settings in your existing configuration. If your provider specifies port 443, enter 443; do not change the port based on the protocol alone. Proxy will not correct invalid settings, and a failed test may also be caused by the local network or remote service.
Is it normal for the VPN icon to remain after selecting Direct?
Yes. Direct is a routing choice, not a way to turn off the connection. To stop Shadowrocket’s connection, use the connection toggle on Home and check whether Settings → On Demand will reconnect automatically. The VPN icon alone does not show whether a particular request went through a proxy server.
A printer or router admin page won’t open in Proxy. What should I do?
First, try the same local network address in Direct and confirm that both devices are connected to the same network. If direct access works, return to Config and check whether an appropriate DIRECT rule covers the actual local network range and whether an earlier rule takes precedence. The example 192.168.0.0/16 does not cover every private address; configure the rule for your actual address range.
Why does routing still look the same after updating a subscription?
A server subscription and a rules configuration are different things. First check whether the imported content is a server list or a complete configuration. Updating a server subscription usually changes server details; it does not necessarily replace the rules file enabled on the Config page. Return to Config to check the active file, then make sure Home → Global Routing is still set to Config. Avoid importing repeatedly, which can create duplicate entries.
If Config works, do I still need to check it?
Yes, review it when your network environment or existing configuration changes. Keep the configuration you have verified, and note its original state before making changes. If a problem occurs, repeat the comparison with the same test conditions. Do not switch to Proxy permanently because one webpage temporarily fails; account for your direct access, local network, and routing rule requirements.
Restore your everyday settings: check the configuration, route, and connection conditions
When troubleshooting is complete, restore your normal settings. If your configuration has working routing rules, you will usually want to return to Config. If you need to route everything through a proxy temporarily, be clear about the scope and check your settings again when testing is done. No routing mode can automatically make every network accessible.
- On the Config page, confirm that the expected file is enabled—not a test snippet.
- On Home, confirm the selected server or policy group, especially if you still have a temporary route selected from troubleshooting.
- Go to Home → Global Routing, confirm the mode, and test one destination that should connect directly and one that should use a proxy.
- In Settings → On Demand, restore the connection conditions you previously used to avoid unexpected connection behavior the next time you change networks.
Get Shadowrocket for every platform and get started
Get Shadowrocket for iPhone and iPad on the App Store for a one-time $2.99 purchase. The developer is Shadow Launch Technology Limited; see the App Store listing for system requirements. The Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free. Choose your platform on the download page, then follow the guide to complete the initial setup.