Official site · Official guide

Shadowrocket Rule-Based Routing Guide

A rule-based proxy client for all platforms, with support for rule-based routing and multiple protocols. iPhone / iPad: $2.99 one-time via the App Store; Mac, Windows, Android and Linux: free.

Current version Loading · iPhone / iPad: $2.99 one-time via the App Store; Mac, Windows, Android and Linux: free.

First-time setup: start by importing an existing subscription →

VLESS Trojan WireGuard Global Routing: Config
  • Rules are matched in order
  • Import an existing configuration
  • Connection and DNS diagnostics

[Download]2 ways to get the app

Choose how to get the app by device

iPhone / iPad: $2.99 one-time via the App Store; Mac, Windows, Android and Linux: free. Each link below opens the relevant platform section on the download page. Check your device first, then choose the appropriate installation file.

Getting the files and first launch

Desktop and Android installation files are provided through the site’s /dl/shadowrocket/ path. Apple Silicon and Intel Macs require different files; the same file format does not mean the same architecture. Check the system type for Windows, and confirm which package manager your Linux distribution uses. Device detection prioritizes a suitable option, but your device’s own system information remains the reference.

Desktop and Android installation files are unsigned, so the system may block the first launch. On Windows, after confirming the file came from this site, select “More info” and “Run anyway” in SmartScreen. On Mac, confirm “Open Anyway” under “Privacy & Security.” On Android, allow the browser that downloaded the file to “Install unknown apps.” AppImage files on Linux need execute permission. If the prompt differs, check the installation guidance on the download page instead of repeatedly downloading the file.

What to prepare after installation

Installing the client and establishing a working connection are separate steps. Before configuring it for the first time, prepare a subscription link you already have or the complete server address, port and authentication details. The app alone does not provide these connection parameters. If you do not yet have your own configuration, you can first read the interface and rules guides; do not treat example domains as actual service addresses.

The download page covers store access, platform file selection and system permissions. The getting-started guide begins with importing an existing configuration. Checking these separately helps identify whether an issue occurs during system installation or client connection: for the former, check system prompts; for the latter, check server parameters, the current policy and logs.

[Rule]

Connections, routing and configuration

First understand how requests select a policy, then adjust connection conditions. These six references cover rules, On Demand connections, protocol parameters, existing subscriptions, configuration files and diagnostics—settings from different layers should not be treated as one switch.

[Rule]

Policies follow rule order

Rule-based routing lets different requests take different paths. In Home, set Global Routing to Config. The client then checks rules in the active configuration in order, and the first match determines the policy. DOMAIN-SUFFIX matches domain suffixes, IP-CIDR matches IP ranges, and FINAL handles requests not matched by earlier rules. Before editing, save a copy of the original file. Place more specific entries before broader ones, then check matches against real requests. The following is a syntax example, not a usable server configuration.

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

See explanations of rule keywords →

Global Routing: check the current mode first

Config handles requests according to the active file’s rules; Proxy sends applicable requests to the current proxy policy; Direct uses a direct connection. Temporarily changing the mode while troubleshooting can help determine whether an issue relates to rules, but restore your preferred mode after testing. Do not assume that a destination working in Proxy means every rule in Config is correct, or that testing in Direct has verified the server connection. For more settings, see the Settings reference.

[Verify]

Product verification and prerequisites

Shadowrocket is a closed-source commercial app. This is the official site and guide. Verify the access channel, purchase record and connection configuration separately. The icon, developer and app ID help identify the product; they do not replace checking service parameters.

Shadow Launch Technology Limited App ID 932747118 iPhone / iPad: $2.99 one-time · Other platforms: free

[Identity]

Check three details in the store

On the product page for iPhone or iPad, first confirm the app name is Shadowrocket, then check the developer, Shadow Launch Technology Limited, the official icon and app ID 932747118. The icon should match the official icon used in this site’s header. You can identify the app ID at the end of the product page URL. A name or similar image in search results alone is not enough to verify the product.

Opening the designated App Store product page from this site’s download page is more reliable than repeatedly searching by a nickname. Search for the exact name Shadowrocket. If the developer and app ID do not match the details here, return to the product page and check again. Do not treat descriptions of other listings as information about Shadowrocket.

[Store]

Your store region affects app availability

The App Store displays apps by country or region. If Shadowrocket does not appear in the mainland China store, first check the store region for your current Apple ID. Device language, system region and the account’s media and purchases region are separate settings. Changing your phone’s language to English does not automatically change which apps are available in your store.

Open your Apple ID, Media & Purchases settings to check the country or region. Before changing regions, read the system’s information about your balance, existing subscriptions and payment methods, then proceed according to your circumstances. If the product page still will not open, first check the purchase account and store region; do not mistake a store availability issue for a client connection problem. Check the App Store page for iPhone / iPad system requirements.

[Purchase]

One-time purchase and restoring on a device

The iPhone / iPad version costs $2.99 one-time in the US App Store, and one purchase covers both devices. The Mac, Windows, Android and Linux versions are free. Other storefronts display local currency; refer to the price shown on the purchase page. The purchase is linked to the Apple ID used for the transaction, which may differ from the account you use for other services on your phone.

When changing devices or reinstalling, sign in to the original purchase account and find Shadowrocket in the App Store’s purchased items. If the page still asks you to buy it, check the account, purchase record and current storefront rather than immediately making another purchase. Reinstalling restores the client app, but does not guarantee that your existing subscription links, server passwords and custom rules are restored. Check these items individually using your existing backup or sync results.

[Package]

Check the site path for desktop and Android

Access for Mac, Windows, Android and Linux is available from this site’s download page. Installation files are provided through the site’s /dl/shadowrocket/ path. Similar page titles or filenames do not mean that files come from the same source. When choosing a file, check the platform, processor architecture and file format. Device detection is convenient, but does not replace checking your device information.

If the system blocks an installation, first confirm the file source, then follow the relevant steps on the download page. For Mac, check the chip in “About This Mac”; for Windows, check the system type; for Android, make sure the installation permission is granted to the browser currently used; for Linux, check the package format and execution permissions. On managed devices, permissions may be controlled by an administrator. Do not assume a restriction means the installation file is damaged, or change system security settings indiscriminately.

[Connection]

Existing service details determine connectivity

A server connection requires a matching address, port, protocol and authentication parameters. A subscription link can import these details in bulk, but the link itself must be complete and valid. After importing, confirm that the expected entries appear in the list, then test a known working entry. Seeing a name in the list means its contents were read; it does not mean the server is currently reachable.

When adding a server manually, compare each field with your own server details. Note that Host and SNI serve different purposes, and a port cannot be inferred from the protocol name alone. QR codes and share links are only ways to transfer parameters; still check the protocol type and transport settings. example.com in examples illustrates syntax and is not a connection address provided by this site. Understand any instructional rules before applying them to your own configuration.

[Update]

Apps, subscriptions and rules update separately

An app update changes the client software, a subscription update refreshes the server entries it manages, and a configuration update may change rules or DNS settings. These are not equivalent: updating the app does not mean your server parameters changed, and updating a subscription does not mean the active Config switched to another file. When something changes, first identify which type of operation you most recently performed.

Manage iPhone / iPad app updates through the App Store. For desktop and Android, get the installation file for the relevant platform again from this site’s download page. Before updating, keep a copy of any configuration you need. After updating, check the active server, Global Routing and selected Config, then test the connection. The homepage’s dynamic version field only displays the retrieved result; refer to the download page for the installation files and platform options actually available.

[Backup]

Check what your backup includes before migrating

Before changing devices, check configuration files, subscription links, manually added servers and app settings separately. Exporting a single Config file may not include all server authentication details; saving only a server share link cannot replace a copy of your custom rules. List what you need to migrate first, then check what the exported files actually contain to avoid missing items on the new device.

For iCloud sync, check the system account, cloud permissions and in-app switch, then wait for sync and verify each item on the other device. After restoring, test one server and one clearly defined destination before enabling complex rules and On Demand. Backup files may contain passwords or subscription credentials; store them somewhere you control. When asking for help, do not share the entire configuration file publicly.

[Check]

Record connection failures by layer

First confirm that the device itself can access the network, then check that the subscription updates and server parameters are complete, and finally inspect rules and DNS. If every destination fails, start with the basic network and server connection. If only one domain fails, compare its current policy, resolution result and rule match. Change one condition at a time to identify which adjustment affects the result.

A successful Connectivity Test and a successful request to the actual destination are not the same conclusion. Changes in Data traffic are only supporting information. Record the network type, selected server, Global Routing, error time and a redacted log; this is more useful than simply saying “it won’t open.” For detailed steps, see Frequently asked questions. If an interface term is unclear, check the glossary, then follow the quick start guide to run a reproducible test.

[Reference]

Configuration and access guides

Continue with the guide that matches your task: check backup coverage before changing devices, check your store region if you cannot find the app, or identify the protocol used by your existing server before importing it. These guides retain interface terms in their original form for easier reference.