Shadowrocket: 10 Beginner Questions Answered

Answers to 10 common beginner questions on Add Server, Subscribe, Global Routing, connection setup, and troubleshooting in Shadowrocket.

At a glance

To get started with Shadowrocket, confirm how to obtain the app, import connection details you already have, choose a server and routing mode, allow the system to create a VPN configuration, and test a request. This guide uses Home, Config, and Settings on iPhone / iPad as its reference, and explains subscriptions, rules, and system connections as separate layers. On other platforms, check the equivalent options in their respective interfaces rather than assuming mobile menus are in the same place.

1. What should I prepare, and can I use Shadowrocket on a computer or Android?

Yes. Shadowrocket is a rule-based proxy client available on multiple platforms. Get the iPhone / iPad version from the App Store for a one-time payment of $2.99. The Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free. See the download page for all platforms for platform-specific options. Desktop, Android, and Linux installation packages are provided on this site.

Before purchasing on iPhone / iPad, confirm that the developer is Shadow Launch Technology Limited and the app ID is 932747118. Check the App Store page for system requirements. A one-time app purchase is not a service plan; after installing the app, you still need connection details or a subscription URL from a provider you already use. This site explains client operations only; it does not provide, sell, or recommend connection services. Use your own existing subscription.

2 ways to get it
iPhone / iPad: $2.99 one-time; Mac / Windows / Android / Linux: free
3 main sections
Main areas on mobile: Home / Config / Settings
4 routing modes
Global Routing: Proxy / Direct / Config / Scene

2. What do Home, Config, and Settings each do?

Start by treating connection details and rule configuration as separate things. The server list answers “where to connect,” Config determines “which policies apply to which requests,” and Settings controls app behavior. Seeing a server in Home does not mean the right rules are enabled. Likewise, a file in Config is not necessarily selected as the active configuration.

SectionMain purposeWhat to check first
HomeManage servers, subscriptions, the connection toggle, and Global Routing.Check whether a server is selected and which routing mode is active.
ConfigManage and select rule configuration files.Check that the active file is the one you intend to use.
SettingsAdjust app options such as On Demand.During troubleshooting, avoid automatic connection conditions that could interfere with manual tests.

Complete a manual connection test before changing automation options. If you change the server, DNS, rules, and On Demand all at once, it will be hard to identify which change caused a difference.

3. Should I use Add Server or Subscribe?

If you have one set of server details—an address, port, and credentials—enter them manually with Add Server. If you have a subscription URL the app can read, set Type to Subscribe in the add screen. A subscription usually contains multiple connection entries, and its contents may change when updated. Manually entered entries usually need to be maintained by you.

  1. Identify your details

    Check whether you have one set of server parameters or a complete subscription URL. Do not mistake an account portal login address for a subscription URL.

  2. Open the add screen

    Go to Home → tap “+” in the upper-right corner to open Add Server. When adding an entry manually, choose the Type that matches the provider’s protocol.

  3. Enter the subscription URL

    For a subscription, set Type to Subscribe, paste the complete URL, and save. The example URL https://example.com/sub?token=xxxx is fictitious and cannot be used to connect.

  4. Check the result

    Return to Home and confirm that server entries appear in the subscription group, then select one. Saving the subscription URL without successfully retrieving its contents does not complete the import.

4. How do I enter the protocol, port, and password manually?

Type must match the server protocol. Shadowsocks, VMess, VLESS, Trojan, Hysteria2, and WireGuard use different field structures; switching Type at random will not fix a connection. Prefer complete import details from a provider you already use. If you must enter the details manually, check each field rather than guessing from its name.

Watch for spaces or line breaks added when pasting. Even if the address is spelled correctly, an incorrect port, transport, or TLS parameter can still cause a timeout. A latency test result also does not prove that all protocol parameters are correct.

5. How should I choose among the four Global Routing modes?

Choose Config to route requests according to rules, and first confirm that Config has the correct active configuration. Proxy and Direct can be used for brief comparisons during troubleshooting, but do not prove that a rule file is correct. Scene involves scene settings and does not need to be configured before your first connection.

ModeMeaningUseful for
ProxyUses the proxy as the primary routing method.Briefly checking whether the selected server can handle a target request.
DirectUses a direct connection as the primary routing method.Comparing with your regular network; it does not test whether the proxy service is working.
ConfigApplies the request policy defined by the active configuration rules.Normal rule-based routing and checking which rule matches a request.
SceneUses preconfigured scene-selection logic.Use when you already have a specific scene configuration; it is not an automatic repair mode.

For example, if a site works with the same server in Proxy but fails in Config, check the rules, policy references, and DNS next instead of immediately deleting the server. When testing is complete, restore your intended mode so temporary comparison settings are not left in place.

6. How do I read Config rules, and what does FINAL mean?

In Config mode, requests are matched against the active configuration, and the first matching rule usually determines the policy. DOMAIN-SUFFIX checks a domain suffix, IP-CIDR checks an IP range, and GEOIP uses an IP geolocation database. FINAL is the fallback when none of the preceding rules match. GEOIP does not determine a country from a website’s text language or domain suffix.

Domain rule and fallback

Section
[Rule]
Domain rule
DOMAIN-SUFFIX,example.com,PROXY
Fallback rule
FINAL,DIRECT

This example routes example.com and its subdomains through PROXY, and sends all other requests through DIRECT as the final fallback.

IP matching examples

Section
[Rule]
IP range rule
IP-CIDR,192.168.0.0/16,DIRECT
Geolocation rule
GEOIP,CN,DIRECT

These are standalone syntax examples. When adding rules to an actual configuration, place them before FINAL and consider the existing rule order.

Do not replace an entire existing configuration with a few example lines. Save the original file before editing. After making changes, confirm that the intended Config is still selected and send the request again. If the log shows that the request already matched an earlier rule, a new rule placed later will not take effect.

7. Should I allow the system prompt the first time I turn on the connection?

The first time a connection is established on iPhone / iPad, the system asks to add a VPN configuration. After confirming that you initiated the action in Shadowrocket, allow it as prompted and complete any device verification. The system VPN status indicates the tunnel connection state; it does not confirm that a particular website is reachable.

  1. In Home, select an imported server and check Global Routing. If you choose Config, confirm the active rule file first.
  2. Turn on the connection toggle, read the system prompt, and allow the VPN configuration required for this connection.
  3. Wait for the app to show a connection state, then visit a page you know and can test again.
  4. If the page fails, note the time, target domain, current network, and mode, then follow the layered checks in the next section.

If another VPN connection is active on the device or network policies are managed by an organization, first check which configuration the system is using. Do not repeatedly delete all system network settings; that can broaden the impact and remove useful troubleshooting clues.

8. The toggle will not stay on, or pages will not load while connected. What should I check first?

First distinguish among three symptoms: the toggle turns off immediately, it stays on but requests time out, or only certain domains fail. Each points to a different layer. Keep the server and test target fixed while troubleshooting, change one variable at a time, and do not treat a “lower latency number” as proof of successful access.

“It turns itself off as soon as I turn it on. What should I do?”

First check whether the system VPN configuration was added successfully, whether another VPN is handling the connection, and whether a valid entry is selected in Home. Note the error text shown by the app. If it indicates an incorrect parameter, return to that server’s edit screen and check each field.

“It says connected, but every page times out. What now?”

Turn off the connection and confirm that your regular network works. Reconnect and check Address, Port, credentials, and TLS parameters. Briefly compare Proxy with Config, or switch between Wi-Fi and cellular to see whether the result changes. Restore your original settings after testing.

“Only one website will not load. Is the server broken?”

Not necessarily. Note the target domain and check the actual policy and error in the request records or log. If Proxy works but Config fails, first check the rule matching the domain, the related policy, and the DNS resolution result.

“The latency test has a result, so why does the browser still fail?”

The test request and browser request may use different targets, protocols, or routes. Try the same target again and check its corresponding record. One test response does not prove that all websites, UDP traffic, or DNS are working.

9. How do I update a subscription, and should I delete and re-import it if an update fails?

Usually, try updating first; you do not need to delete it right away. Updating a subscription retrieves the server list again and does not necessarily update the Config rule file. The update action for a subscription group in Home and the update action for a file in Config apply to different items, so check which one you are updating.

Do not paste a complete subscription URL into a public chat or screenshot to test it. If you need help from your provider, share the error text, time, and network type while keeping the credential section hidden.

10. Should I enable On Demand, and how can I avoid repeated automatic connections?

On Demand triggers connections according to configured conditions. It is not a speed boost and will not fix incorrect server parameters. First confirm that a manual connection works, then configure conditions in Settings → On Demand. Available conditions may vary by system and interface; follow the options shown in your app.

  1. Test a manual connection first: Turn off automatic triggers, use a fixed server and Config to complete a test, and keep the settings that work.
  2. Add conditions next: Go to Settings → On Demand and check the conditions for Wi-Fi, cellular, or a specific network. If you specify a Wi-Fi network, verify its name carefully.
  3. Test changes between networks: Check the connection state both when joining and when leaving the specified network, not just while staying on the same network.
  4. Handle automatic reconnections: If the connection comes back after you disconnect manually, check the On Demand rules and the on-demand connection state in the system VPN before deciding that something is malfunctioning.
Download Shadowrocket