Official Manual · App Store Listing
A rule-based proxy client for iPhone / iPad. Make a one-time purchase on the App Store, import your existing configuration, then set up rule-based routing and connection options.
Devices and App Store
Shadowrocket is available only on the App Store. Before purchasing, verify the app identity and device compatibility, then import your existing subscription or server details after installation. Check the App Store listing for system requirements and purchase eligibility.
Check compatibility and payment details in the App Store before purchasing. The first time you connect, iOS will ask to add a VPN configuration; verify that the request comes from Shadowrocket before allowing it. Installing the app does not provide server access—you still need to import your own connection details.
View iPhone setup instructions →Use the Apple ID associated with the purchase to check your purchase history. Check the App Store listing for eligibility for Universal Purchase. A larger screen can make configuration fields easier to review, but purchase history and connection settings are separate; after moving to another device, check that your configuration is complete.
View iPad setup instructions →932747118Search results may include apps with the same or similar names. Open the product page, verify each detail, then confirm the price and device requirements. View the App Store steps →
Keep these three layers distinct: server details determine where the connection goes, Global Routing determines how traffic is routed, and rules in Config determine which policy a request matches. Change one layer at a time to make the results easier to assess.
Check Global Routing on Home. Config mode uses the rules in the active configuration to choose a route; Proxy mode sends eligible traffic through the selected proxy; Direct mode connects directly. For everyday rule-based routing, select Config and check which configuration is active. Temporarily switching modes can help isolate a rule issue, but it will not fix incorrect server settings. After connecting, verify which policy a request actually uses instead of assuming the toggle confirms the routing result.
FINAL,DIRECTFind On Demand in Settings. It connects according to the conditions you configure. First connect manually and confirm that the server and rules work; then enable On Demand and test both your usual network and network changes. If the connection quickly resumes after you disconnect manually, check these conditions before repeatedly removing configurations. On Demand controls when a connection starts, not which policy a website uses. Routing is still determined by Global Routing and the active Config. Assess battery use based on your actual usage.
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECTSet matching conditions for your targets under Rule in Config. Rules are generally checked in order, and the first match determines the policy for a request. Put specific website conditions before broader ones, and add FINAL at the end. DOMAIN-SUFFIX matches a domain and its subdomains; PROXY and DIRECT specify different routes. Examples demonstrate syntax only and do not represent working servers. Back up the current configuration before editing. After saving, confirm that the intended file is active and test the target website to check that the rule behaves as expected.
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECTThis section assumes you already have your own subscription. Import and update your server list through Subscribe. After adding it, check the group name and entries, then select a server to test. A successful update means the content was retrieved and parsed; it does not mean every connection in the list works. If the list is empty, check that the link is complete, accessible, and still valid. Give multiple subscriptions distinct names, and confirm the group before updating or deleting it. Store links containing personal credentials securely, and redact them before sharing troubleshooting details.
FINAL,DIRECTConfig manages rules and other configuration content; it is separate from the server entries on Home. Before making changes, confirm which file is active and keep a recoverable copy. Adding a file to the list does not make it active—check the selection after saving changes. If you use iCloud to sync content, check the sync result and active selection on the other device too; syncing is not a complete backup. Start with a few easy-to-understand rules, confirm how they work, and expand gradually to avoid changing several settings at once.
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECTIf a site is unreachable, first check your network, then the server settings and connection status, and finally rule matches and diagnostic details. Connectivity Test on Home can help compare your existing servers, but its results do not predict web page loading speed. Diagnostics in Settings can help investigate further, while Data can show traffic changes. When recording an issue, note the current mode, target domain, and error message, but redact addresses and credentials. Change one condition at a time to distinguish connection, DNS, and routing issues.
DOMAIN-SUFFIX,example.com,DIRECT
FINAL,PROXYProtocol fields must match the details for your existing server. Shadowsocks, VMess, VLESS, Trojan, and other types use different parameters; copying only Host and Port does not make a configuration complete. To add a server manually, start with Add Server, check Type, then fill in authentication, transport, and other required options. After scanning a QR code, check that all fields were imported.
Data reflects traffic recorded by the client and should not be treated as a server-side billing report. iCloud sync can carry some settings between devices, but check the content and active status. For complete instructions, see Features and Settings and the Server Management Manual.
Shadowrocket is a closed-source commercial app. This official website and manual organize guidance around App Store details and in-app steps. Before getting started, distinguish three things: verifying the app, keeping your purchase record, and managing your own configuration.
App availability, displayed currency, and purchase conditions depend on the storefront and account. If you cannot find the app in search, check its App Store product page, your account region, and device compatibility before proceeding; do not rely on a similar name. Check the App Store listing for system requirements. Requirements can change, so this guide does not present them as fixed.
On the product page, check the developer, official icon, and App ID in the URL. The developer should be Shadow Launch Technology Limited, and the App ID should be 932747118. Assess all three details together; a similar icon or matching name alone is not enough to verify the app.
The US App Store reference price is $2.99 as a one-time purchase. Other storefronts display local currency; check the listed price before paying. The purchase covers use of the app, not access to a particular server. Check the App Store listing for Universal Purchase eligibility, device requirements, and other purchase conditions for iPhone and iPad.
When reinstalling or switching devices, use the Apple ID associated with the purchase to check your App Store purchase history. Purchase records can help you restore the app, but do not replace a personal configuration backup. App updates are also managed through the App Store. Keep important configurations before updating, then check the active mode, selected server, and rules file afterward.
Once you have your own connection details, import a subscription through Subscribe or enter a single server manually using Add Server. If you have a QR code, use Scan QR Code. After importing, check the server type and required fields, then select an entry to test. Do not include links containing credentials in public screenshots or posts.
Next, check Global Routing. For rule-based routing, select Config and confirm the active configuration. Turn on the connection switch on Home and allow Shadowrocket to add a VPN configuration when prompted by the system. Finally, visit a target website and verify the result. A system connection indicator only shows that a connection is established; it does not confirm website access or a rule match.
First, turn off the connection and confirm that your basic network access works. Then check that your subscription or server details are complete. Next, verify the selected entry, authentication fields, Global Routing, and active configuration. If only some websites have issues, investigate DNS and rules first. If every target fails, start by checking the connection itself.
When troubleshooting, do not change servers, edit protocol settings, and rewrite rules all at once. Keep the original configuration, change one condition at a time, and note what happens before and after. For step-by-step instructions, follow the User Guide. For managing multiple subscriptions, updates, and backups, see the relevant sections in Server Management.
A subscription mainly provides a server list; Config manages rules and other settings. For rule-based routing, check that Global Routing is set to Config and confirm which file is active. These settings serve different purposes and cannot replace each other.
The test target, your current network, server load, and the website's response all affect the experience. Compare results under the same network conditions, then check access to the target website instead of relying on a single test number.
First, check On Demand in Settings. If connection triggers are configured, the system may reconnect. After changing them, test what happens when switching networks before deciding whether to adjust anything else.
App purchase history and personal configurations are managed separately. Restore the app from your App Store purchase history, then check the actual results of your backup or iCloud sync. Confirm your current servers, rules file, and authorization status.
These articles cover practical steps for working with an existing configuration. Start with the basic guide to establish and verify a connection, then choose an article based on the issue you encounter. Avoid repeatedly changing rules before confirming your server details.
If Subscribe fails to parse or shows an empty list, check the link format, subscription status, and update timing in order. Determine whether the content could not be retrieved or was retrieved but could not be parsed, then import it again step by step.
Read the import checklist →Compare an always-on background connection with On Demand. Learn how to check settings against your connection patterns and iPhone battery usage instead of judging battery drain by background activity time alone.
Read the On Demand guide →Start with the connection switch, Global Routing, Config, and subscription updates to review steps that often cause confusion the first time you use the app. Learn what each screen controls, then follow the relevant guide to configure it.
Read the beginner's guide →