Shadowrocket Setup: 10 Common Questions for First-Time Users

Answers to 10 common Shadowrocket setup questions, from choosing a Global Routing mode and importing subscriptions to On Demand and pricing across platforms.

At a glance

This guide is for first-time Shadowrocket users who already have connection details from a service provider. The steps use iPhone and iPad as examples: import and select a server on Home, then check Global Routing and grant the system VPN permission. If the switch is on but webpages still have problems, troubleshoot in this order: subscription, server, then rules. Decide whether to enable On Demand only after that.

1. Where can I get Shadowrocket, and how much does it cost?

Choose your device in the download guide. Installing the app and getting connection details are separate steps. If no servers appear on Home after installation, add your own server details or import a subscription from your service provider.

2. Which screen should I check first?

Start on Home. Your first connection involves three separate actions: add a server, select it, and turn on the connection switch. Seeing an entry in the list only means its details have been saved; it does not mean your device is connected.

Home
Add or select a server, check the current Global Routing mode, and use the connection switch.
Config
Choose a configuration file and review its rules. Traffic is routed according to the selected configuration only when Config is selected under Global Routing.
Settings
Review the app settings, including On Demand. For your first test, leave On Demand off so you can observe what happens when you manually turn the connection on and off.

3. How do I import a subscription and select a server?

Use the complete subscription URL from your service provider, including any parameters after the question mark. A subscription URL may contain access credentials, so don't include it in screenshots, public logs, or support posts.

  1. Open the add screen

    Go to Home and tap “+” in the upper-right corner. This is where you add connection details; rule files are imported from Config, not here.

  2. Choose the subscription type

    Open Type and select Subscribe. Don't enter a subscription URL in the address or port field for an individual server.

  3. Paste and save

    Paste the full URL into the URL field and tap Save. Check for extra spaces at either end and make sure no query parameters are missing.

  4. Refresh and select a server

    Return to Home and pull down to refresh if needed. Check that server entries appear under the subscription group, then tap one to select it. Saving a subscription and selecting a server are separate actions.

4. Why is the list still empty after I save a subscription?

First check whether the entire subscription group is missing or the group is there but contains no entries. If the group is missing, make sure you tapped Save. If it is present but empty, check the update result. Avoid adding the same URL repeatedly; it can be hard to tell the previous list from the latest refresh.

The refresh keeps timing out. What should I check first?

First, check that your current Wi-Fi or cellular connection can load a regular webpage. If public Wi-Fi requires a login, complete that step before returning to Home and refreshing. If it still times out, try another network. If no server is available, repeatedly toggling the connection switch won't refresh an empty list.

Why does the link open a login page instead of showing servers?

An account management page and a subscription URL serve different purposes. Copy the complete URL intended for importing into the app from your service provider, then check the URL for that subscription entry on Home. Don't use a login page URL or a URL redirected by your browser as the subscription.

What if entries were there before but disappeared after an update?

Ask your service provider whether the subscription is still active, whether its URL has changed, and whether the returned content is compatible with Shadowrocket. If they provide a new URL, save it and refresh on Home. Confirm that entries appear before testing the connection.

5. How do I enter details for a single server?

On Home, tap “+” and select the protocol specified in your connection details under Type. Enter each value exactly as provided. Even with the same server address, the fields for Shadowsocks, VMess, VLESS, Trojan, Hysteria2, and WireGuard are not interchangeable.

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

Go to Home → Global Routing. This controls how connections handled by Shadowrocket are routed; it doesn't import subscriptions or select a server for you. Before everyday use, confirm that Config has the configuration file you want selected.

Config

Recommended

Rules are checked in order against the selected configuration, and matching connections use the specified policy. Connections that don't match an earlier rule are handled by FINAL. Whether traffic uses PROXY or DIRECT depends on the rules.

Use when: You have checked your rules and want to route traffic by rule.

Proxy

Sends traffic that enters the app and can be proxied through the selected proxy, without applying Config's routing rules. With the same network and server, use this mode for a brief comparison with Config.

Use when: You want to tell whether a problem is caused by the server or routing rules.

Direct

Uses a direct route for traffic entering the app, without the selected proxy. This is a routing mode; it is not the same as turning off the connection switch on Home.

Use when: You need a temporary baseline without the proxy.

Scene

Switches routing policies according to configured scenes and their matching conditions. Before selecting this mode, check the scene conditions and corresponding policies. If you haven't tested your scenes, start with a fixed mode.

Use when: You have configured scenes and need policies to change across network environments.

7. Why does the system ask to add a VPN configuration the first time I connect?

The first time you turn on the connection switch on Home on an iPhone or iPad, the system may ask permission to add a VPN configuration for Shadowrocket. This permission creates a system tunnel; it doesn't confirm that the remote server is reachable or guarantee that every website will use the proxy.

  1. First, make sure a server is listed on Home and that you've selected the one you want to test.
  2. Turn on the connection switch on Home. If the system requests permission, check which app is requesting it, tap Allow, and complete any device verification prompted by the system.
  3. Return to Home and confirm the switch stays on, then open a test webpage. If the switch turns off immediately, check for unfinished permission prompts, system management restrictions, or another active VPN before checking the server.

8. The switch is on. How can I confirm the connection works?

Check the system connection status, server test result, and target webpage separately. A switch that stays on means the app's tunnel is running. A millisecond result from Connectivity Test means that test received a response using the current settings; it doesn't guarantee access to other websites or indicate download speed.

  1. Run Connectivity Test on the current server from Home. If it times out, test another available server on the same network for comparison. If you have only one server, keep it selected and try again over Wi-Fi or cellular.
  2. Reload a webpage that normally works without a proxy in your browser as a baseline, then reload the target webpage. Don't rely on an old open tab; cached content may not reflect the current connection.
  3. If only the target webpage fails, keep the network, server, and URL unchanged, temporarily switch Global Routing from Config to Proxy, and test again. If it works with Proxy but not Config, check the routing rules first. If both modes fail, this comparison alone doesn't prove the rules are at fault. Switch back to the original mode when you're done.

9. Only certain domains fail with Config. Which rules should I check?

Open the selected file in Config. First look for rules targeting the domain, then check whether a broader rule appears before them. This minimal example illustrates rule order; you don't need to replace your entire configuration.

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

10. When should I enable On Demand, and how do I check its triggers?

First test the server and routing with a manual connection, then go to Settings → On Demand. On Demand controls when the system starts a connection based on conditions; it doesn't fix subscription refresh or server problems. Once enabled, manually turning off the connection may not keep it disconnected: the system may reconnect when a condition is met again.

Test On Demand by network type

Regular Wi-Fi
  • If you only need a connection for occasional tasks, start in manual mode. On Wi-Fi with a login page, complete the network login before testing the connection.
  • If you've set a trigger for this Wi-Fi network, disconnect and rejoin the network, make a request, then check the connection status on Home.
Cellular
  • Enable the relevant On Demand condition only if you need an automatic connection and have confirmed that the server works over cellular.
  • Turn off Wi-Fi in your device's system settings so the request uses cellular, then check Home. If a connection is needed but doesn't start, first check whether the current network meets the condition.

Test one network type at a time. To troubleshoot unexpected reconnections, first turn off On Demand in Settings → On Demand, then turn off the connection switch on Home. This helps distinguish automatic triggers from a faulty switch.

Download Shadowrocket