A rule-based proxy client for multiple platforms. Choose the app for your device, import existing connection profiles, configure Global Routing and rule-based routing, then test each connection.
iPhone / iPad: $2.99 one-time · Other platforms: free
Features and Settings Reference
Review what each feature does before opening its settings.
Global Routing: Choose how connections are handled
Open Global Routing in Home and choose Config, Proxy, or Direct for the task at hand. Config uses the rules in the active configuration; Proxy sends connections handled by the client through the selected proxy; Direct connects without a proxy. For everyday rule-based routing, choose Config and confirm which configuration file is active. You can switch modes temporarily for troubleshooting, then restore the previous selection when testing is complete. The mode controls connection handling; it does not supply server parameters or restore an expired subscription.
On Demand triggers connections when configured conditions are met, reducing the need to toggle the connection manually. First connect and test access from Home, then review the On Demand options in Settings. When enabled, the system may reconnect when conditions are met. If the connection returns after you disconnect manually, check these settings first. To stop testing completely, disable the relevant conditions before disconnecting. On-demand connection is separate from subscription updates, so check each independently.
Rule-Based Routing: Specific rules first, FINAL last
Rules are checked in order, and the matching connection is handled by the specified policy. DOMAIN-SUFFIX matches domain suffixes, IP-CIDR matches address ranges, and FINAL handles connections that matched no earlier rule. In Config, open Rule and check the order, then confirm that each policy name exists. Do not place an exception after a broader rule that already covers it. Keep a copy before editing, change one item at a time, and retest the target connection. The example below illustrates syntax only; it is not a complete configuration for any particular network.
A subscription reads a server list from an address you already have; it is not a complete rule-based routing configuration. In Add Server, choose Subscribe, paste your own subscription URL, and save. Then return to Home to check the group. If an update fails, confirm that the URL is complete, the subscription is still valid, and the current network can reach it. Label multiple sources clearly to avoid duplicate entries. Subscription URLs may contain access credentials, so hide the URL and identifying details before sharing troubleshooting screenshots.
Multiple protocols: Match the Type in your existing profile
Shadowrocket can handle connection profiles for protocols such as Shadowsocks, VMess, VLESS, and Trojan. To add a server manually, choose its Type in Add Server, then enter the address, port, and authentication details in the corresponding fields. Passwords, identifiers, and transport options differ by protocol and cannot be interchanged. For TLS, also check SNI and certificate settings. Do not disable certificate verification just to suppress an error. Ask your own service provider to confirm missing parameters; changing the protocol name alone cannot fix a server mismatch.
Config: Distinguish the server list from configuration files
Config manages rules, DNS, and other connection settings. A working server does not mean the right configuration is active; after importing a configuration, confirm which one is selected. Save the original file before editing. Check only the relevant parts of General, Rule, and Hosts, and do not replace settings you do not understand. Before importing a remote configuration, check its source and purpose, especially settings such as URL Rewrite and HTTPS Decryption that affect request handling. You do not need to enable them just to get started.
Traffic records in Data show connections handled by the client; they are not a provider's billing records. When troubleshooting, note the test time, run Connectivity Test, then visit a familiar destination. Use the connection records to see whether the request entered the client, which policy was applied, and whether it failed. A latency test reflects only its specific test method and does not replace real-world access checks. For further investigation, open Diagnostics in Settings. Remove sensitive domains, addresses, and account details before sharing records.
On devices that support the relevant features, use iCloud options to manage configuration sync and backups. Confirm that the device uses the intended iCloud account and that the system allows the app access, then check the sync items actually provided in the app. When setting up for the first time or moving to a new device, keep a verified copy of your configuration so that an empty list or incorrect settings are not synced. App purchases, configuration data, and service-provider subscriptions are separate. After restoring the app from the store, check your connection profiles and active configuration separately.
iPhone/iPad: $2.99 one-time purchase in the App Store; Mac, Windows, Android, and Linux: free. Use your store purchase record on phones and tablets, and get desktop and Android installers from this site's download page. Installers are served under /dl/shadowrocket/. Choose your device first, then check the processor or system requirements and installer format. Do not rely on the file extension alone to determine compatibility.
iPhone / iPad
$2.99 one-time purchase in the App Store; other platforms are free. Both device types can use the purchase record for the same account. Check the App Store page for system requirements.
Check the store region and product details first. When changing devices, look for the app in your purchased items. Restoring the app and restoring your personal configuration are separate steps; check your existing subscription and Config after the download.
Free · Apple Silicon / Intel. iPhone/iPad: $2.99 one-time purchase in the App Store; Windows, Android, and Linux: free.
Check the chip or processor in About This Mac, then choose the corresponding version. If macOS blocks the first launch, confirm that the file came from this site, then follow the download page's steps under Privacy & Security.
Free. iPhone/iPad: $2.99 one-time purchase in the App Store; Mac, Android, and Linux: free.
The download page provides a 64-bit installer. If SmartScreen appears, confirm the download source, then review the option under More info. On organization-managed computers, follow the administrator's settings rather than attempting to bypass device policies.
Free. iPhone/iPad: $2.99 one-time purchase in the App Store; Mac, Windows, and Linux: free.
Open the download page in your system browser and get the arm64 installer as directed. If prompted, allow your browser to install unknown apps for this installation only. If downloading from within WeChat does not work, use the system browser. You can revoke this permission after installation.
Free · deb / rpm / AppImage. iPhone/iPad: $2.99 one-time purchase in the App Store; Mac, Windows, and Android: free.
Choose a format that matches your distribution's package manager. AppImage requires execute permission. Read the download page's command instructions before using them with the downloaded file. Do not mix commands for different formats. If you see a dependency error, keep the full message for troubleshooting.
Shadowrocket is a closed-source commercial app. This is the Shadowrocket official website and guide, with download and setup instructions organized by platform. Verify the product using its visible details rather than relying only on search-result abbreviations, icon colors, or placement. Manage your store purchase record separately from your own connection profiles.
Two ways to get the appDeveloper: Shadow Launch Technology LimitedApp ID 932747118
Check the developer, icon, and app ID
On iPhone or iPad, open the product page and confirm the developer is Shadow Launch Technology Limited, the icon matches the official icon shown in this site's header, and the product page URL contains app ID 932747118. Check all three details; do not rely on just one. Similar names in search results do not identify the same app. Use the product page linked from the download page before making a purchase.
Desktop and Android users can choose their platform on this site's download page, where installers are provided through this site's download paths. The phone app's store purchase button is not a Mac installer link, and a similar-looking filename does not mean the file is built for your device. The download page also explains system prompts that may appear during first-time installation; read the instructions for your platform first.
App Store availability depends on the account region
App Store content for iPhone and iPad depends on the region of the current purchasing account, not just the device language. The app is not currently available in the mainland China store. If it does not appear in search, check the App Store account and its region, then see whether the product page is available. Repeatedly changing the device language or trying similar search terms will not resolve store availability.
If you need to change your own store region, first review any balance, existing subscriptions, payment methods, and family-group restrictions, then follow the account settings provided by the system. Eligibility to change regions, displayed currency, and product availability depend on the store's actual prompts. This site's installation guide explains verification steps and does not provide accounts.
One-time purchase on iPhone and iPad; other platforms are free
iPhone/iPad: $2.99 one-time purchase in the App Store; Mac, Windows, Android, and Linux: free. The same purchasing account can use its purchase record on compatible iPhone and iPad devices, so you do not need to buy the app separately for each device. Stores may display prices in local currencies; check the confirmation screen before purchasing. Check the App Store page for system requirements.
The purchase record belongs to the account used to buy the app and is separate from any configuration stored in iCloud. When changing devices, check the store account, configuration backup, and subscription address separately. For Family Sharing, review the product page and the eligibility of your current family group; restoring an account and accessing an app as a family member are different processes.
Restore the app and update it separately
After changing devices or reinstalling, find Shadowrocket in App Store purchases and confirm that you are using the original purchasing account. If the store shows a purchase price again, check the account, region, and purchase record before taking any action. After restoring the app, check the server list in Home and the selected Config before connecting.
Manage iPhone and iPad app updates through the App Store. Mac, Windows, Android, and Linux users can get the latest release from this site's download page. Save your usable configuration and necessary connection profiles before updating, then test a connection afterward. Installer files and configuration files serve different purposes; updating the app does not restore an expired subscription.
Before setup, distinguish three types of information
Server parameters describe where to connect and which protocol and authentication method to use. A subscription lets you import and update server entries in one place. A configuration file determines how rules, DNS, and other behavior are handled. If traffic does not follow the expected rules after importing a subscription, the import may have succeeded while Config is not selected or Global Routing is still set to Proxy. Identify which layer is causing the issue before changing settings.
When troubleshooting, check in this order: “Is the source profile valid? → Are the parameters complete? → Is the current mode correct? → How is the request handled?” Change one condition at a time and keep the original settings so you can identify what affected the result. When contacting your service provider, include the test time, system prompt, and redacted error details. Do not share a full subscription URL or configuration containing authentication information.
The steps below use the iPhone/iPad interface as an example. Before you start, prepare a subscription URL or complete server parameters you already have, and confirm that your current network can access ordinary websites. Begin with a manual connection. Once the basic steps work, consider On Demand, configuration sync, or further rule changes. This avoids introducing several variables at once and makes problems harder to locate.
Step 01
Add Server: Import an existing profile
Tap Add Server in Home. If you have a subscription, choose Subscribe and enter its URL. If you have details for a single server, choose the matching Type first, then fill in the corresponding fields such as Host, Port, and Password. You can use Scan QR Code to read your own QR code, but still check that the detected protocol and address are correct.
After saving, return to Home and confirm an entry appears in the SERVER group. Then select a server for this test. If the list is empty, first check whether the subscription was read successfully; do not immediately change DNS or rules. When copying a subscription URL, check the original for spaces or missing characters. Do not mistake a webpage description URL for a subscription URL.
Open Global Routing and choose Config, Proxy, or Direct for your intended use. For rule-based routing, use Config and confirm the active file in Config. Proxy can help check whether a proxied connection works; Direct can help test direct access. Neither replaces a complete rule configuration.
If some requests behave differently than expected after selecting a server, check the mode first, then review the rule match order. Importing more servers does not automatically change existing routing rules, and you do not need to edit every advanced setting just to connect for the first time. Note the initial selection so you can restore the previous configuration after testing.
Return to Home and turn on the connection. On first use, follow the system prompt to allow a VPN configuration. Then run Connectivity Test and visit a familiar website. A connected status means the system connection is established, but requests also depend on the server, rules, DNS, and destination service. Do not judge success by the status icon alone.
If the test and actual browsing results differ, note the selected server, mode, and test method, then check the connection records. If only one destination fails, compare its matching rule and DNS result. If all destinations fail, check the server details and current network first. Once a manual connection works, configure On Demand and test behavior when switching networks.
Browse by topic for issues beyond the basics: check the platform and system permissions for installation problems, review each field in Add Server for parameter issues, and compare the test method with actual access for connection behavior. The articles below cover Android installation, choosing among servers you already have, and Trojan authentication and TLS parameters. They do not provide or rate connection services.
Open the Android section on this site's download page to learn how to allow the current browser to install unknown apps and switch to the system browser if tapping a download link in WeChat does nothing. Installation permission and app connection permission are separate. Check your existing profile import after installation.
For users who already have a server list, this article explains how test methods, destination locations, and protocol requirements affect results. Understand the limits of latency measurements, then make decisions based on actual access rather than assuming a low test figure means every request will work.
Learn how to map existing Trojan details to the fields in Add Server, including the distinction between the connection address, authentication password, and SNI. For TLS errors, check the original parameters and system time first, then review certificate prompts instead of repeatedly changing unrelated options.