A rule-based proxy client for iPhone and iPad. Use this official guide to verify the one-time purchase and App Store listing, import an existing subscription, set up rule-based routing, and test the connection.
Shadowrocket is available only through the App Store. First, check that the product page is visible in your account’s storefront, then verify the app identity, price, and device compatibility. Refer to the App Store listing for system requirements.
Verify the listing and make your purchase using your own App Store account. When establishing a connection for the first time, the system may ask to add a VPN configuration; confirm that Shadowrocket initiated the request before authorizing it. Installation is only the first step—you’ll also need to import your own existing subscription or server details.
See how to get Shadowrocket on iPhoneIf you’ve already purchased Shadowrocket with the same Apple ID, find and download it from Purchased on your iPad. App purchase and configuration transfer are separate processes. The landscape layout may differ from the portrait view in tutorials; use interface labels such as Home, Config, and Settings to find your way.
See how to get Shadowrocket on iPadShadowrocket is also available through the App Store on Mac and Apple TV. Refer to the App Store listing for compatibility and system requirements.
See the steps to get the app →Start by verifying your server details, then decide how requests should be handled. The six sections below cover where to find each feature, when to use it, and what to check. Rule snippets illustrate matching logic; they are not complete configurations for every user.
Explore the featuresCheck Global Routing on Home first, then determine whether rules in the configuration file are being applied. Config routes traffic according to the active configuration; Proxy sends applicable traffic through the selected proxy; Direct uses a direct connection. Rules are generally matched in order, so more specific conditions should come before fallback rules. If a site takes an unexpected route, check the current mode, then review the active file and rule order in Config rather than simply switching servers. After making a change, revisit the same destination and check the connection log to confirm which policy matched.
Uses the active Config to determine matching conditions and routing policies.
Routes applicable traffic through the selected proxy. Check the connection log when troubleshooting.
Uses a direct connection; this does not indicate whether the server itself is available.
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECTOn Demand starts a connection when specified network conditions are met; it does not test servers or automatically fix problems. Review the related options in Settings and understand the trigger conditions before enabling them. First confirm that a manual connection works, then adjust On Demand behavior. Otherwise, connection problems and unmet trigger conditions can be difficult to distinguish. If the connection reconnects automatically after a network change, check On Demand before repeatedly removing the VPN configuration. Assess battery use using system battery records, actual usage time, and connection status—not a single toggle.
Starts a connection when specified network conditions are met.
Confirm a manual connection works → check trigger conditions → test after switching networks.
Shadowrocket supports protocols including Shadowsocks, VMess, VLESS, Trojan, Hysteria2, and WireGuard. When adding a server, use your existing server details, select the correct Type in Add Server, and check the address, port, and authentication details one by one. Required fields vary by protocol; don’t substitute settings just because the names look similar or apply one protocol’s parameters to another. For TLS, transport, and other options, follow the values provided by your service provider. Saving confirms that the entry was created, not that it works—test the connection and verify actual requests.
Match Type to the parameters. Ask your own service provider about any missing information.
If you already have a subscription link, open Add Server from Home, set Type to Subscribe, paste your own link, and save. A subscription is generally used to retrieve and update server entries; it is separate from rule configuration in Config. After importing, check that the group appears and its entries are complete, then select a server and test it. If an update fails, check that the link was copied in full, is still valid, and is reachable on your current network. Don’t repeatedly add the same group. Subscription links may contain access credentials, so remove the link and authentication details before sharing an error report; include only the relevant error message.
Type: Subscribe
Paste your existing subscription link, then save and update.
Subscribe manages server entries; Config manages configuration files and rules. Check both.
Use Config to manage configuration files. For rule-based routing, first confirm which file is active, then review its General, Rule, and Hosts sections so you don’t edit an unused copy. Keep the original configuration before making changes, and adjust one type of setting at a time so you can compare results. Before using iCloud sync, check the devices’ iCloud accounts, system settings, and in-app options. Confirm sync by checking that the expected content appears on another device. Restoring an app purchase and syncing configurations are separate processes. After reinstalling the app, check that your files, server entries, and current selections are all in place.
[General]
[Rule]
[Host]Keep the original file → confirm the active configuration → adjust rules → verify requests.
Connectivity Test can help assess a connection, but its results don’t replace testing access to the actual website. If the test fails, check network status, server settings, system time, and rule-matching order in turn. If the test responds but a specific request fails, check routing and the connection log. Data shows traffic recorded by the app; it should not be treated as your service provider’s billing statement. For further investigation, check Diagnostics in Settings and note the action and network conditions when the error occurred. Before sharing diagnostic information, check whether it includes personal connection details.
Run a connection test first, then verify the actual request.
Traffic records help you monitor usage; diagnostics help pinpoint problems. They answer different questions.
These steps assume that the app is installed and you already have your own subscription or server details. First establish a connection you can verify, then add rules or on-demand conditions. This makes it easier to see the effect of each change.
Open Add Server from Home. For a single server, fill in the fields for the corresponding Type. For an existing subscription, select Subscribe and paste the complete link. After saving, return to Home and confirm the expected entries appear in the SERVER group. If the list is empty, resolve the import or update issue before changing rules. Use Scan QR Code only with your own existing details.
Select the server you want to test, then check Global Routing. To route requests using rules, choose Config and confirm an active configuration is available on the Config page. To troubleshoot the proxy route, use Proxy as appropriate for your test; Direct uses a direct connection. The mode determines how traffic is handled, while the selected server determines the connection destination. They are separate settings. Note your current selections so you have a clear baseline for comparison.
Turn on the connection switch at the top of Home and approve the VPN configuration when prompted by the system. Once connected, run Connectivity Test, then visit the destination you need and check the request log. A connected status doesn’t mean every site is being routed as expected. If something fails, first distinguish between “connection not established” and “specific request failed.” Keep the error text, change one variable at a time, and test again.
Shadowrocket is a closed-source commercial app. Verify the authentic app using its App Store product page: check the developer, official icon, and app ID. Confirm the price, compatibility, and purchase terms on the same page.
Developer: Shadow Launch Technology Limited
When you find Shadowrocket in search results, open its product page and check the developer’s full name against the official app icon shown here. Verify the app ID using id932747118 in the product page URL. Don’t rely on search ranking, a similar name, or a promotional image alone. Confirm all three details match before purchasing. If the information doesn’t match, return to the app verification page and reopen the specified product listing.
App Store listings vary by account storefront. Your device language and current location don’t necessarily indicate which storefront you’re using. If you can’t find the app, first check the account used for Media & Purchases and its country or region, then confirm the product page is available in that storefront. Before changing your region, review the system’s listed requirements, such as account balance, existing subscriptions, and payment methods. A page that won’t open, empty search results, and a failed purchase are different issues. Keep the specific error message when troubleshooting rather than treating them all as app problems.
The US storefront price is about US$2.99 as a one-time purchase. The current App Store listing shows the actual price, taxes, and final charge; other storefronts display local currencies. Buying the client ≠ buying a service plan. Your purchase provides a license to use the app. Connection details, including subscriptions or server information, must come from your own service provider. This guide does not provide, sell, or recommend servers or subscriptions; it explains how to verify the listing, import your existing details, and check your settings.
iPhone and iPad users can get the app from their Purchased history using the same Apple ID. When switching devices or reinstalling, sign in to the App Store with the account used for the purchase, find Shadowrocket in Purchased, and download it again. If the listing asks you to pay, check the account and purchase history first. Being able to download the app again doesn’t mean your subscription, servers, or configuration have been restored. After opening the app, check Home, Config, and Settings in turn, and reimport your own details if needed. Family Sharing eligibility depends on the App Store listing and account settings.
Update Shadowrocket through the App Store. You can use automatic updates if enabled in your system settings, or check for updates in the store. Keep important configurations before updating. If connection behavior changes afterward, first check whether your previous selections are still active, then review the in-app settings. Always refer to the App Store listing for system requirements; this guide does not list requirements that may change. Check purchase, payment, and account status in Apple’s system interfaces. Review routing, imports, and connection behavior in Shadowrocket.
Read the complete App Store guide →After getting started, browse by topic for help finding interface options, moving to another device, or setting up on-demand connections. Instructions retain the app’s English interface labels so you can match them directly. For account and compatibility details, refer to the current App Store listing.
Learn how to redownload Shadowrocket from Purchased on an iPad using the same Apple ID, and what to check when using landscape layout, syncing configurations, or reimporting a subscription. First distinguish purchase history from connection details, then identify what needs to be restored.
Read the guide →A guide to the English labels in the bottom navigation and frequently used screens, with the location of each feature. Learn to distinguish page names, routing modes, and traffic statistics so you don’t change a setting in the wrong place.
Read the guide →Learn how On Demand triggers connections and relates to background activity, and how to check battery use in system settings. Note your actual usage patterns before deciding whether to adjust on-demand conditions; don’t draw conclusions from background time alone.
Read the guide →