Shadowrocket Official Manual

Shadowrocket Settings

Use Global Routing to decide how traffic is handled, then adjust rules, servers and On Demand as needed. The steps below use the iPhone / iPad interface; on other platforms, follow the options and fields shown in your version.

Global Routing: Three Ways to Handle Traffic

Choose a mode under Home → Global Routing, then return to Home to check the selected mode and connection toggle. These settings do different things: the connection toggle determines whether the client handles traffic, while Global Routing determines how it handles that traffic. To confirm a change has taken effect, make a new request rather than relying on a page that was already open.

How Config, Proxy and Direct work, when to use them, and what to check
Mode How it handles traffic When to use it What to check afterward
Config Applies the policies defined by the rules in the active Config. When some destinations should connect directly while others use a proxy. Check the active Config, the first matching rule and FINAL.
Proxy Routes handled traffic through the proxy without applying Config rules individually. To briefly check whether the selected server can establish a proxy connection to a specific destination. Check the server on Home first. When testing is done, switch back to the previous mode.
Direct Sends handled traffic directly over the current network, without using a proxy. To determine whether a problem is with the proxy route or the current network. Direct does not turn off the connection. To test without the client handling traffic, turn off the connection toggle separately.

To troubleshoot a single destination, keep the network and destination unchanged and switch only one mode at a time. If Proxy works but Config does not, check which rule matches and which server its policy selects. Avoid changing DNS and the server at the same time.

Rule-Based Routing: Match Conditions, Order & Policies

Each rule pairs a match condition with a policy to apply when it matches. In Config, check which configuration is active, then open its rule editor. Note the existing rules and their order before making changes; save them, then return to Home and confirm Global Routing is set to Config. Testing one specific rule makes the outcome easier to verify than importing several rule sets at once.

Domains and Request Attributes

DOMAIN matches an exact domain; DOMAIN-SUFFIX matches a domain and its subdomains; DOMAIN-KEYWORD matches domains containing a specified string, and may also match unrelated sites with similar names. USER-AGENT matches an identifiable request field and should not be treated as a general app-identification rule.

IP Addresses and Geographic Matching

IP-CIDR and IP-CIDR6 match IPv4 and IPv6 ranges, respectively. GEOIP matches the geographic classification of the destination IP; it does not indicate where a website operator is located. Domain lookup results can vary by network, so IP-based matches may vary as well.

Policies Applied to Matching Traffic

PROXY routes traffic through a proxy, DIRECT connects directly, and REJECT blocks the request. A rule can also point to a policy group defined in the Config. If traffic matches a proxy rule but still cannot connect, first check which server the policy selects and whether that server is reachable.

Rules are evaluated in order, and typically the first matching rule applies. In the example below, the first rule sends status.example.com direct, the second sends other destinations under the same domain through a proxy, and FINAL handles traffic that matches neither earlier rule. If you swap the first two rules, the broader suffix rule matches the specific subdomain first, so the direct exception no longer applies.

DOMAIN,status.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

This example illustrates match order; it is not a complete configuration. After saving, test both a destination that should match the exception and one that should use the proxy. If a page also requests other domains, check those requests separately from the main page. A single page load cannot confirm how every rule behaves.

Subscriptions & Servers: Import, Update and Test

Subscriptions and manual setup are for different kinds of input. If you already have a subscription URL, open Add Server on Home, set the type to Subscribe, enter the original URL and save. Then check that the expected entries appear in the list. If you have the details for a single server, choose the matching protocol type in Add Server and enter its address, port and required fields. When using Scan QR Code, check the detected type and address after scanning.

Updating a subscription refreshes the entries associated with it. Find the subscription on Home and use its update action. Afterward, check whether the server you selected is still in the list. Importing the same URL more than once can make entries hard to distinguish. If an update fails, first check that the URL is complete and that the current network can reach it, then decide whether any changes are needed. The server list and Config are separate: updating the former does not change the active rule configuration.

A successful import does not guarantee that a server is reachable. On Home, run Connectivity Test for the selected server and note the test method and result. Then verify the connection with a known destination. If the test fails, check the protocol type and port first, then verify the authentication fields required by that protocol. Before sharing screenshots or logs, hide subscription URLs, credentials and private server addresses. See the technical reference for protocol fields and the setup tutorial for the initial connection steps.

On Demand: Connect Automatically Under Specific Conditions

On Demand determines when the system starts a connection; Global Routing determines how traffic is handled once connected. First verify the server and routing mode manually, then configure On Demand under Settings → On Demand. Start with just one condition, such as triggering on a network type you use. After saving, switch to that network, make a new request to the same destination and check the connection status on Home.

If the connection comes back after you disconnect manually, check whether the current network still meets the trigger condition. To troubleshoot an unexpected reconnection, temporarily turn off On Demand, then connect and disconnect manually. This helps distinguish a condition-triggered reconnection from an unstable connection. Add other conditions only after confirming how the first one behaves.

Data: Track Traffic Changes

View traffic recorded by the client under Data. Before reading the figures, check the displayed reporting scope and time span, then compare sent and received traffic. To compare two modes, use the same network, note the figures before and after, and perform the same action in each mode. Do not compare cumulative totals from different reporting periods.

Data figures are not the same as the system's cellular data usage or a service provider's billing records. Background sync, caching and automatic retries can all affect readings during a test. If the page offers a reset option, note any figures you need to keep before resetting so you can continue comparing them.

Settings: Common Options & Diagnostics

Change one setting at a time, record its original value and test against the same destination. If the issue started after switching networks, note the connection status before and after the switch before changing related settings.

DNS

DNS resolves domain names to IP addresses. Check DNS-related options in Settings; if the active Config also defines DNS settings, check those too. Make changes only when you know which DNS setting you need, then retest the domain that previously failed. Local network domains may rely on the current network's DNS service and may stop resolving if you switch to another one.

Test Method

Choose a probe method under Test Method in Settings, then run Connectivity Test from Home. When comparing servers, keep the probe method, network and test destination the same. Different methods may check different parts of the connection, and the reported time is not download speed. A successful test still needs to be verified with the actual destination.

Today Widget

Check the Today Widget options in Settings. If your device supports it, add the widget from the system's widget editor. Widgets are useful for checking status at a glance or using the controls they provide. If the widget does not show what you expect, rely on the connection status and Global Routing mode shown on Home.

iCloud Sync

First confirm that the device is signed in to the expected Apple Account and that the system allows the app to use iCloud. Then check the iCloud options and sync scope in Settings. When enabling sync for the first time, avoid editing the same configuration on both devices at once. After syncing, check the selected Config and servers on each device. Sync is not a full backup and does not confirm that the other device is connected.

Diagnostics

Open Diagnostics in Settings. Note the current network, Global Routing mode and time the issue occurred, then reproduce it once. First determine whether the error occurs during DNS resolution, proxy connection or the destination request, then change only the relevant setting. Before sharing diagnostics, remove information that could reveal subscription URLs, server addresses or personal destinations.

See frequently asked questions about settings and connections

Platforms & Downloads

Get the iPhone / iPad version from the App Store product page. It costs $2.99 as a one-time purchase; check the App Store page for system requirements. Verify the developer is Shadow Launch Technology Limited, and check the official icon and app ID 932747118.

The Mac (Apple silicon and Intel), Windows, Android and Linux versions are free, with installers available from this site at /dl/. For the right version for your device and first-launch instructions, visit Download & Install.

A one-time app purchase is not a service plan. Shadowrocket uses subscription or server details you already have. This site does not provide, sell or recommend nodes or subscriptions.