Cross-platform client · Official manual

Shadowrocket
Rule Configuration and Setup Guide

Cross-platform rule-based proxy client for routing traffic with your existing subscription. iPhone / iPad: $2.99 once in the App Store; Mac, Windows, Android, and Linux: free.

Current version Loading · iPhone / iPad: $2.99 once; Mac, Windows, Android, and Linux: free

Choose a platform

Choose a device to see its acquisition and first-launch steps. iPhone / iPad: $2.99 once in the App Store; Mac, Windows, Android, and Linux: free. Desktop and Android packages are available through this site's download guide; no mobile purchase is needed for these platforms.

iPhone / iPad

$2.99 once in the App Store; other platforms are free. One purchase covers both devices, and system requirements are listed on the App Store page. Check the developer and app ID before purchasing, and use your own purchasing account. Previous buyers can find the app in Purchased under the same account.

Store and purchase-restoration details

Mac

Free · Apple Silicon / Intel; iPhone / iPad: $2.99 once in the App Store. Check About This Mac for your chip or processor. The download guide offers separate, equivalent options for both architectures; do not guess based on the computer's appearance. Keep a copy of existing files before migrating your configuration.

Choose a Mac version

Windows

Free; iPhone / iPad: $2.99 once in the App Store. The download guide provides a 64-bit installer. Have your existing server details ready before connecting. Check for other system settings that may be controlling network traffic, so a system proxy or DNS conflict is not mistaken for a server failure.

Windows download guide

Android

Free · arm64; iPhone / iPad: $2.99 once in the App Store. Open the download guide in your system browser and follow the prompts to grant permission. Confirm the system VPN request when connecting for the first time. If the connection drops in the background, check battery optimization and background activity settings.

Android acquisition guide

Linux

Free · deb / rpm / AppImage; iPhone / iPad: $2.99 once in the App Store. Choose a package format for your distribution and check the processor architecture. The package format determines how to obtain and run the app, not how to configure the network; after importing, check the server parameters, current policy, and DNS.

Choose a package format by distribution
All platforms →

Rule matching order

Rule determines which policy handles a request. Open the current configuration in Config and inspect its Rule section. Requests are checked from top to bottom; the first matching rule takes effect, and later rules are not checked, even if they appear more specific. Put narrower domain or network ranges first, broader conditions later, and FINAL last. Keep a copy before editing, change only a few rules at a time, then check the actual matches. The example domain shows the format and is not a server address. Keyword matching can cover a broad range, so watch for unintended blocks.

  • DOMAIN-SUFFIX: matches a domain and its subdomains.
  • PROXY / DIRECT / REJECT: sets the handling policy.
  • FINAL: use only as the fallback.
Rule syntax reference
[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
Authenticity and facts

Check three details before getting the app

Shadowrocket is a closed-source commercial application. This is the official website and manual. For mobile app identification, check the developer name, official icon, and app ID in the store. Get desktop and Android packages through this site's download guide.

Official Shadowrocket app icon
Shadowrocket

App Store app ID 932747118

Developer
Shadow Launch Technology Limited

Two acquisition options: iPhone / iPad $2.99 once; Mac, Windows, Android, and Linux free.

Developer and app ID

On the App Store product page, confirm that the app is named Shadowrocket and that the developer is Shadow Launch Technology Limited. Its icon should match the official icon shown here, and the app ID in the product page URL is 932747118. Do not rely only on translated names, search-result order, or similar-looking icons. A free listing with the same name is not a substitute for this product. iPhone / iPad costs $2.99 once; Mac, Windows, Android, and Linux are free.

Store region and system requirements

This app is currently unavailable in the mainland China App Store. If it does not appear in search, first check the country or region for your Apple ID used for Media & Purchases rather than repeatedly changing the search spelling. Region and interface language are separate settings. Before changing the region, review the balance, subscription, and payment method requirements in your account settings. Check the App Store page for the iPhone / iPad system requirements before purchasing.

Purchases and restoring on a new device

The iPhone / iPad version costs $2.99 once in the App Store, and one purchase covers both devices. Mac, Windows, Android, and Linux versions are free. After moving to a new mobile device or reinstalling, use the account that made the original purchase to find Shadowrocket under Purchased in the App Store. If the page still shows a price, check the account and purchase history before taking further action. App purchase records and local configurations are managed separately; restoring the app does not necessarily restore subscriptions, rules, or personal changes.

Manage the client and service separately

Buying the client does not include a service plan. Getting Shadowrocket provides the right to use the client or obtain the software; it does not include servers, remote traffic, or a service period. This site does not provide, sell, or recommend nodes or subscriptions. Configuration requires your own existing subscription or server details; get subscription links from your service provider. If a link has expired, authentication fails, or a remote quota is insufficient, check your existing service details rather than assuming the client must be purchased again.

Desktop and Android availability

Mac, Windows, Android, and Linux versions are free; iPhone / iPad costs $2.99 once in the App Store. Desktop and Android packages are available only through this site's /dl/shadowrocket/ path, with the download guide linking to the relevant files. Mac packages are available for Apple Silicon and Intel. On Linux, choose deb, rpm, or AppImage according to your distribution. The home page helps you choose a device rather than listing installation packages, so you can review architecture, first-launch, and system permission requirements before downloading.

App updates and configuration backups

Manage iPhone / iPad app updates in the App Store; desktop and Android users can get updated packages from the download guide. Before updating, keep a copy of your current configuration, note the Global Routing mode and selected server, and confirm that your backup includes your custom rules. App updates, subscription updates, and iCloud sync are separate processes: the first replaces the app, subscription updates read remote content again, and sync transfers data between eligible devices. Success in one process does not mean the others are complete.

Checks to make before connecting

First confirm that the device itself is online. Then check that your existing subscription can refresh, that the current server parameters are complete, and that Global Routing suits your needs. For initial verification, connect manually and test one clear target before enabling more complex routing rules and On Demand. If you change the server, DNS, and rule file at the same time, it is difficult to identify what restored the connection. Change one item at a time and record the results to make troubleshooting repeatable.

The following questions concern different parts of the setup. Identifying the terms first can prevent repeated or unnecessary changes. See the getting started guide for complete steps, and the glossary for definitions of rule conditions and policies.

Why select Config after adding a server?

A server entry specifies where to connect; Config determines which rules handle requests. Importing a server does not confirm that the current rules are active, so check which configuration is in use. See the glossary to distinguish Config from Global Routing, then verify the setup using the getting started steps.

What is the difference between direct and global modes?

In Global Routing, Direct is the direct mode, Proxy is the proxy mode, and Config routes traffic according to the configuration's rules. “Global mode” usually refers to Proxy; it does not mean changing every Rule to PROXY. Restore your original selection after troubleshooting. See the glossary for interface terms.

Why won't webpages load if latency is normal?

A latency test covers only part of the connection. Web access also depends on domain resolution, rule matching, protocol negotiation, and the destination service's response. Confirm that the test uses the same server entry as the current selection, then check DNS and the error details. Follow the DNS troubleshooting guide and avoid deleting the entire configuration based only on a test result.

Why did my changes disappear after a successful subscription update?

A subscription entry is regenerated from remote content, so temporary changes may be overwritten during refresh. Separate subscription-managed content from your own maintained configuration copy before deciding where to edit. Make a backup before updating and check the structure in the rule reference to avoid adding rules in the wrong section.

Configuration and troubleshooting articles

Choose an article for the issue at hand; there is no need to change every setting at once. Import guides explain how content enters the client, DNS troubleshooting helps locate resolution issues, and rule priority explains why requests follow a particular policy. Keep the original configuration before each change and retest the same target afterward to compare results.

Advanced Rules

Writing custom Shadowrocket rules

Top-to-bottom matching, FINAL fallback, and PROXY / DIRECT / REJECT are the starting points for understanding routing. This article uses real rule snippets to explain how conditions, content, and policies work together, including why a broad earlier condition can override a more specific later rule. For users who can connect but find that some domains are not routed as expected.

Read about rule priority
Troubleshooting

Webpages won't load: DNS troubleshooting

If Connectivity Test works but webpages do not load, check resolution failures separately from connection failures. This article checks DNS, the current configuration, and the request path in a repeatable order, and explains relevant settings in the General section. Locate the failing step before changing the corresponding option; not every issue is caused by server latency.

Read the DNS check steps
Getting Started

Four ways to add a subscription

Compare four options: Subscribe, manual entry through Add Server, QR scanning, and clipboard detection. First identify whether your existing content is a subscription, a single node, or a configuration file, then choose the corresponding method. The article also explains which fields to check after import. Examples are for format reference; get actual subscription links from your service provider.

Read about import options
All articles →