Cross-platform proxy client with rule-based routing. Start with an existing subscription or server details, then import, configure rules, and verify the connection.
Choose by device. Check system requirements, then select an installation option.
Shadowrocket is available in two ways: a one-time $2.99 App Store purchase for iPhone / iPad, and free versions for Mac, Windows, Android, and Linux. For iPhone / iPad, check the App Store listing for system requirements. Get installation files for other platforms from this site's download page, under /dl/shadowrocket/. These cards introduce each platform; the download page has the specific installers and guidance for system prompts on first launch.
iPhone / iPad
$2.99 one-time App Store purchase. Check the product page with your own purchase account, then download. The same purchase account can redownload the app on eligible iPhone and iPad devices. Check the App Store listing for system requirements. Whether the app appears in the store depends on the storefront associated with the account, not the device's current interface language.
Free · Apple silicon / Intel. Open About This Mac and choose the installer that matches the chip or processor information; don't guess based on appearance or purchase year. If you see “Unable to verify developer” on first launch, confirm the file came from this site, then follow the download page's instructions under “Privacy & Security.” Repeatedly replacing the file is unnecessary.
Free. The download page provides a 64-bit installer; keep your existing configuration before installing. If SmartScreen blocks the app, confirm the download source, then follow the “More info → Run anyway” instructions. Stop if you don't recognize the file source. After opening the client, you still need to import your existing subscription or server details.
Free. Use the arm64 installer provided on this site's download page. If Android asks to “Allow installation of unknown apps,” grant only the necessary permission to the app used to download and open the file, and revoke it afterward if you wish. If the download won't open inside a messaging app, continue in the system browser and confirm the address is still on this site.
Free · deb / rpm / AppImage. Choose a format that matches your distribution's package management; don't install different formats one after another. AppImage needs execution permission before first launch, while deb and rpm packages are handled by their respective package managers. The download page lists installation commands and permission steps. Save your current configuration before updating.
Understand the configuration layers. Separate connection details, matching rules, and automatic connections.
PLATE 01 / RULE ORDER
Rule-based routing and first-match behavior
In Home, select Config under Global Routing to process requests according to the rules in the active configuration. Open Config and review rule order: specific domains should generally appear before broader matches, while FINAL handles requests that didn't match earlier rules. PROXY, DIRECT, and REJECT are different policies, not speed ratings. Before making changes, back up the configuration and edit one rule at a time. Retest the same destination to avoid changing the server, DNS, and rules all at once and losing track of the cause.
DOMAIN-SUFFIX,example.com,PROXY
PLATE 02 / ON DEMAND
On Demand and connection triggers
On Demand triggers connections based on conditions; it doesn't replace server details or fix an invalid subscription. First connect manually and confirm that a webpage loads, then review the On Demand conditions in Settings and test each one on the required network. Note the network and toggle state before and after testing, and distinguish this behavior from disconnecting manually. If the connection keeps coming back, review the existing conditions before repeatedly tapping the main switch. Restore any required automatic connection settings after troubleshooting.
Settings → On Demand
PLATE 03 / PROTOCOL PARAMETERS
Protocol types and connection fields
Shadowrocket supports protocols including Shadowsocks, VMess, VLESS, Trojan, and WireGuard. To add a server manually, choose the same Type as the existing server in Add Server, then check the address, port, authentication details, and relevant transport settings one by one. Fields differ between protocols and can't be used interchangeably; changing a name doesn't change the protocol. If you have complete import details, use the original content where possible and check the fields after saving. When a connection fails, verify the information against its source instead of guessing which protocol is suitable based on latency.
Add Server → Type
PLATE 04 / SUBSCRIPTION INPUT
Subscribe groups and updates
Import a subscription from a link you already have. When refreshed, the client rereads the server list from that link. After importing, check the group name and entries before running a connection test. Adding the same link repeatedly isn't the same as updating it and may create duplicate groups. If the list changes, first confirm that the update succeeded, then check whether the original provider removed any entries. Subscription URLs may contain access credentials; don't include them in public screenshots or support requests. Before deleting a group, make sure you still have the original link and any necessary notes.
Subscribe
PLATE 05 / CONFIGURATION FILE
Config backup and sync
Config manages files that determine how requests are handled; it is separate from the server list in Home. Before editing General, Rule, Hosts, or other sections, export a restorable copy and confirm which file is currently active. When using iCloud sync, check the sync status on each device; don't treat sync as a backup of previous versions. After moving to a new device, check that both server details and configuration are present. Seeing a filename doesn't mean its referenced policies and connection details are ready.
[General] / [Rule] / [Hosts]
PLATE 06 / DIAGNOSTIC CHECKS
Connectivity Test, Data, and Diagnostics
Connectivity Test provides an initial connection check, Data helps monitor traffic, and Diagnostics in Settings supports further troubleshooting. A test response doesn't mean every webpage will load correctly; use the actual destination to verify the combined DNS, rules, and server behavior. Troubleshoot in order: check the basic network, confirm the selected entry, then review the matching policy. When saving an error message, note the step where it occurred and the network environment, and conceal subscription URLs and authentication fields. Don't draw conclusions from a screenshot of test numbers alone.
Connectivity Test → Data → Diagnostics
Once you understand these six layers, decide which one needs attention: server details answer “where to connect,” Global Routing answers “how to handle requests,” rules determine “which policy applies to this request,” and On Demand sets “when to connect.” These settings are related but aren't interchangeable. Keep the initial setup simple: confirm one known-working connection and one clearly defined configuration before adding rules or automation.
§ 03Quick start preview
Start with details you already have. Import, choose a mode, then test the connection.
01
Add Server / Subscribe: import connection details
Prepare a subscription link, QR code, or server parameters you already have. To enter details manually, open Add Server, choose Type, then fill in the corresponding fields. To use a QR code, select Scan QR Code and confirm the result matches the original details. After importing a subscription, return to Home and check the group and server entries. Don't keep adding the same link just because it hasn't connected yet. Importing brings the details into the client; it doesn't confirm that the server itself is available.
If an entry is empty after saving, fields are missing, or you see a format error, check the original details and make sure they were copied in full. Pay particular attention to spaces, line breaks, or truncated parameters around a link. When contacting the provider of your connection details, describe the error without publicly sharing a full subscription URL that contains credentials.
02
Global Routing: check Config / Proxy / Direct
Select the server you plan to use in Home, then check Global Routing. Config mode routes traffic according to the rules in the active configuration. Proxy mode handles eligible requests using that mode, while Direct connects without the proxy. Direct isn't a server selection, and Proxy isn't a rules file. To handle destinations differently by domain or address, first confirm which file is active in Config and which policies it references.
For the first test, don't change several settings at once. Note the current mode and server, then compare results for the same webpage before and after a change. If a destination won't open, first check whether the problem affects only that destination before reviewing its rules. Don't delete the entire configuration straight away.
03
Home: connect and verify with a real destination
Turn on the connection. On first use, follow the system prompt to allow adding a VPN configuration and complete any required device confirmation. Once the switch shows a connection status, run Connectivity Test and then visit the destination you need in a browser. A VPN indicator means the local connection configuration has started; it doesn't confirm that remote authentication, DNS resolution, and rule handling are all correct. Check the actual access result.
If it fails, troubleshoot in this order: basic network, server fields, current mode, DNS, and rules. Change one condition at a time and note the error message. Restore the original settings after temporary tests. If you need On Demand, add its conditions after a manual connection is stable, so automatic behavior doesn't complicate troubleshooting.
Verify the product and purchase record. Getting the client and getting a connection service are separate.
Official guide2 ways to get itClosed-source commercial app
Developer Shadow Launch Technology LimitedApp ID 932747118
Verify three details on the App Store listing
On the App Store product page on iPhone / iPad, check the developer name, official icon, and app ID together. The developer should be Shadow Launch Technology Limited, and the app ID should be 932747118. Compare the icon with the official icon in this site's header. The name or position in search results isn't enough to verify an app. Open the product details and check the developer and the number in the link. An entry with a similar name but a different number is not the same app.
Shadowrocket is a closed-source commercial app. Product details and actual download channels are used here to identify it; ratings, download counts, and unverified release dates are not substitutes for verification. Desktop and Android users can choose the appropriate installer from this site's download page, under /dl/shadowrocket/. Don't assume a file is genuine based only on its icon or a similar filename.
Store visibility and account region
The app is currently unavailable on the China mainland App Store. Device language, system region, and the storefront associated with a purchase account are separate settings. Changing the system language alone doesn't change the App Store catalog. If you can't find the app, first check the account used for “Media & Purchases” and its country or region, then check whether the product page is visible. Store availability may change; the App Store page opened by your account is the final reference.
Before changing an account's region, review the system requirements for balances, subscriptions, and payment methods, and use your own accurate information that meets the requirements. Don't make repeated changes without understanding the consequences. For system compatibility, check the App Store listing. Search problems, payment issues, and download failures should be investigated separately rather than treated as one client issue.
One-time purchase and restoring on a new device
There are two pricing options: a one-time $2.99 App Store purchase for iPhone / iPad, with the local price shown by each storefront; Mac, Windows, Android, and Linux versions are free. The same purchase account can be used to access the purchase on iPhone and iPad. You don't need to create a new purchase record just because you changed devices. The actual amount and eligibility are shown at checkout.
After changing devices or reinstalling, sign in to the original purchase account in the App Store, open “Purchased,” find Shadowrocket, and download it again. If you see a purchase button, first check that you're using the original account and viewing the correct product page before considering another payment. Restoring the app and restoring connection details are separate tasks. After reinstalling, check that your server details, configuration files, and sync status are all in place.
Client purchase ≠ connection plan
Getting Shadowrocket gives you the client; it doesn't automatically provide a remote server, subscription quota, or network service. This site doesn't provide, sell, or recommend nodes or subscriptions. Import and connection instructions assume you already have your own subscription or server details. Confirm the validity period, access rights, and service status of those details with their original provider.
So if there's no server entry after purchase, that doesn't mean the purchase record is missing. First make sure you have connection details to import, then follow the guide to add them. A successful subscription update only means content was retrieved; it doesn't mean every server in it will work on your current network. Record and assess client issues, data-format issues, and remote service issues separately.
Other platforms and first launch
Mac has separate Apple silicon and Intel versions, while Windows, Android, and Linux each have their own installation formats. Choose the file for your device, then follow the installation instructions on the download page. When a system displays a security prompt, confirm the source first. “Privacy & Security” on Mac, SmartScreen on Windows, Android installation permissions, and Linux execution permissions are different mechanisms; don't apply the same steps to all of them.
These installers aren't code-signed, so you may see a system prompt on first launch. The download page explains how to allow an app after checking its source, and lists the installation steps for Linux formats. If you don't understand a prompt, keep its exact wording and check the relevant section for your system. Don't disable system-wide protection just to open one file.
Update the app and subscription separately
App Store manages app updates on iPhone / iPad. For other platforms, get the updated installer from this site's download page and keep a copy of your configuration before proceeding. Subscribe updates server details from an existing subscription, while Config changes rules or settings; neither updates the app. If something stops working “after an update,” first identify what was updated and then compare what changed.
The download list displays the current version dynamically; the download page is the reference for available files. When a configuration changes, keeping a copy of the previous version and the steps needed to reproduce the issue is more useful for troubleshooting than noting a version name alone. For more store information, see the App Store guide. For connection issues, use the relevant category in Frequently asked questions.
§ 05Article previews
Read about your current issue. Purchase restoration, device selection, and first-time installation.
After getting a new iPhone or reinstalling the system, first confirm that the App Store is signed in to the original purchase account, then find the purchase record. This article distinguishes redownloading the app from restoring configuration details, and explains what to check if a purchase button appears so you don't mistake an account mismatch for a failed purchase.
Check About This Mac to identify Apple silicon or Intel before choosing a Mac installer. Windows users should check their system and installer. This article explains first-launch prompts for each system and how to proceed after confirming the file came from this site, without confusing prompts from different systems.
Check store availability, developer, official icon, and app ID in order, then review the checkout page. Pricing has two options: a one-time $2.99 App Store purchase for iPhone / iPad; Mac, Windows, Android, and Linux versions are free. This article focuses on purchasing and troubleshooting downloads for the former.