Shadowrocket Beginner’s Guide: Global Routing, On Demand & Your First Connection

Get answers to 10 common first-time setup questions, from Global Routing modes and VPN permissions to subscription updates and On Demand.

In this guide

This guide is for users who have received connection details or a subscription from their own service provider but haven’t connected yet. Learn the difference between the client, servers, and Config, then import your details, grant permission, and test connectivity. Finally, check subscription updates and On Demand. Steps use the iPhone / iPad interface; system authorization may differ on desktop and Android, so don’t assume the same system prompts apply.

1. Why can’t I connect right after installing Shadowrocket?

Shadowrocket is a rule-based proxy client. Installing the app only sets up the local tool; you also need valid server details and an account or credentials authorized to use that server. Get subscription links from your own service provider. This site does not provide, sell, or recommend servers or subscriptions.

On iPhone / iPad, Shadowrocket is a one-time $2.99 purchase on the App Store. The developer is Shadow Launch Technology Limited, and the app ID is 932747118. Check the App Store listing for system requirements. The Mac (Apple Silicon and Intel), Windows, Android, and Linux versions are free to download from this site. Buying the client doesn’t include a service plan; the app price and your provider’s service fees are separate.

2. What are Home, Config, and Settings for?

Start with these three sections to avoid changing unrelated settings while troubleshooting. Home is where you select a server and manage the connection; Config is for rule configurations; Settings contains app-wide options. Selecting a server doesn’t mean the right rule configuration is active. Importing a Config also doesn’t guarantee that every policy it references is available in your environment.

SectionWhat to check on first useCommon misconception
HomeServer entries, selected server, connection switch, and Global RoutingA server in the list means the connection is working
ConfigActive Config, rule order, and policies referenced by rulesAny Config can be applied to an existing server list
SettingsApp settings such as On Demand and SubscribeTurning on automatic connection fixes incorrect server details

3. Which of the four Global Routing modes should I use?

Global Routing determines how traffic is handled overall. For everyday rule-based routing, first make sure your Config is valid, then select Config. To troubleshoot rules, you can temporarily switch to Proxy for comparison. This won’t fix an unavailable server, failed authentication, or an underlying network problem.

Config

Recommended

Handles requests using the rules and policies in the active Config. Requests matching DIRECT connect directly; requests matching a proxy policy are routed through that policy. Requests with no match are handled by later rules or FINAL.

Best for: everyday rule-based routing with a working Config

Proxy

Routes traffic handled by the client through a proxy instead of applying the individual routing rules in Config. You still need to select a working server or proxy policy.

Best for: temporarily testing the proxy route or comparing the effect of rules

Direct

Connects traffic handled by the client directly. Even with the connection switch on, requests aren’t necessarily going through a remote proxy server.

Best for: checking whether your local network can reach a destination directly

Scene

Uses the configured Scene. Before switching, check its matching conditions and corresponding actions. If no Scene is configured, don’t treat this mode as an automatic server-selection feature.

Best for: setups with explicitly configured and tested Scene conditions

4. What’s the right order for adding a subscription and connecting?

Import first, select a server next, then authorize the connection. Subscription URLs contain access credentials, so don’t share them in public comments or screenshots. The example https://example.com/sub?token=xxxx is for illustration only and cannot be used to import a subscription. When copying your actual URL, keep its query parameters and remove any quotation marks, spaces, or line breaks added by a messaging app.

  1. Get the link ready

    Get the subscription link from your own service provider. Make sure your account is active and that you have a client subscription URL, not an account management webpage.

  2. Add the subscription

    Go to Home → tap “+” in the upper-right corner → Type → Subscribe. Enter the full URL, add a recognizable remark, and save.

  3. Check the entries

    Return to Home and check whether the subscription contains any servers. If it hasn’t fetched any entries, update the subscription. Select a server your provider has marked as available.

  4. Connect

    Check Home → Global Routing, then turn on the connection switch on Home. When the system first asks to add a VPN configuration, verify that the request matches the action you just took, allow it, and complete device authentication.

  5. Test access

    Run Connectivity Test on Home, then use a browser to visit the site you need. Once both the test and webpage access work, adjust routing settings one at a time.

5. Should I allow the system to add a VPN configuration?

On iPhone / iPad, Shadowrocket uses a system network extension to receive and process traffic. Allowing it to add a VPN configuration on first connection sets up this local traffic-handling path. A VPN indicator only shows that the relevant tunnel is active; it doesn’t confirm successful authentication with a remote server or prove that all websites are routed through a proxy.

Don’t delete unfamiliar system configurations in bulk while troubleshooting. Work or school-managed devices may restrict adding VPN configurations, so check the device policy first. Other VPN apps that connect automatically may also interfere or take over the connection. Disable their automatic connections one at a time before comparing results.

6. What’s the difference between closing the app, disconnecting, and On Demand?

Leaving the app doesn’t disconnect the system tunnel. To stop proxy traffic during normal use, turn off the connection switch on Home and check the system status. If it reconnects shortly afterward, check Settings → On Demand first instead of repeatedly force-quitting the app.

Choosing between manual connection and On Demand

Manual connection
  • While troubleshooting for the first time, turn off On Demand in Settings → On Demand.
  • When you need a connection, turn on the Home connection switch.
  • When you’re done, turn the switch off and make sure the connection doesn’t start again automatically.
On Demand
  • Once manual connections are stable, configure Settings → On Demand.
  • Check each network matching condition and its corresponding connection action.
  • Test separately on Wi-Fi and cellular to make sure the conditions don’t apply more broadly than expected.

On Demand controls when a connection starts; Global Routing controls where traffic goes after it connects. They serve different purposes and can’t replace each other.

7. What does a subscription update change? Do I need to re-import it every day?

You usually don’t need to delete and recreate a subscription every day. An update fetches the latest entries published by your provider, which may change addresses, ports, names, or authentication details. After updating, check which server is selected, especially if an existing entry was removed or renamed. Server subscription updates don’t necessarily update Config rules; check these two sources separately.

If there are no working servers, turning on Update via Proxy won’t create a usable proxy route. First check whether the subscription is reachable on your current network, or ask your own provider to verify the link and account status.

8. Which protocol should I choose in Add Server, and what port should I enter?

The Type must match the protocol provided by your service provider. Don’t choose based on the name or personal preference. Shadowsocks, VMess, VLESS, Trojan, Hysteria2, and WireGuard use different fields; changing the Type for the same address usually won’t produce a working connection. If the subscription imported the server correctly, keep the supplied details and don’t change the protocol, port, and TLS settings all at once.

FieldWhat to check
Address / PortCheck the address and port together. 443 is common, but it isn’t a standard port for every protocol or server. If your provider specifies 8443, don’t change it to 443.
AuthenticationEnter the Shadowsocks method and password, the VMess / VLESS UUID, the Trojan password, and other credentials according to the selected Type.
TLS and transportCheck the TLS settings, Server Name, transport type, and path required by your provider. The server address may differ from the domain used on its certificate.
Protocol-specific settingsUse all provider-supplied settings, including Hysteria2 authentication and transport options or WireGuard keys and tunnel addresses.

9. How do Config rules work, and why does their order matter?

Rules are generally checked from top to bottom, and the matching rule’s policy is applied. Put specific requirements first, broader rules later, and FINAL last. The lines below illustrate rule syntax; they aren’t a complete Config you can use to replace an existing file. PROXY must refer to a valid policy in your Config, so don’t copy the name without checking its definition.

DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
GEOIP,CN,DIRECT
FINAL,PROXY

If a site works in Proxy but fails in Config, first check which rule matches the domain, whether its policy points to a valid target, and whether an earlier, broader rule is catching the request. Don’t delete all the rules first; you’ll lose the comparisons needed to find the problem.

10. Connected, but webpages won’t load? What should I check first?

Use one destination, one server, and one network for each test so the conditions stay consistent. Note whether the connection was established, whether Connectivity Test timed out, and the exact browser error. Then compare one factor at a time. A latency result in milliseconds isn’t a download speed, and a single timeout doesn’t mean all traffic is unavailable.

The VPN indicator is on, but webpages still won’t load?

Go back to Home and make sure a working server is selected, then check that Global Routing is set to the mode you expect. Run Connectivity Test. If a site that should connect directly also fails in Direct, check your local Wi-Fi sign-in page, cellular data permissions, and network connection first.

Sites load in Proxy but not in Config?

Keep the same server and destination, and change only Global Routing. If the difference is repeatable, check the matching rule, policy name, and FINAL in Config, then review DNS-related settings. Restore your usual mode after testing.

It fails on cellular. What should I change?

Using the same server, record the results on Wi-Fi and cellular separately. Make sure the app has permission to use cellular data, then check the network conditions in Settings → On Demand. If only one server fails on a particular network, give your provider the network type, error message, and time of the failure. Don’t share passwords or subscription URLs publicly.

You’ve completed the first connection when you know where the connection details came from, system authorization works, the target website is reachable, and traffic is routed as configured in Global Routing and Config. Once that’s confirmed, enable On Demand or adjust other rules. If an issue comes up later, you’ll have a tested baseline to return to.

Download Shadowrocket