Shadowrocket Beginner FAQ: Home, Config, Global Routing & Connecting

Get answers to 10 common Shadowrocket setup questions, from the connection toggle and Global Routing modes to Config files and subscription updates.

Quick overview

The connection toggle starts or stops the tunnel, Global Routing determines how traffic entering the tunnel is handled, and Config provides the rules used for routing. This guide uses the iPhone / iPad interface and is for beginners who already have server details or a subscription. Before troubleshooting, check your server and connection status. If a site only fails in one routing mode, check the rules before importing the subscription again.

1. Home and your first connection

01 · What’s the difference between a server and the connection toggle on Home?

A server entry stores proxy connection details. Select an entry to choose the active server; turn on the toggle at the top of Home to start the system VPN tunnel. Turning the toggle off does not delete the server entry. If the system says VPN is connected, that only means the tunnel has started—it does not confirm that the server authenticated successfully or that a specific site is using the proxy. Whether traffic uses that server also depends on Global Routing and the relevant policy in Config.

02 · What’s the right order for turning on the connection for the first time?

  1. Enter the details

    If you already have server details, go to Home → “+” → Type and choose the protocol specified in your details, such as Trojan. Enter the address, port, and authentication fields exactly as provided. Don’t change the port to 443 just because a protocol often uses it. If you already have a subscription, see Section 4 to import it.

  2. Select the server

    After saving, return to Home and make sure the server you added is selected. If multiple entries have the same name, open them and check the address and port rather than relying on the label. If you have a working Config and want rule-based routing, go to Home → Global Routing and select Config.

  3. Allow the connection

    Return to Home and turn on the toggle at the top. If the system asks to add a VPN configuration, make sure the prompt was triggered by this action, then grant permission and complete any required system verification. If you deny permission, the server can remain in the list, but the tunnel will not start.

  4. Test access

    First, make sure the toggle stays on, then open a site you can normally access. To test the proxy route, also compare it with a destination that clearly matches a proxy policy. Opening a site that already uses DIRECT does not prove that the selected server is working.

2. The four Global Routing modes

03 · What are Config, Proxy, Direct, and Scene for?

Config

Recommended

Uses the rules in the current Config to select a policy. A destination can use a proxy, connect directly, or be rejected. If no earlier rule matches, check the FINAL rule at the end of the Config; don’t assume traffic will always connect directly.

Best for: using a verified Config to route traffic by destination in everyday use.

Proxy

Routes traffic entering the tunnel through the current proxy without choosing policies rule by rule from Config. This applies to traffic entering the tunnel, not every system request on the device.

Best for: temporarily checking whether the current proxy can reach the same destination.

Direct

Routes traffic entering the tunnel directly, without using a proxy server. Selecting Direct does not turn off the Home toggle; the system may still show VPN as connected.

Best for: comparing direct access to a destination while leaving the connection toggle on.

Scene

Selects a routing mode based on conditions you configured in advance. Switching to Scene alone does not create routing rules suited to the current network. Check the scene conditions and corresponding routing settings first.

Best for: switching between routing modes based on conditions when you have configured different network scenarios in advance.

04 · Proxy works but Config doesn’t—what should you check first?

Retest the same domain on the same network with the same server, changing only Global Routing each time. If Proxy works but Config doesn’t, first confirm which Config is active, then check the first matching rule for that domain and its policy. A rule might send it DIRECT, reject the request, or assign it to a policy group that uses a different server. A webpage may also load resources from other domains. If the homepage loads but images or sign-in fail, check those requests separately.

3. Switching Config files and rule order

05 · If Config contains multiple files, does opening one make it active?

Viewing or editing a file does not make it the active Config. Open Config from the bottom menu, select the file you want to use, and confirm it is selected. Then return to Home and check that Global Routing is set to Config. The file selection determines which rules are used; the routing mode determines whether traffic is handled according to those rules. When switching Configs for the first time, keep the original file and note its name and a test domain so you can retest and switch back if needed.

Tell server changes apart from rule changes

Change only the server
  • Select a different server on Home while keeping the current Config and Global Routing settings.
  • Retest with a destination you know will use the current proxy. If the rule specifies another policy group, first check which server is selected in that group.
Change only the Config
  • Select a different file in Config while keeping the current server on Home and leaving Global Routing set to Config.
  • Compare which policy matches the same destination. If the result differs, check the rule order and the FINAL rule at the end.

Change one variable at a time to identify whether the issue is with the server, rules, or routing mode.

06 · Why does rule order matter, and what is FINAL?

Rules in [Rule] are evaluated in order, and the first matching rule usually determines the policy. DOMAIN-SUFFIX matches a domain and its subdomains, IP-CIDR matches an IP range, and GEOIP matches based on the geographic location of the destination IP. FINAL is the fallback when no earlier rule matches and is usually placed last. This is a syntax example, not a complete Config:

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.0.2.0/24,DIRECT
FINAL,DIRECT

If the destination matches the first rule by domain, it goes to PROXY. If the destination is 192.0.2.15 and matches the second rule, it goes to DIRECT. Only if neither rule matches will FINAL,DIRECT apply. If a broader rule matches first, adding an exception after it may have no effect. Put narrower exceptions before the general rules they override.

4. Importing and refreshing subscriptions, and troubleshooting connections

07 · Should I import an existing subscription in Home or Config?

Server subscriptions create and update the server list in Home, while rule-based Config files are managed in Config. If you already have your own server subscription, go to Home → “+” → Type → Subscribe, enter the original subscription URL, and save it. Then return to Home and pull down to refresh. https://example.com/sub?token=xxxx is only an example of the URL format. Query parameters in the actual URL may contain access credentials, so don’t remove any when entering it. Hide the full URL in screenshots or troubleshooting notes.

08 · Home refresh timed out. Does that mean the subscription has expired?

A timeout only means the request did not finish in time. First, check whether your current network can open a regular webpage, then make sure the subscription URL was not truncated when pasted. Retry once on Wi-Fi and once on cellular data. If it times out on only one network, check whether that network can reach the subscription URL. If you get a 401 or 403 response, check the subscription’s authorization status. Refreshing contacts the subscription URL, not the proxy servers shown in the list.

09 · The subscription refreshed successfully, so why can’t I connect?

A successful refresh only means the server list was retrieved; it does not mean every server is working. Return to Home, check which server is selected in the refreshed list, then use Connectivity Test to see its test result. If the test gets a response but the target site still won’t load, keep the server unchanged and compare Proxy with Config. If the test keeps timing out, check the server address, port, protocol settings, and current network. Don’t turn off certificate verification just to make the test pass.

10 · I turned off the connection toggle manually. Why did it reconnect?

Go to Settings → On Demand and check whether conditional connections are enabled. Turning off the Home toggle ends the current connection, but if On Demand is still enabled, the system can start the tunnel again when its conditions are met. To compare behavior before and after disconnecting, temporarily disable On Demand, return to Home, turn off the toggle, and retest the same destination. Restore your settings after testing, as needed.

Get Shadowrocket and learn how to use it

Get the iPhone / iPad version from the App Store for a one-time payment of $2.99. It’s developed by Shadow Launch Technology Limited; check the App Store listing for system requirements. The Mac (Apple silicon / Intel), Windows, Android, and Linux versions are free. Choose your platform on the app page to get the installer from this site.

Download Shadowrocket