Official Guide / Routing & Settings
Shadowrocket Proxy Modes and Settings
Choose Config to route requests based on their destination. Use Proxy or Direct to temporarily test a server or compare it with your current network.
The steps below use the iPhone / iPad interface. Global Routing determines how requests are handled; On Demand determines when a connection is established. Check these settings separately.
01Modes
Global Routing: Config, Proxy, and Direct
Open Global Routing from Home, choose a mode for the test you want to run, then return to Home to check the connection status. Before choosing Config, go to Config and confirm which configuration file is in use. Before choosing Proxy, check which server is selected on Home. Switching modes does not change the configuration file or correct server settings.
| Interface option | How it works | When to use it | Check first |
|---|---|---|---|
| Config | Uses rules in the current configuration file to determine how requests are handled. | Everyday use when some requests should go through a proxy and others should connect directly. | That the configuration is active, and the rule order and fallback policy. |
| Proxy | Routes requests handled by the client through the proxy. | Temporarily check whether a destination is reachable through the proxy. | Which server is selected and whether its settings are correct. |
| Direct | Sends requests without routing them through a proxy server. | Check basic network access or temporarily test a local service. | Whether the system network is working; Direct does not turn off the connection switch. |
When troubleshooting, keep the network and test destination the same. Send a new request after each mode change. If Proxy works but Config does not, check for an unexpected rule match or a different policy or server in Config. If Direct also fails, first check whether the network requires you to sign in through a captive portal, then verify that the destination is reachable. When you finish testing, switch back to your everyday mode so a temporary troubleshooting setting is not left in place.
02Rules
Rule-Based Routing: Match Conditions, Then Apply a Policy
Rules pair request characteristics with a handling policy. In Config, open the active configuration file and check the rules and their order. Then return to Home and set Global Routing to Config. A broad rule near the top may match a request before a more specific exception can take effect. To add an exception, find the rule that would override it and place the exception above that rule.
Choose a Rule Type Based on Request Characteristics
DOMAIN/DOMAIN-SUFFIX/DOMAIN-KEYWORD- Match by full domain, domain suffix, or a keyword in the domain. Use DOMAIN for a single host; use DOMAIN-SUFFIX to cover a base domain and its subdomains. Keywords may match unrelated domains, so check the match scope after making changes.
IP-CIDR/IP-CIDR6/GEOIP- The first two match IPv4 and IPv6 address ranges; GEOIP matches based on the geographic information associated with the destination IP. If a domain resolves to multiple addresses, the match may vary depending on the address actually used. GEOIP identifies the IP’s registered location, not a domain suffix or the website operator’s location.
USER-AGENT/FINAL- USER-AGENT applies only when the client can access the corresponding request field; it is not a universal way to identify apps. FINAL sets a fallback policy for requests that have not matched any earlier rule and should be placed at the end of the rule list.
Test PROXY, DIRECT, and REJECT Individually
PROXY routes requests through a proxy, DIRECT connects directly, and REJECT blocks matching requests. For example:
DOMAIN,local.example.com,DIRECT
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT
The first rule keeps one host on a direct connection, the second handles other requests matching the suffix, and the third handles requests that match no earlier rule. These domains are examples; copying them will not create rules for your actual services. To test, send a new request to one exception destination and one destination that should match the suffix, then check the available connection logs. If the first destination unexpectedly uses a proxy, check that the domain matches exactly, then verify the rule order and active configuration.
03Servers
Import Subscriptions and Manage Servers
If you already have a subscription URL from your provider, open Add Server on Home, select Subscribe, and enter the URL. After saving, check the imported entries on Home and select the server you want to test. A successful import means the list was created; it does not guarantee that every server can connect. If an update changes the names or number of entries, confirm your selection again, especially if an entry you used before may have been removed.
If you have settings for a single server, select the protocol that matches your provider’s details in Add Server, then enter the address, port, and authentication fields required by that protocol. If you have a QR code, you can import it with Scan QR Code; check the imported protocol and address before saving. Even when two sets of details use the same address and port, fields for different protocols are not interchangeable. See the protocol reference for field details.
If a subscription fails to load, first make sure you copied the complete URL, then ask the original provider whether it is still valid. If the list loads but a server will not connect, check the selected entry and its protocol fields. Do not treat these as the same issue by repeatedly deleting and reimporting entries. When sharing troubleshooting details, remove access parameters from subscription URLs and redact passwords and keys. This site does not provide, sell, or recommend proxy servers or subscriptions.
04Connections
On Demand: Connect Based on Conditions
On Demand lets the system attempt to connect when configured conditions are met, reducing manual steps when switching networks. First, verify the connection manually from Home. Then open On Demand in Settings and choose the network conditions that should trigger a connection. After setup, switch between Wi-Fi and cellular and check whether the connection starts when expected and stays in the expected state when it should not.
On Demand does not determine how requests are routed. Once connected, traffic is still handled by Global Routing and the applicable configuration rules. If the connection comes back as soon as you switch networks after disconnecting manually, check whether On Demand is still enabled and whether its conditions cover that network. To troubleshoot frequent reconnects, temporarily turn off On Demand and test a manual connection on a fixed network, then restore the conditions you need. This helps distinguish server connection issues from network-triggered connection conditions.
05Usage
Data: Check Traffic Usage and Its Scope
Check the traffic recorded by the client in Data. To see whether an action generated traffic, note the displayed statistics period and the upload and download values. Record the starting values, perform one specific action, then compare them with the new values. For further troubleshooting, keep the device on the same network and limit other activity such as syncing, downloads, or connectivity tests so their traffic does not affect your observation.
Data shows traffic recorded by the client, not the system’s cellular bill or the provider’s final usage totals. The measurement period, included connections, and transmission overhead may differ, so subtracting the cumulative totals from two sources is not a reliable way to identify missing traffic. To check whether a domain uses a proxy, consider the current mode, rules, and diagnostic logs together; total upload or download figures do not show which policy handled a specific request.
06Settings
Settings: DNS, Testing, Sync, and Diagnostics
DNS: Check the Active Resolution Settings
DNS resolves domain names to addresses. Review the DNS options in Settings. When using Config, also check whether the active configuration file specifies DNS settings. If a domain will not resolve, note the current value, change one setting based on your network or provider’s instructions, then test the same domain again. If internal names on your local network stop working, check whether the current DNS resolver can resolve them. A resolved address does not mean the destination port is reachable; test that separately.
Test Method: Keep Test Conditions Consistent
Review and select a test method under Test Method in Settings, then run Connectivity Test from Home. To compare results for the same server, keep the test method, network, and destination consistent. If the interface lets you edit the test URL, use a destination you can access and that is suitable for testing. A successful test only confirms that the probe worked at that moment; it does not mean every real-world request is reachable, and test time is not download speed.
Today Widget: Access from a System Widget
Check the Today Widget options in Settings and see whether the system currently offers a way to add the widget. Once added, use it to view the status or quick actions it provides. To check Global Routing, the selected server, or the configuration file, return to Home or Config. If the widget does not appear, first open the app and confirm the connection is working, then check whether the system offers the widget. There is no need to reset your server settings just because the widget is missing.
iCloud: Check What Gets Synced
To sync between your own devices, check the iCloud options in Settings. Make sure both devices are signed in to the same Apple Account and that the system allows the app to use iCloud. Enable the items you need as described in the interface, then check for them on the other device. Back up important configurations before syncing, and avoid editing the same content on both devices at once. Even if configurations or server details sync successfully, verify the connection and On Demand conditions on each device.
Diagnostics: Gather Evidence for the Issue
Open Diagnostics in Settings. Note when the problem occurred, the network type, and the Global Routing mode, then reproduce the issue once. If the logs show a DNS failure, check DNS first. If the name resolves but the connection times out, check the selected server and destination address. If the connection succeeds but the result is unexpected, check which rules matched and which policies were applied. Change one setting at a time and test again. Redact account details, subscription URLs, and other sensitive information before sharing logs.
Get Shadowrocket for Your Device
The iPhone / iPad version costs $2.99 as a one-time App Store purchase. Check the App Store listing for system requirements. The Mac (Apple silicon and Intel), Windows, Android, and Linux versions are free; installers are available from this site at /dl/.
A one-time app purchase is not a service plan. If you already have the app, see the first connection guide.