How to Use Shadowrocket: 10 Common Beginner Questions

Answers to 10 common questions about Shadowrocket, from finding the connection toggle and choosing Global Routing to refreshing subscriptions and troubleshooting. Includes steps for each task.

In this guide

To get started with Shadowrocket, import your existing connection details, select a server and choose a Global Routing mode, then turn on the connection toggle in Home. Menu paths below use iPhone and iPad as examples. Mac, Windows, Android and Linux users can check the installer for their device, then follow the same sequence to review connection details, routing and network status.

01 Can I use Shadowrocket on a computer or Android?

Yes. Shadowrocket is available for iPhone, iPad, Mac, Windows, Android and Linux. Start with the download page for your device, then check the system requirements and installer. Menu names on mobile may not match those on other platforms.

Two ways to get Shadowrocket
iPhone / iPad: $2.99 one-time purchase on the App Store. Mac / Windows / Android / Linux: free; installers are distributed from this site.
Two Mac chip options
Choose the installer for Apple silicon or Intel. Check your chip or processor in About This Mac.

For iPhone and iPad, check the App Store listing for system requirements. On the product page, confirm the developer is Shadow Launch Technology Limited and the app ID is 932747118. Buying the app and getting connection service are separate: after installing, you still need to import connection details you already have.

02 Where do I import an existing subscription link?

A subscription link retrieves a list of server entries. If you only have a protocol, server address, port and authentication details, add a single server using the relevant protocol. Don’t enter a server address in the subscription URL field.

  1. Open the add screen

    Go to Home, tap “+” in the top-right corner, then open Add Server.

  2. Choose the subscription type

    Open Type and select Subscribe. To add a single server manually, choose its protocol based on the details you have; don’t select Subscribe.

  3. Paste and save

    Enter the full subscription link in URL, then save. A link might look like https://example.com/sub?token=xxxx; this is only an example format. Real links may contain access credentials, so don’t post them publicly.

  4. Check the server list

    Return to Home to view the subscription entries. Pull down to refresh if needed. Expand the subscription and select a server. Seeing entries in the list means the details were retrieved; it doesn’t mean a connection is active.

03 Why am I still connected to the same server after refreshing a subscription?

Refreshing a subscription retrieves the list again; it doesn’t switch servers automatically. Existing entries may have updated settings even if their names haven’t changed. Likewise, a newly added entry doesn’t become the active connection just because it appears in the list.

  1. On Home, pull down to refresh and wait for the request to finish. If it times out or returns an error, first check that your network works, then confirm the link is complete and still valid.
  2. Expand the relevant subscription and check that the server you want is still listed. If the previous entry has been removed, manually select another available entry.
  3. If you’re troubleshooting a connection after an update, turn the Home connection toggle off and on, then test the same webpage again. Don’t change Config or switch networks at the same time, or it’ll be difficult to tell what changed the result.

If a refresh fails, keep the old entries for reference; there’s no need to repeatedly delete and re-import them. If the list is still visible but refreshing returns an error, Shadowrocket still has the old details. That doesn’t confirm the subscription URL is currently reachable.

04 Where is the connection toggle? What should I do the first time I turn it on?

The connection toggle is at the top of Home. Tapping a server entry selects the connection target; turn on the toggle to start connecting. The first time you enable it on iPhone or iPad, iOS may ask permission to add a VPN configuration.

05 Which Global Routing mode should I choose?

Go to Home → Global Routing. For everyday rule-based routing, choose Config. To troubleshoot a single webpage, you can temporarily switch to Proxy for comparison, note the result, then restore your original setting.

Everyday routing and temporary troubleshooting

Config: Route by rules

  • Uses the currently enabled Config and routes each request according to the matching [Rule].
  • Changing servers doesn’t change the rules. If a request matches DIRECT, it still connects directly.

Proxy: Compare the proxy route

  • Routes intercepted requests through the proxy instead of deciding the route for each one using the rules in Config.
  • Keep the server and network unchanged, then retry the same webpage. If it works only in Proxy, check the rules in Config first.

Direct sends intercepted requests directly; it doesn’t turn off the Home connection toggle. Scene selects a routing mode based on its configured conditions.

06 Why should I check Config after importing a subscription?

A subscription provides server options; Config determines which requests use the proxy and which connect directly. Check which file is active on the Config page, then choose Config under Home → Global Routing. Editing a file without enabling it won’t change how the current connection routes traffic.

Rule examples

[Rule]
Place the following rules in this section, in the order shown.
DOMAIN-SUFFIX
DOMAIN-SUFFIX,example.com,PROXY: Matches the domain and its subdomains, then routes them through the proxy.
FINAL
FINAL,DIRECT: Sends requests that don’t match earlier rules directly.

This snippet demonstrates rule matching order; it isn’t a complete configuration. Rules are evaluated in order, so FINAL usually goes at the end.

What must be in place

Config file
Check the active file on the Config page and keep a copy before making changes.
Routing mode
Check that Home → Global Routing is set to Config.
The request itself
If a page redirects to another domain, the new request is matched against rules for that domain.

Change one rule at a time while testing. If the result isn’t what you expect, first check whether an earlier rule matches the destination domain.

07 Why does Shadowrocket connect automatically after I switch networks?

On iPhone or iPad, first check Settings → On Demand. On Demand controls when to connect or disconnect under specific network conditions. Global Routing determines how requests are routed after the connection starts. These settings handle different things.

  1. Go to Settings → On Demand and check whether it’s enabled, along with the conditions set for Wi-Fi and cellular networks.
  2. To connect manually, turn off On Demand first, then use the connection toggle on Home. To keep automatic connections, change only the network conditions you want to adjust.
  3. Reconnect to Wi-Fi, or switch to cellular if cellular data is enabled, then return to Home and check whether the toggle changes as expected. Don’t change Global Routing during the test.

For example, if the toggle turns on by itself when you switch from Wi-Fi to cellular and the behavior recurs after you turn it off manually, check for a matching On Demand condition first. There’s no need to delete the subscription or reset Config.

08–10 Webpages won’t load after connecting: narrow down the cause

08 The toggle is on, but no webpages load. What should I check first?

Turn off the Home connection toggle and, on the same network, try a webpage that usually works without a proxy. If that fails too, check whether Wi-Fi requires sign-in or cellular data is available. If it works, turn the connection back on and run Connectivity Test on Home to see whether the current server passes. A successful test only confirms that its test destination is reachable; return to your browser and try the original page again.

09 Only one webpage won’t load. Should I switch servers first?

Keep the current server. Under Home → Global Routing, temporarily switch from Config to Proxy and reopen the same URL. If it loads in Proxy but not Config, switch back to Config and check which file is active and which rules match the destination domain, especially earlier DIRECT rules and the final FINAL rule. If both modes fail, don’t conclude from this comparison alone that the rules are the cause.

10 Wi-Fi works, but cellular doesn’t. What should I check?

First check whether the Home connection toggle is still on after switching networks. If it’s off, check the cellular conditions under Settings → On Demand. If it’s on, run Connectivity Test on both networks using the same server. Note the network type, routing mode and error message to distinguish a change in connection status from a server that fails the test on one network. Don’t include the full subscription link when sharing troubleshooting details.

Download and set up Shadowrocket

Get the iPhone / iPad app on the App Store for a one-time $2.99 purchase. Check the App Store listing for system requirements. The Mac (Apple silicon and Intel) / Windows / Android / Linux versions are free; installers are distributed from this site.

Download Shadowrocket