Shadowrocket Official Manual · Settings Reference

Shadowrocket Features and Common Settings

Start with Global Routing, then check your configuration, servers, and test results. Examples on this page use the iPhone / iPad interface; menus and options may differ on other platforms.

Global Routing: Config, Proxy, and Direct

Open Global Routing from Home to choose a mode. This setting determines how connections are routed. Selecting a server under SERVER does not automatically switch Global Routing to Proxy. Before testing, note the current mode and selected server, then compare results using the same destination.

ModeHow It RoutesWhen to Use It
ConfigMatches connections against the active configuration's rules and applies the policy for the matched rule.For everyday rule-based routing or to check whether a specific rule is taking effect.
ProxyRoutes connections through the proxy without selecting policies rule by rule from Config.To check whether the selected server can reach the same destination and determine whether a problem is related to rules in the configuration.
DirectConnects without routing traffic through the selected proxy server.To establish a direct-connection baseline on the current network and distinguish network issues from proxy-path issues.

Direct does not turn off the connection switch on Home. To compare behavior before and after Shadowrocket handles connections, run a separate test with the connection turned off. After changing modes, send a new request so an existing connection or cached page does not skew the result. If Proxy works but Config does not, check which configuration is active and the rule order before changing servers.

Config: Rule Types, Policies, and Order

Each rule pairs a matching condition with an action. In Config, find the active configuration and keep a copy of the original before adding or editing rules. DOMAIN matches a specific domain. DOMAIN-SUFFIX matches a domain suffix, making it useful for applying the same policy to a parent domain and its subdomains. DOMAIN-KEYWORD matches a keyword in the domain; it has a wider scope and may also match unrelated domains, so avoid it when targeting one specific domain.

IP-CIDR and IP-CIDR6 match IPv4 and IPv6 address ranges, respectively. GEOIP matches based on the geographic location of the destination IP, not the visitor's location. DNS results can change over time or across networks, so do not treat an address from a single test as permanent when evaluating address-based rules.

PROXY routes a connection through a proxy, DIRECT connects directly, and REJECT blocks the connection. This example only illustrates rule syntax: route a specific domain through PROXY, then send unmatched destinations to FINAL,DIRECT. It is not a complete configuration file and contains no server details.

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

Subscribe and SERVER: Add, Select, and Update

If you have a subscription URL, open Add Server from the add option on Home, choose Subscribe as the type, and enter the URL. If you have details for a single server, choose the protocol specified in those details in Add Server—for example, Shadowsocks, VLESS, or Trojan—and enter the address, port, and required protocol fields as provided. For QR-code details, use Scan QR Code, then verify the detected type and destination before saving. Treat subscription URLs and server credentials like passwords; do not include them in public screenshots or troubleshooting notes.

After saving, check that the entry appears in the SERVER list on Home. Select the server you want to test, then run Connectivity Test. A subscription update may rename or remove entries or change their parameters, so do not assume an entry with an old name is still the same server. If an update fails, first check that the pasted URL is complete and reachable on your current network, then confirm the original details are still valid. If the update succeeds but only one test fails, troubleshoot that server on its own instead of deleting and reimporting the entire subscription.

The app and the connection details it uses are provided separately. A one-time app purchase does not include a network service plan. This site does not provide, sell, or recommend servers or subscriptions. If you don't already have connection details, read the setup guide for an overview of the fields and steps.

On Demand: Trigger Connections Automatically

On Demand lets the system start a VPN connection when specified conditions are met. It controls when to connect; Global Routing determines how traffic is handled after the connection starts. First, connect manually from Home and confirm that it works. Then open On Demand in Settings and configure the conditions available in the interface. For the first test, add just one condition—for example, switching to a specified network type—and check the connection status when you return to Home. Then test what happens when you leave that network or switch back.

If the connection starts again after you disconnect manually, check whether the current network still meets an On Demand condition. To confirm whether automatic triggering is the cause, temporarily turn off On Demand and repeat the same steps; re-enable it as needed when you're done. If a manual connection fails, troubleshoot VPN configuration permissions, the network, and the server first. Avoid changing automatic connection conditions and routing rules at the same time.

Data: Check Traffic Usage

Check upload and download records in Data. If the interface offers views by server or by app, confirm the current view and reporting scope before interpreting the figures. The server view groups traffic recorded for each server; the app view groups records attributed to apps in that view. Since the two views group data differently, a figure for one entry in one view cannot be directly matched to a row in the other. App traffic figures are also not the same as usage totals billed by your carrier or service provider.

To troubleshoot a particular request, note the readings first, send the request again, and compare the difference instead of relying on the cumulative total. Background sync, retries, and cached resources can all affect the result. Before clearing data, save any readings you need for comparison and check what the action will clear. Clearing traffic data does not change Global Routing or the selected server, and it does not reset usage measured by your service provider.

Settings: DNS, Tests, Sync, and Diagnostics

DNS

DNS resolves domain names to addresses. Check the DNS options in Settings, then look in Config for any per-configuration DNS settings. If the system's default DNS works, you can leave it unchanged. To compare a custom DNS server or DNS over HTTPS, change one setting at a time, note the original value, and request the same domain again. A site failing to load does not necessarily indicate a DNS problem: resolving a domain does not guarantee a connection can be established, so also check routing policies and the proxy path.

Test Method

Test Method determines how Connectivity Test runs. Check the method in Settings, then return to Home to run the test. When comparing two servers, keep the method, destination, and network the same where possible; results are not directly comparable if the method or destination changes. A successful test only means that the probe received a response at that time. It does not confirm that other sites, protocols, or long-running transfers will work. To check a specific site, try accessing it directly.

Today Widget

Today Widget contains settings for the system widget. Check the available options in Settings, then see whether your device provides the corresponding widget in its system widget view. If you can add it, compare the widget's status and available actions with Home. If the status appears out of date, open Shadowrocket to check the actual connection instead of relying on the widget alone.

iCloud Sync

Check the iCloud sync option in Settings, make sure the system allows Shadowrocket to use iCloud, and confirm both devices use the same iCloud account. Save a local copy of important configurations before enabling sync. Afterward, check the other device for the expected entries, selected server, and active configuration. Syncing data and granting system VPN permissions are separate: even after a configuration appears on another device, confirm connection permissions and test the connection on that device separately.

Diagnostics

Diagnostics collects information to help troubleshoot current issues. Before opening Diagnostics in Settings, note the network, Global Routing mode, and whether the issue can be reproduced. Then run another test and compare its results with the symptoms. Before sharing diagnostic data, remove subscription URLs, server credentials, and any access records you should not disclose. For next steps based on the symptoms, see the troubleshooting guide.