Free for Mac, Windows, Android and Linux
Current version v · Mac, Windows, Android and Linux versions are free; iPhone / iPad are a one-time App Store purchase for $2.99.
Official site · Official guide
Cross-platform client for managing connections with rules. Supports rule-based routing; iPhone / iPad: $2.99 one-time in the App Store; other platforms are free.
Current version v · Mac, Windows, Android and Linux versions are free; iPhone / iPad are a one-time App Store purchase for $2.99.
One purchase covers iPhone / iPad; Mac, Windows, Android and Linux versions are free. Check the App Store page for system requirements.
First-time setup: subscription import and connection steps →
Rule routing determines which policy handles a connection. On Home, select Config under Global Routing to have the client process requests using the current configuration. Rules are usually evaluated from top to bottom; the first match determines the result, while FINAL handles requests that did not match earlier rules. Before editing, confirm that the policy name exists, then check the domain, address range and rule order. When troubleshooting a website, check which rule actually matched instead of judging traffic flow only by whether a server is selected.
DOMAIN-SUFFIX,example.com,PROXY
GEOIP,CN,DIRECT
FINAL,DIRECT
On Demand triggers connections when configured conditions are met and can be reviewed in Settings. First verify a manual connection and access, then configure automatic connection conditions to distinguish server parameter issues from trigger issues. If a connection resumes after being manually turned off, check On Demand before repeatedly deleting the configuration. It controls when a connection is established; it does not replace Global Routing in determining where traffic goes. After making changes, test on both Wi-Fi and cellular networks and observe what happens when switching networks.
Settings
On Demand
Home
Global Routing
Shadowrocket supports multiple protocols. To add an existing server, choose the Type in Add Server according to the information provided by your service provider. Do not treat VMess and VLESS as interchangeable types. Host, Port, authentication fields and transport settings must all match; TLS, server name and path can also affect the connection. Import the complete link first, then check each imported field. Protocol names describe connection methods, not speed rankings. When parameters do not match, changing a single field other than Type usually will not solve the problem.
Shadowsocks · VMess · VLESS
Trojan · Hysteria2 · WireGuard
HTTP · SOCKS5
Add Server → Type
Get the subscription link from your service provider. In Add Server, select Subscribe, enter the complete address and save it, then update the list. After importing, confirm that server entries appear, then select an entry to test. A subscription update synchronizes the remote list; it does not mean that the rules in Config have also been updated. If the list is empty, first check whether the link has expired or is missing characters, then verify that your current network can reach the subscription address. Subscription links may contain authentication details, so hide the full address before sharing screenshots or logs.
Add Server
Type → Subscribe
URL → Get it from your service provider
Save → Update list → Select a server
Config stores rules and related settings. A server entry in the list does not mean the corresponding rules are active. Confirm the configuration currently in use in Config, then return to Home and check Global Routing. Keep a recoverable copy before editing and change one category of settings at a time to make it easier to roll back. When using iCloud sync, also verify the working configuration and current selection on another device; successful syncing does not confirm a successful connection. The policy names referenced by rules must match the definitions in the configuration exactly, including spelling.
[General]
[Rule]
DOMAIN-SUFFIX,example.com,DIRECT
FINAL,DIRECT
Connectivity Test on Home checks connectivity, while Test Method in Settings affects how the test is performed. A response does not guarantee that a target website is accessible or indicate download speed. When troubleshooting, note the current network, selected server and Global Routing, then compare access to the same target. Traffic records in Data can help confirm whether requests passed through, but do not replace checking matched rules and logs. Before sharing Diagnostics information, hide server addresses, authentication fields and subscription links.
Home → Connectivity Test
Settings → Test Method
Settings → Diagnostics
Data
iPhone / iPad: $2.99 one-time in the App Store; Mac, Windows, Android and Linux versions are free. Choose installation instructions by device instead of guessing from a filename.
$2.99 one-time in the App Store; other platforms are free. Both devices share one purchase. Check the App Store page for system requirements. First confirm the app and the account used for the purchase, then check the acquisition status shown on the store page.
Free, with separate installers for Apple Silicon and Intel; iPhone / iPad are a one-time App Store purchase for $2.99. Check the chip in About This Mac, then choose the matching file on the download page to avoid selecting the wrong architecture.
Free, with a 64-bit installer; iPhone / iPad are a one-time App Store purchase for $2.99. Quit any running client before installation. When it is complete, check existing configuration and system network status before testing the connection.
Free, with an arm64 package; iPhone / iPad are a one-time App Store purchase for $2.99. Open the download page in your system browser, check the saved file and its source, then follow the system prompts to grant installation permission.
Free, with deb, rpm and AppImage packages; iPhone / iPad are a one-time App Store purchase for $2.99. Choose a file according to your distribution and package manager, read the permission notes, then follow the relevant installation steps.
Get desktop and Android installers from this site's download page. Files are hosted under /dl/shadowrocket/ on this site. The system may block the first launch. If Windows displays a SmartScreen prompt, confirm the file came from this site, then select “More info → Run anyway” to continue. On Mac, find “Open Anyway” for the app under “Privacy & Security.” On Android, allow “Install unknown apps” for the browser or file manager you are using; you can revoke this permission afterward.
AppImage on Linux requires execute permission; install deb and rpm packages using your distribution's package management process. If Mac displays a warning such as “is damaged,” first verify the file source and installation location, then follow the specific steps on the download page. Do not disable the system's overall security settings. Prompt wording varies by system; the installation permission guide brings the steps together so you can check them before proceeding.
Before importing a configuration, distinguish app purchases, installation sources and connection services.
On the App Store product page, verify the name Shadowrocket, the official icon and the developer Shadow Launch Technology Limited. The app ID is 932747118 and also appears in the product page URL. Search results may include similarly named apps, so open the details page to verify it instead of relying only on the name or listing position.
Shadowrocket is closed-source commercial software. Client features and purchase status are shown on the relevant product page and in the app. For desktop and Android, use the installation packages on this site's download page; do not rely on similar names, file icons or webpage descriptions to verify a source.
When checking the store, make sure you are viewing the app details, not an article, search suggestion or another listing. Save the product page link so you can use the same app details to check purchases, updates and purchase restoration later, reducing confusion if search results change.
How to verify the app →iPhone / iPad: $2.99 one-time in the App Store. Mac, Windows, Android and Linux versions are free. The store displays the local currency for your storefront, so check the amount before paying. iPhone and iPad share one purchase. Use the purchasing account to restore it on a compatible device; reinstalling does not mean you need to buy it again.
After changing devices, first check the account used for “Media & Purchases,” then find Shadowrocket in App Store purchases. If a price is still shown, check the account, purchase history and app ID before considering another payment. Restoring an app purchase and restoring configuration are separate tasks; rules and server details from the old device need to be checked separately.
This app may not be available in the mainland China App Store. App visibility depends on the store region, so check the region of the account used for purchases, not just the device language. Before changing regions, review the balance, subscriptions and payment method requirements shown on the account page.
Read the App Store guide →Shadowrocket manages existing server details and connection rules. Getting the app does not include a connection service. This site does not provide, sell or recommend servers or subscriptions. Get subscription links from your service provider. If using your own server, prepare its protocol, address, port and authentication details first.
A successful import means the client has read the content; it does not guarantee that the remote service is available. Check service duration, server status and authentication changes with your service provider. The client's connectivity tests, rule records and Diagnostics can help locate a problem, but cannot replace the remote service itself.
Keep any configuration you need before updating the app. Update iPhone / iPad through the App Store; get desktop and Android installers from this site's download page. After updating, check the current configuration, selected server and Global Routing before resuming your usual workflow, so you do not mistake a settings change for a connection service issue.
Subscriptions, servers and Config →The preview below uses the iPhone / iPad interface. Check the result at each step before moving on.
First identify whether you have a subscription link, a single server link or server details to enter manually. Get subscription links from your service provider; in Add Server, select Subscribe and enter the complete URL. For a single server, choose Type based on the original details, check Host, Port and authentication fields, then save and return to Home to view the SERVER group.
If using Scan QR Code, first confirm the source of the QR code and check the result after scanning. If the list is empty after import, stop here and check the address and update result. Do not change Global Routing or repeatedly toggle the connection first. Once the entry appears, select one server for the initial test and avoid changing multiple configurations at the same time.
Config processes connections using the rules in the current configuration, suitable when you have existing rules and want to route traffic by destination. Proxy handles traffic managed by the client using the proxy, which helps with targeted connection comparisons. Direct connects without a proxy. Do not assume that requests are going through the selected server just because the top-level switch is on.
When using Config for the first time, open Config to confirm the active file and check the policy names referenced by its rules. During troubleshooting, note the original mode, change one setting for comparison, then restore the original setting after the test. A mode describes how traffic is handled; it does not guarantee access to every destination. Results also depend on the rules, server and current network.
After confirming the server and mode, turn on the connection switch. If the system asks for VPN configuration permission for the first time, verify the app name and follow the system prompts. Return to Home to check the connection status, run Connectivity Test for an initial check, then visit the actual destination you need. Check test responses and access to the actual page separately rather than relying on just one.
If the connection fails, first check whether the local network works, then verify server authentication and protocol settings. If only some destinations fail, check matched rules, DNS and remote status. Change one setting at a time and record what happens before and after. If the connection resumes after being turned off, check the On Demand conditions in Settings to avoid mistaking automatic reconnection for a faulty switch.
A server entry describes where to connect and which protocol and authentication to use. A subscription updates a set of server details from a remote source. Config determines rules and related handling. These three work together but are not interchangeable. Changing servers may leave the rules unchanged, and updating a subscription does not switch the active configuration. Checking in this order is usually easier than deleting everything and starting over.
When preparing information for help, note the screen, current mode, failed destination and error message. Server passwords, subscription URLs and QR codes may contain access credentials, so do not include them in public screenshots. Keep a verified working configuration to help distinguish problems caused by recent changes from changes in the network itself.
First check whether Global Routing is set to Direct. If it is set to Config, check the rule and policy that matched the destination. The switch controls connection status; it does not determine where every request goes. See the quick reference for definitions.
The subscription list and Config are separate. After updating the server list, also check the selected server and active configuration. See subscriptions and configurations for details.
Not necessarily. Test Method, the test destination and the actual request path may differ. Check destination access, matched rules and Diagnostics together. See connection and diagnostics terms.
Start with the specific issue, identify where it occurs, then change the relevant setting.
Explains the main sources of background battery use, compares On Demand with an always-on connection, and outlines how to set triggers for different usage scenarios.
When subscription parsing fails or the list is empty, check the link format, service provider status, update timing and network environment in four steps, then follow the correct import procedure.
Answers ten common first-time questions, including Global Routing modes, the connection switch, VPN configuration permission and subscription updates.