This guide uses Shadowrocket on iPhone and iPad as an example. It’s for readers who already have server details or a subscription URL and are preparing to connect for the first time. First, distinguish adding a server, selecting it, and starting the connection. Then use Global Routing and actual browsing results to check how traffic is routed. Mac, Windows, Android, and Linux may have different layouts, so button locations may not match.
01 What do Home, Config, and Settings do?
Adding and selecting a server on Home identifies an available proxy endpoint; turning on the connection toggle starts the tunnel. Even with the tunnel running, whether a request uses that server depends on Global Routing and the active configuration.
- Home: The toggle at the top controls the connection, and
+in the upper-right corner adds server details. The server list shows manually added entries and those imported from subscriptions. Global Routing selects how traffic is routed. - Config: Manage rule configuration files. If the list contains multiple files, the active file is the one in use; saving another file does not switch the active configuration.
- Settings: Manage app settings, such as Settings → On Demand. When checking a connection manually for the first time, leave On Demand disabled so you can distinguish manual actions from system-triggered connections.
02 Should you use Add Server or Subscribe?
Choose based on the details you have, not simply on whether the string contains a slash. Add Server is the entry point; Subscribe is an option under Type. They are not two different transport protocols.
| Details you have | How to add | What to check after saving |
|---|---|---|
| Details for a single server | Home → + → Add Server, then choose the protocol specified in your server details under Type. | A single entry appears in the list, with the host, port, and authentication fields matching your server details. |
| A subscription URL that retrieves a server list | Home → + → Add Server → Type → Subscribe, then paste the complete URL. | After the subscription update finishes, expand the corresponding group and confirm that it contains selectable servers. |
03 Which server fields should you never guess?
Select the Type first, then enter the details as provided. If you choose the wrong protocol, the client may fail to complete the handshake even when the host and port are correct. Being able to open a website does not prove that the corresponding protocol works.
- Server and port: If your details list
example.comas the host and8443as the port, enter them separately in Address and Port. Don’t addhttps://, or change the port to443just because TLS is enabled. - Authentication and protocol options: For example, the encryption method and password for Shadowsocks must match the values in your server details. Other protocols may require a UUID or different transport settings. A display name or subscription URL cannot replace authentication fields.
- After editing: Return to Home and check which entry is actually selected. If two entries have the same name, open each one and check its host and port so you don’t keep testing an older entry.
04 How can you tell whether a subscription imported and updated successfully?
Seeing a subscription group only confirms that its URL was saved. To verify that the server list was retrieved, pull down on Home to refresh, wait for the update to finish, expand the group, and select a server from it.
- If the refresh fails, first confirm that the device can access a known working website on the current network. Then check for extra spaces at either end of the subscription URL and make sure its query string wasn’t cut off.
- If you’re notified that a subscription URL has changed, first check which group you’re updating. Manually added entries aren’t changed by a subscription refresh, and entries with the same name don’t necessarily point to the same address.
- If an entry disappears or the list order changes after an update, check your current selection again. If needed, select another server from the updated group so you don’t mistake an old latency result for a test of the new entry.
05 How do you choose Config, Proxy, or Direct in Global Routing?
Change the routing mode under Home → Global Routing. The three options below are useful for manual comparisons. The interface also offers Scene, which switches modes based on configured scenarios. For an initial comparison, select a mode directly to avoid changes in scenes affecting the result.
Config
RecommendedMatches requests against the rules in the active configuration. A match can route to DIRECT, PROXY, or another configured policy. Traffic that doesn’t match an earlier rule uses the policy specified by FINAL.
Best for: Routing traffic by destination when you’ve enabled and checked your rules.
Proxy
Routes traffic handled by the client through the proxy, without selecting an endpoint based on the rules in Config. Compare it with Config using the same destination to see whether rule selection is the cause of a problem.
Best for: Temporarily troubleshooting an access issue under Config while keeping the same server selected.
Direct
Routes traffic handled by the client directly, without using the selected server. This is a routing setting; it does not turn off the connection toggle on Home.
Best for: Comparing your current network with the proxy route when the destination should be reachable directly.
06 How do you read a routing rule in Config mode?
Open the active configuration in Config and check the rules from top to bottom. The two lines below illustrate the syntax; they are not a complete configuration:
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
DOMAIN-SUFFIXmatches domain suffixes. In this example,example.comandwww.example.commatch the first line and usePROXY.FINALis the fallback rule. In this example, requests that don’t match the preceding line useDIRECT. The fallback policy in an actual file may be different, so don’t assume it uses a direct connection.
If a domain isn’t routed as expected, first check the hostname used by the actual request, then see whether an earlier rule matched. A webpage may also request images or scripts from other domains, so the main page and its resources may use different routes.
07 Where is the connection toggle, and how do you turn it on for the first time?
The connection toggle is at the top of Home, not on a server’s edit screen. Selecting an entry and starting the connection are two separate actions. For the first connection, follow these steps:
Select a server
Go back to Home and select an entry with verified settings from the server list. If it came from a subscription, expand the corresponding group first.
Choose a routing mode
Go to Home → Global Routing. Choose Config if you have a routing configuration you’ve already checked. To test the proxy route through the same server, you can temporarily choose Proxy.
Turn on the connection toggle
Return to Home and turn on the toggle at the top. If the system asks to add a VPN configuration for the first time, confirm that the request is from Shadowrocket, then follow the system prompts to authorize it. This step can’t be completed without authorization.
Check actual browsing
Make sure the toggle stays on, then use a browser to visit a known working destination. When you’re done testing, restore Global Routing to your usual mode.
08 How can you tell if you’re connected?
Check the tunnel status, server test, and destination access separately. A toggle that stays on means the system tunnel is running, but it doesn’t prove the server is usable or that webpage requests are going through the proxy.
- Check the toggle: If it won’t stay on, first check system VPN authorization. If another VPN is connected on the device, disconnect it before testing Shadowrocket on its own.
- Check the test: Run Connectivity Test on Home and see whether the selected server returns a result. A value such as
180 msonly indicates a response to that test; it is not the webpage’s loading time. - Check the destination: Reload a known destination in your browser; don’t rely on a cached page. To verify routing, check Data for a connection record matching the time of this visit and the destination domain, rather than looking only at changes in total traffic.
09 Wi-Fi works but cellular doesn’t. How should you compare them?
Keep the server entry, Global Routing mode, and test domain the same, then test each network separately. Change only the network between tests. If you also change the port, rules, or server, the results won’t be comparable.
Test the same server on two networks
Wi-Fi
- Turn off the Home connection toggle first. Make sure you’ve completed any required sign-in on the current Wi-Fi network and can open a regular website.
- Turn the toggle back on, then record the Connectivity Test result and whether the destination webpage loads for comparison.
Cellular network
- Turn off Wi-Fi in system Settings, confirm the device has switched to cellular, and allow Shadowrocket to use cellular data.
- Repeat the test with the same entry and routing mode. Note separately whether the server test times out and whether the destination webpage loads.
If only one network fails, first check that network’s basic connectivity and system permissions. Don’t start by changing rules shared by both networks.
10 A latency test succeeds, but webpages won’t open. What should you change first?
Don’t change the configuration, DNS, and server all at once. Run a comparison using the same network and destination, then use the result to decide which layer to investigate.
Why does the browser keep loading when the latency test returns a value?
Keep the server unchanged. On Home → Global Routing, temporarily switch from Config to Proxy, then reload the same webpage. If it works only under Proxy, return to Config and check the active file and the rule matched by that destination. If both modes fail, check basic network connectivity, destination DNS resolution, and server details first; a latency result alone doesn’t rule out a server problem.
Other websites load. Why is only this domain failing?
In Data, find the connection record for the domain you just visited. If the destination actually used DIRECT when the configuration should route it through PROXY, check the rule order and domain suffix first. If the route matches expectations, determine whether the issue is a DNS resolution failure, a connection timeout, or an error returned by the webpage.
Why does the connection come back on after I turn it off and switch networks?
Go to Settings → On Demand and check whether On Demand is enabled and whether the current network meets its trigger conditions. For a fully manual test, disable On Demand first, then turn off the connection toggle on Home and switch networks again. Switching to Direct does not disable On Demand.