A rule-based proxy client for multiple platforms for connecting to existing servers and routing by rules. iPhone / iPad: $2.99 one-time through the App Store; Mac / Windows / Android / Linux: free.
First distinguish servers, subscriptions, and configuration files: servers store connection parameters; Subscribe updates a group of servers; Config determines how requests match rules. Importing one does not mean the other two are set up. The features below are grouped by task. Select a tile for key steps; examples explain rule syntax and do not include connection service details.
Match conditions, then apply a policy
Rule routing lets different requests use different handling. Check Rule in Config, then set Global Routing to Config in Home for rules to take effect during normal routing. DOMAIN-SUFFIX matches domain suffixes, IP-CIDR matches address ranges, and FINAL handles requests that did not match earlier rules. When checking a configuration, review rule order first, then confirm the target policy exists. Broad rules placed first can mask more specific rules later. Keep a copy of the original file, change one item at a time, and check match results against actual request logs.
On Demand triggers connections based on configured conditions; it does not create server details or fix an unavailable service. First connect manually in Home and verify access, then check the On Demand conditions in Settings. After making changes, test switching between Wi-Fi and cellular networks and confirm the behavior. If the connection turns back on after being switched off, check this feature and the relevant system connection settings instead of repeatedly deleting configurations. You can temporarily disable automatic triggers during troubleshooting, then re-enable them after manual connections work, so trigger issues are not mistaken for rule issues.
# Check in this order
Home
Settings → On Demand
Home → Connectivity Test
Type must match the existing service
Shadowrocket supports protocols such as Shadowsocks, VMess, VLESS, Trojan, and WireGuard. When adding a server, choose the corresponding Type in Add Server and enter the fields using your existing server information. Authentication and transport parameters differ by protocol and are not interchangeable. Correct Host and Port values do not guarantee that all other parameters are present; also check the password or identifier, TLS, and transport options. Confirm missing details with your service provider. Scanning a QR code can reduce typing errors, but check the protocol type and address after importing; a label alone does not show that a server is usable.
# Field checklist, not a connection configuration
Type
Host
Port
# Check authentication parameters for the selected protocol
Import an existing Subscribe resource
A subscription updates a server list in one place and requires a subscription URL that you already have. In Home, go to Add Server, select Subscribe, enter the existing address, and save. Then check the server entries that appear. If the result is empty, first confirm the URL is complete and still valid, and that its response uses a supported format. Do not repeatedly add the same URL. Keep any group notes you need before updating, and distinguish between deleting one server and deleting an entire subscription. Subscription URLs may contain access credentials; avoid sharing the full address in screenshots, support requests, or device migrations.
# Home → Add Server
Type: Subscribe
# Check after saving
# Group name / server list / update result
Check import and activation separately
Config stores rules and related settings; it serves a different purpose from the server list. After obtaining a configuration file, back up the current file and check its General, Rule, and Hosts sections, along with any referenced external resources. After importing, confirm the selected file and use Config in Global Routing. If some websites behave unexpectedly after switching, compare DNS settings, rule order, and policy names in the new and old files before reinstalling the client. FINAL,DIRECT in the example means that unmatched requests use a direct connection. It illustrates syntax and is not a complete configuration for a specific need.
Check connection status and request results separately
Connectivity Test provides an initial check of connectivity, Data shows traffic records, and Diagnostics and Log in Settings can help locate issues. A test response does not mean every request to a target website works, and an enabled connection does not mean all traffic is routed through a proxy. During troubleshooting, note the network, server, Global Routing mode, and action that caused the error, then compare them with the domains, policies, and error details in the logs. Hide credentials and personal information in addresses before sharing a report. After troubleshooting, adjust logging as needed to avoid accumulating records unrelated to the current issue.
# Check by layer
Home → Connectivity Test
Data
Settings → Diagnostics
Settings → Log
Config / Proxy / Direct
Global Routing has three modes: Config, Proxy, and Direct. Config handles requests according to the active configuration's rules; Proxy routes requests through a proxy path; Direct checks a direct connection. For everyday rule-based routing, select Config and confirm the corresponding file is enabled. During troubleshooting, switching modes can help narrow down the cause, but it will not fix incorrect server parameters. If Proxy works but Config does not, check the rules and DNS. After comparing modes, restore the original one so a temporary test setting is not mistaken for the final configuration.
On devices that support iCloud sync, first check the system account, iCloud Drive, and app permissions, then review Shadowrocket's sync settings. Sync and manual export are separate backup methods. Before migrating, keep a Config file with a clear purpose and safely store your existing service details. After importing on a new device, check the active file, selected server, Global Routing, and On Demand again. System connection permissions must also be confirmed on the new device. Do not overwrite the old device's content just because the file appears; verify the connection and rules before deciding whether to remove the original backup.
# Check each item after migration
Config
Home → Global Routing
Settings → On Demand
Home → Connectivity Test
Shadowrocket / 932747118
Verify the app · 2 ways to get it
App Store details and downloads from this site
For iPhone / iPad, verify the developer, official icon, and app ID. For Mac, Windows, Android, and Linux, choose an installer from this site's download page. Confirm the app identity and device type before importing.
Open the Shadowrocket App Store product page. The developer should be Shadow Launch Technology Limited, and the app ID should be 932747118. Also compare the official icon shown in this site's header: a white background with a blue-violet outlined design. Search result names and icons are only a starting point; open the product page and verify the developer and app ID rather than assuming similarly named listings are the same app. System requirements are as shown on the App Store page.
Shadowrocket is a closed-source commercial app. This manual explains features using interface terms and specific steps; ratings and download counts are not substitutes for verifying the app's identity. Desktop and Android users should start from this site's all-platforms download page. Installers are provided at /dl/shadowrocket/; choose the device and package format, then follow the system prompts to install.
Pricing and purchase coverage
iPhone / iPad: $2.99 one-time through the App Store; Mac / Windows / Android / Linux: free. App Store storefronts display prices in local currencies. The amount charged is shown on the product page and payment confirmation screen. iPhone and iPad can access the app through the purchased-items record for the same account. This purchase covers use of the client; it is not a recurring connection-service plan and does not generate server details.
A one-time client purchase is not a connection plan. This site does not provide, sell, or recommend nodes or subscriptions. Adding a server, scanning a QR code, and using Subscribe all require server information or a subscription that you already have. If you have the client but not those details, check with your own service provider rather than repeatedly switching files in Config.
App Store availability and account region
App Store search results depend on the storefront region associated with your Apple ID. If the app does not appear in the mainland China storefront, first check the region of your current store account, then see whether the product page is accessible. Change regions through the account settings in the system and review how balances, existing subscriptions, and payment methods may be affected. Changing your device's language or display region does not change the storefront region of your account.
Before purchasing, confirm that you are using a personal account you intend to keep, and retain your purchase record. Not finding the app in the store and a client connection failure are different issues: check the store and account for the former, and the server, network, and rules for the latter. Handling these separately avoids changing network settings before the app is installed.
Reinstalling, changing devices, and updates
To reinstall or move to a new iPhone / iPad, use the original purchase account to find the app in your purchased items and download it again. If you are prompted to purchase it again, check the account and purchase record before paying a second time. Reinstalling the app and restoring its configuration are separate tasks; back up and review the server selection, Config files, and automatic connection conditions from the original device.
Manage future iPhone / iPad updates through the App Store. Mac, Windows, Android, and Linux users can return to this site's download page for updated installers. Keep a copy of the active configuration before updating, then verify the existing connection path and review any new or changed settings. If the system blocks the first launch, follow the download page's installation guidance and check each source and system prompt; do not confuse an access failure with an installation prompt.
There are two ways to get Shadowrocket: iPhone / iPad: $2.99 one-time through the App Store; Mac / Windows / Android / Linux: free. Each link below opens the relevant section of this site's download page. Device detection only prioritizes the current device; before installing, check the processor, system, and package format.
$2.99 one-time through the App Store; free on other platforms. Both devices share the purchase record, and system requirements are as shown on the App Store page. After downloading, prepare your existing service details, then follow the guide to authorize the system connection configuration. Purchasing the app does not add servers automatically.
Free · Apple Silicon / Intel. Check the processor in About This Mac, then choose the matching dmg. If the first launch says the developer cannot be verified, confirm the file came from this site, then follow the download page's steps in System Settings under Privacy & Security.
Free. The download page provides a 64-bit installer. If SmartScreen displays a warning, first verify the download came from this site, then check for the Run anyway option under More info. After installation, check the client's connection settings and system network permissions separately.
Free. Use the arm64 package from the download page. Follow the system prompt to allow the browser or file manager installing the app to Install unknown apps. If the built-in browser cannot download the file, open this site's download page in the system browser and continue. Revoke the installation permission afterward if you no longer need it.
Free · deb / rpm / AppImage. Check your distribution's package format and processor architecture first; AppImage requires execute permission. The download page provides package formats and steps. If you encounter a dependency or permission error, keep the full error message, resolve the installation issue, and then import your existing configuration.
Installers are not code-signed, so the system may display a warning on first launch. Follow the steps only for files confirmed to be from this site; do not disable system-wide protections just to complete one installation. See the installation guidance for prompts, steps, and commands.
The preview below uses iPhone / iPad interface terms. Before starting, confirm that you have your own subscription or server information, and can distinguish a subscription URL from individual server parameters. For the first setup, establish one repeatable connection path before adding rules and automatic connection settings. That way, if an issue occurs, you can return to the last verified state.
01 / Home
Add a server or existing subscription
In Home, go to Add Server. For an individual server, choose the Type based on your details and enter Host, Port, and the relevant authentication fields. For an existing subscription, select Subscribe and save the complete URL. If you use Scan QR Code, open the imported details and check the parameters afterward. Scanning is an input method; it does not test the connection.
After saving, check that the expected entries appear in the SERVER group, then select a server to test. If the import is empty, check whether the URL was truncated, the subscription is valid, and the response is correct. Do not create multiple duplicate entries before confirming that the details are complete, and do not use a Config file URL as a server subscription URL.
02 / Global Routing
Confirm the mode and active configuration
For rule-based routing, select Config in Global Routing and confirm which file is active in Config. Proxy and Direct can help isolate an issue: the former checks the proxy path, and the latter checks a direct path. Selecting a mode does not replace server configuration; it cannot fill in missing parameters when server details are incorrect.
After importing a new configuration, first check that the policy names in Rule match your server selection, then review how FINAL is handled. Change one item at a time and keep the original file for comparison. If only Config fails, check DNS, rule order, and referenced resources before deleting all server details.
03 / Connectivity Test
Connect and verify actual requests
Return to Home and turn on the connection. On first use, follow the system prompt to allow the connection configuration to be added. After running Connectivity Test, open the website or app you actually need and check that its content loads. A test result is not identical to a real request, so the connection switch alone cannot confirm that every setting is correct.
If the connection fails, check in this order: current network → server parameters → Global Routing → Config and DNS. If only one website has an issue, note its domain and the time, then check which policy handled the request. Test Wi-Fi and cellular separately before enabling On Demand. Hide subscription credentials, passwords, and personal addresses when reporting an issue.
Choose an article for your task: if you have not downloaded the app, verify the store details first; if you can already connect, review protocol parameters; if you are changing devices, make a recoverable backup first. Articles cover client operations and the use of information you already have; they do not provide connection services.
Open the product page from search results, check the developer, official icon, and app ID, then confirm your store account and payment details. iPhone / iPad: $2.99 one-time; Mac, Windows, Android, and Linux: free. For first-time downloads or checking purchase records before reinstalling.
Distinguish the local private key, peer public key, and routing range, and check each parameter against your existing configuration details. Examples explain the fields and are not ready-to-use connection information. Before filling them in, confirm that your server supports the protocol and avoid putting each side's key in the wrong field.
Learn when to use iCloud sync and manual Config export. Before migrating, note the active server and mode. On the new device, check system permissions, the active configuration, and On Demand again. Test the restored setup before clearing files from the old device or backup.