Official Manual · Feature Index

Shadowrocket Features and Settings

Check your connection status and Global Routing in Home first. Then decide whether to review servers, adjust rules, or change Settings. The instructions below use the iPhone / iPad interface to show where each feature is, how to use it, and how to verify it.

Home
Check connection status, routing mode, and server.
Config
Confirm the active configuration and review its rules and policies.
Data
Compare traffic counters and confirm what they cover.
Settings
Adjust connection triggers, tests, and diagnostics.
01 · Connection Routing

The Three Global Routing Modes

Choose how to handle traffic, then check your server and configuration.

In Home, tap Global Routing to choose a configuration, proxy, or direct connection: Config, Proxy, or Direct in the interface. This setting determines how the client handles intercepted connections. It is separate from the main connection switch; selecting Direct does not disconnect the system VPN.

Interface optionHow connections are handledWhen to use it
Config Routes connections according to the active configuration's rules and policies. Use this for everyday routing when different destinations need different handling. First confirm that the expected configuration is active.
Proxy Routes intercepted connections through the selected proxy instead of choosing a route rule by rule from the configuration. Use it to briefly test the proxy path to the same destination when a request fails in rule-based mode.
Direct Routes intercepted connections without using a proxy server. Use it to check whether a destination is reachable directly on the same network, or to temporarily bypass the proxy path.

When troubleshooting, note the original mode and keep the server, network, and test destination unchanged. Switch modes, then make one new request. If Proxy works but Config does not, check the rule order and policy selection in Config first. If both modes fail, review the server settings and current network. This comparison helps narrow down the cause; a single success or failure is not conclusive. Restore your usual mode when testing is complete.

02 · Matching and Actions

Rules and Routing Policies

Check rule order and where each policy ultimately routes traffic.

Rules combine what to match with what to do when there is a match. In Config, find the active configuration, save a copy, then open its rule editor. Read the rules from top to bottom: put specific exceptions before broader rules. Connections that match no earlier rule fall through to FINAL at the end.

Rule Types: Identify What Is Matched

  • DOMAIN matches an exact domain. DOMAIN-SUFFIX matches a domain suffix, including the main domain and its subdomains. DOMAIN-KEYWORD matches a keyword in the domain; overly broad keywords may affect unrelated domains.
  • IP-CIDR and IP-CIDR6 match IPv4 and IPv6 ranges, respectively. GEOIP matches based on IP address location data; it cannot determine a page's language, an account's region, or where a website operator is based.
  • USER-AGENT relies on request fields available to the client; it does not match by app name. If the field is unavailable, do not rely on it as a consistent basis for routing.

Policy Actions: Check the Rule's Right-Hand Side

DIRECT means connect directly, PROXY means use a proxy, and REJECT means reject the connection. If the rule points to a policy group, also check which option that group currently selects. Changing the server in Home does not necessarily change the route used by a rule that specifies a particular policy group.

[Rule]
DOMAIN,blocked.example.com,REJECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
03 · Connection Details

Managing Subscriptions and Servers

Check the list source, current selection, and connectivity separately.

Add a Single Server

A server entry stores the parameters needed to establish a connection. If you already have server details, go to Add Server from Home, choose the matching protocol, then enter the address, port, and required authentication details. The fields for Shadowsocks, VLESS, and Trojan differ; do not assume that settings for one protocol apply to another. After saving, return to the server list, select the new entry, and test the connection. Seeing an entry in the list only confirms that its details were saved.

Import and Update an Existing Subscription

A subscription is a group of server entries maintained through an existing subscription URL. From Home, open the add menu, select Subscribe, and enter the complete URL you already have. After importing, confirm that the group appears, then select the server you want to use. For routine updates, update the existing subscription group instead of importing the same URL again. If the previous selection disappears after an update, check whether the entry was removed or renamed, and whether a related policy group needs a new selection.

Subscription Updates vs. Server Tests

A subscription update checks whether the server list can be retrieved. Connectivity Test checks connectivity using the selected test method. These are different checks: a successful list update does not mean every server can accept connections. If one entry fails, first review its protocol and settings. If several entries in the same group fail, retest a known-working entry on the same network, then check whether the update changed the entries. Subscription URLs and QR codes may contain account credentials; do not post them in public feedback or screenshots.

04 · Automatic Connection

On Demand Connections

Connection triggers and routing rules are separate settings.

On Demand controls when the client establishes a connection based on conditions. Global Routing determines how traffic is handled after the connection is established. Before configuring automatic connections, verify the server and routing mode manually from Home. Then open On Demand in Settings and set the network triggers available on the screen. Add only the conditions you need so you can identify what triggered a connection.

After saving, switch between networks on the test device, make a new request, then return to Home to check the connection status. If the client reconnects automatically after you disconnect it manually, temporarily disable On Demand and test again. If it stays disconnected, review the conditions one by one rather than deleting the configuration or server. If the issue occurs only on a particular Wi-Fi network, check whether it meets the trigger conditions and whether you need to sign in to that network first.

05 · Counters and Scope

Data Usage

Compare readings before and after an action; counters do not show routing history.

Data shows the traffic recorded by Shadowrocket. Open the screen and identify the scope of the displayed counters and the sent and received directions before comparing readings. To observe one action, note the counters before making a repeatable request, then check them again. Keep the network and routing mode consistent where possible; background refreshes or downloads may also increase the counters.

If the readings barely change, first confirm that the VPN is connected, the request was actually sent again, and both readings use the same scope. A browser may load a cached page without making a new network request. If the interface offers an option to clear counters, note the original values first if you need to compare them. Data is not a system-wide traffic statement and cannot, by itself, prove which rule matched a domain. To determine the route, consider the current mode, rules, and any visible connection records together.

06 · Common Options

Common Settings

Change one setting at a time and record the test conditions before and after.

DNS: Check Domain Resolution

DNS resolves domain names to addresses; it is separate from the routing decision made by Global Routing. Check DNS in Settings. If the active configuration also defines DNS settings, review them in Config. Note the original value before changing anything, change one setting, then test the same domain again on the same network. Internal domains on workplace or home networks may depend on the network's DNS service. Switching to another resolver may let public domains load while leaving internal domains unresolved.

Test Method: Choose a Connectivity Test Method

Test Method determines how Connectivity Test runs. In Settings, choose a method suited to your troubleshooting goal, then return to Home and test the same server. If the method needs to reach a test address, the result also depends on whether that address is reachable. Different methods measure different stages, so do not rank their results as if they were equivalent. A successful test does not mean every destination is reachable. For a before-and-after comparison, keep the method, test destination, and network connection the same.

Today Widget: System Shortcuts

Today Widget provides shortcuts to client actions from the system's widget area. First check the Today Widget options in Settings. If supported by the system, add or review the widget in the system's widget editor. Availability and displayed controls depend on system support. After using a shortcut, return to Home to confirm the actual VPN status; the widget display alone does not confirm that a connection was established.

iCloud: Check What Syncs

iCloud syncs supported app data between eligible Apple devices. Confirm that both devices use the same iCloud account and that the app is allowed to use iCloud in system settings, then review the related options in Settings. Before syncing, keep a copy of any configuration needed on the destination device. After syncing, check the server list, active configuration, and routing mode on each device; do not assume every local setting is copied exactly. Follow the prompts on the destination device to authorize the system VPN.

Diagnostics: Capture a Reproducible Issue

Diagnostics gathers information for troubleshooting. Find Diagnostics in Settings, note the current network, Global Routing selection, and affected action, then reproduce the issue once and review the available diagnostic results. Record “connection won't start,” “connected but requests fail,” and “only specific destinations fail” as separate cases. Before sharing diagnostic information, remove subscription URLs, authentication details, and domains you should not disclose. Keep the steps needed to reproduce the issue and error messages that contain no credentials.