Shadowrocket’s interface terms fall into three groups: Home, Config, Data and Settings are feature areas; Proxy, Direct, Config and Scene are routing choices under Global Routing; and Subscribe and protocol names describe where server details come from and how connections work. This guide uses the iPhone and iPad interface to explain where to find each option, what order to follow, and which common misunderstandings to avoid. It’s for users who already have server details or a subscription and are setting things up for the first time. Layouts may differ on other platforms, so look for the corresponding feature by name.
1. Tell feature areas apart from routing choices
Not every English label on screen is a toggle. Home is where you check servers and connection status; Settings controls app behavior. Proxy and Direct are usually choices for how traffic is handled. Config is the one that often causes confusion: it can mean the area for managing configuration files or a Global Routing choice. The two are related, but they are not the same control.
| Interface term | Context | What it does |
|---|---|---|
| Home | Main feature area | View servers, subscription groups, the current selection and connection status. |
| Config | Feature area or Global Routing choice | The feature area manages configuration files; the routing choice applies the rules in the current configuration. |
| Proxy | Global Routing or policy context | Routes traffic through a proxy path. Check which server or policy is selected separately. |
| Direct | Global Routing or policy context | Connects directly to the destination without using the selected remote proxy server. |
| Data | Traffic data area | View traffic recorded by the app to help confirm whether requests were made. |
| Settings | Settings area | Adjust app behavior such as On Demand; this is not where you edit server details. |
This guide preserves the interface labels and capitalization. Proxy and Direct on screen correspond to PROXY and DIRECT in configuration syntax, but configuration files must follow their own syntax. Don’t paste the explanatory text into rule fields. The counts below cover only the concepts discussed here, not every feature in the app.
2. Home: Check your details before connecting
A server entry in Home only means the app has saved the details; it does not guarantee that the remote server is available. Selecting an entry, enabling the connection and visiting a website are three separate actions. For an initial check, use one server and one test destination. Changing several variables at once makes it hard to tell what affected the result.
-
Check your saved details
Open Home and check whether your server or subscription group is listed. A subscription URL is an access credential: don’t share the full link in public feedback, and don’t enter it as a server address.
-
Add an existing subscription
To add one, go to Home → tap “+” in the top-right corner → Type → Subscribe. Enter your own subscription URL under URL, then save. This guide covers importing details you already have; this site does not provide, sell or recommend servers or subscriptions.
-
Update and select a server
Return to Home, update the subscription, confirm that server entries appear in the group, and select one. Saving a subscription and refreshing the server list are separate steps; check that each succeeds.
-
Connect and test
Check the current selection under Home → Global Routing, then enable the connection. When prompted, allow the app to add a VPN configuration. Open a specific test page and assess the result using both the connection status and changes in Data.
Subscribe is for retrieving or refreshing server details in bulk; it is not a transport protocol. Shadowsocks, VMess, VLESS, Trojan, Hysteria2 and WireGuard are protocol names. When entering server details manually, make sure Type matches the details you have. A protocol name in a server’s display name does not confirm its actual Type.
3. Global Routing: Proxy, Direct, Config and Scene explained
Global Routing determines how traffic handled by Shadowrocket is routed; it is not a “server speed setting.” For everyday use with an existing ruleset, check Config first. To troubleshoot a rule, compare it temporarily with Proxy while keeping the same server, network and destination. Restore the original choice afterward so a temporary test setting isn’t left in place.
Config
RecommendedMatches traffic against the rules in the active configuration, then applies the policy specified by the matching rule. It does not mean that certain websites always use a proxy: the result depends on rule order, policy definitions and the final fallback rule.
Best for: Everyday routing by destination after you’ve checked the configuration.
Proxy
Routes traffic from apps through a proxy without deciding each destination according to the rules in Config. It cannot guarantee access to every destination or fix an unavailable remote server or incorrect authentication details.
Best for: Temporarily checking whether a routing rule is causing an access problem.
Direct
Connects directly to the destination without using the selected remote proxy server. Direct does not turn off the app’s connection toggle. Check the system separately to see whether VPN status is still displayed.
Best for: Comparing direct access on the current network with the proxy route.
Scene
Organizes routing choices by scene. Check the settings for the active scene before using it. The label Scene alone doesn’t tell you whether requests will use Proxy or Direct, and it is not another server protocol.
Best for: Applying different routing arrangements by scene after setting them up and checking their behavior.
For example, if the same destination opens with Proxy but fails with Config, investigate the matching rule and its policy. That isn’t conclusive: DNS, changes to the destination address and policy selection can also affect the result. If both choices fail, check the server details and current network before adding more rules.
4. Config: Configuration files and rule keywords
The Config area manages configuration files; Global Routing → Config means routing traffic using the current configuration. After downloading or importing a file, check that it is selected as the active configuration. Keep a copy of the original before making changes. Replacing a block of rules without understanding the policy names can leave rules referring to policies that don’t exist.
Rules are usually checked in order, and the first matching rule determines the policy for a request. DOMAIN-SUFFIX checks a domain suffix; IP-CIDR checks whether the destination IP falls within a specified network range; GEOIP matches the destination IP against a geolocation database; and FINAL handles requests that didn’t match earlier rules. GEOIP does not determine a match from a webpage’s language, domain suffix or the user’s location.
Rule syntax example
- DOMAIN-SUFFIX
DOMAIN-SUFFIX,example.com,PROXY- IP-CIDR
IP-CIDR,192.168.0.0/16,DIRECT- GEOIP
GEOIP,CN,DIRECT- FINAL
FINAL,PROXY
This illustrates field order only, not a complete configuration. Adapt it to the policies and destinations you actually use.
How to read a rule
- First field
- The rule type, such as DOMAIN-SUFFIX.
- Match condition
- A domain, network range or region code. FINAL does not need this field.
- Policy field
- For example, DIRECT, PROXY or a policy name defined in the configuration.
- Rule order
- Rules are checked from top to bottom; put FINAL at the end as a fallback.
Check the match condition first, then the action. Seeing PROXY on one line does not mean all requests will use a proxy.
In the domain example above, example.com and its subdomains can match the suffix condition. notexample.com is not a subdomain just because its ending looks similar. In the network example, 192.168.0.0/16 represents an address range, not a website name. Domain and IP rules inspect different kinds of information, so confirm what information is available for the request before changing rule order.
- Make sure Global Routing is set to Config before checking configuration rules. If it’s set to Proxy, changing a domain-routing rule won’t help verify whether that rule matches.
- Put specific rules before broader ones so that a broad rule doesn’t match first.
- Keep a recoverable copy of the original configuration, change one thing at a time, and test the same destination again.
5. Data: What traffic numbers can tell you
Data shows traffic recorded by the app. An increase means data was transferred within the scope of that statistic, but it doesn’t prove that a webpage loaded completely or that all traffic went through the remote proxy server. When comparing readings, note the measurement scope, connection time and Global Routing choice; figures collected under different conditions aren’t directly comparable.
- Choose a specific test: After connecting, open one page and check whether the reading changes. Don’t run large downloads or stream video at the same time.
- Compare uploads and downloads: Sending a request uses upload traffic; receiving the response uses download traffic. A small upload alone doesn’t prove that valid content came back from the remote server.
- Check what’s being measured: App traffic may not match the usage charged by your service provider. Protocol overhead, measurement scope and billing times can all differ.
- Look at the full picture: Consider connection status, the destination’s response, server availability and the route selected by the rules. Don’t base your conclusion on a single number.
If Home shows a connection but the browser stays stuck loading and Data changes only slightly, test one destination at a time. Don’t assume the subscription has expired, or that the configuration is correct just because the reading increased. Data is one indicator; check the service’s validity and account status in the account information for the service you already use.
6. Settings and On Demand: Automatic connection isn’t automatic routing
Settings controls app behavior. For example, Settings → On Demand works with the system’s VPN on-demand feature to trigger connections under configured conditions. Its role differs from Config: On Demand controls when to connect; rules control how requests are handled after they enter the app. Before enabling it, make sure a manual connection works, then set the conditions one at a time.
- Select a server manually in Home, check Global Routing, and test access to a destination.
- Go to Settings → On Demand and check the existing settings and applicable network conditions. Don’t copy Wi-Fi network names from another device.
- After enabling it, switch to a relevant network and check whether the connection behaves as expected. Also check the on-demand connection status in the system’s VPN settings.
- If the connection comes back on after you turn it off, first check the conditions under Settings → On Demand instead of repeatedly deleting server entries.
Global behavior in Settings, server selection in Home and rules in Config each have a different scope. When troubleshooting, say which area you used, what you changed and what happened. That’s more useful than simply saying “settings aren’t working.” Option locations may differ across platforms or layouts; follow what the app currently shows.
7. Common misunderstandings: Start with the relevant screen
Why can’t I open a website even though Home lists a server?
First check that a server is selected and the connection is on, then check the choice under Home → Global Routing. A listed server only means its details are saved. You still need to check remote server availability, authentication details and whether the destination itself is accessible.
Does choosing Config automatically download rules?
No. Open Config to view the active file and its rules. Choosing Global Routing → Config applies the configuration; it doesn’t download one. Check which file is active, then test a specific destination.
Why does the system still show VPN when Direct is selected?
Direct routes requests directly; it doesn’t turn off the connection. To disconnect, use the connection toggle in Home. If it reconnects automatically, check Settings → On Demand and the system’s VPN on-demand settings.
Why didn’t Config change after I updated Subscribe?
First check what you updated. A subscription in Home typically refreshes server details, while Config manages configuration files; they are separate. Check the server list and active configuration independently. An update timestamp for a subscription doesn’t tell you whether the rules changed.
After the initial setup, review in this order: check the server in Home → check the routing choice in Global Routing → check the rules in Config → observe the result in Data → check automatic behavior in Settings. When reporting an issue, include the relevant option names and what you observed. Hide sensitive details such as subscription URLs, passwords and keys.
Get Shadowrocket and keep reading
Get Shadowrocket for iPhone / iPad on the App Store for a one-time $2.99 purchase. The developer is Shadow Launch Technology Limited, and the app ID is 932747118. Check the App Store listing for system requirements. Versions for Mac (Apple Silicon / Intel), Windows, Android and Linux are free. See the download page for options on each platform, then follow the guides for setup.