Shadowrocket Setup Guide

Routing rules: the first matching rule takes effect

In Global Routing, select Config and check the Rule section of the configuration in use. Rules are evaluated from top to bottom, stopping at the first match; more specific domain conditions generally belong before broader ones. PROXY, DIRECT, and REJECT send a request through the selected proxy, connect directly, or reject it. FINAL is the fallback when no earlier rule matches, so place it last. The example below demonstrates syntax; it is not a recommended configuration for any service. After making changes, check the results against actual requests.

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

On Demand: Connect based on network conditions

On Demand lets you set connection behavior that is triggered by specific conditions. Decide which Wi-Fi, cellular, or domain conditions should trigger a connection, then review each setting in the app. These conditions are not a single master switch. Check the connection in the relevant network environment after conditions change. If the connection keeps dropping and reconnecting, review the enabled On Demand triggers first, then check whether manual actions or a network change caused it.

Multiple protocols: Match the details to your existing server

When adding a server, check the protocol in your existing server details, then choose the corresponding Type in Add Server. Host, Port, authentication fields, and other protocol settings must match the original details; changing the protocol name alone cannot convert one set of settings into another protocol. If you import using Scan QR Code, check that all fields were parsed correctly. Protocol support and available fields are shown in the app. If a connection fails, review the information you entered before changing unrelated settings.

Subscription import: Use an existing link as an update source

If you already have a subscription link, select Subscribe on the add screen and enter your own link. After importing, check that the group and its entries appear, then select a server that matches your setup. Updating a subscription rereads the link; it does not verify that the link is still valid or that your network is working. If an update fails, check whether the link is reachable, its contents can be parsed, and your device has a network connection. This site explains how to import and organize subscriptions but does not provide them.

Configuration files: Tell rules apart from server entries

Config contains rules and related settings, while server entries provide the details needed to connect. They are not the same thing. Before editing a configuration, check that it is the one selected in Global Routing; otherwise, changes to Rule may not produce the expected results. A configuration may also include sections such as General and Hosts, so check what each section does before editing it. If you sync a personal configuration through iCloud, make sure the synced file is the one selected on your device to avoid checking the wrong file.

Diagnostics: Narrow down the source of a problem

If a connection is not working, start with the connection status on Home, then use Connectivity Test to check the current test results. A test result is not the same as how a particular website loads. Next, check the selected server, Global Routing, rule matches, and DNS settings. Avoid changing several things at once, so you can identify the cause. For further network troubleshooting, use Diagnostics in Settings. Data shows traffic statistics, which can help you review usage but cannot by itself confirm that a rule matched correctly.