All platforms · Official manual

Shadowrocket setup and rule-based routing guide

Rule-based proxy client for all platforms: connect using an existing subscription and route traffic according to rules. iPhone / iPad: $2.99 one-time in the App Store; Mac, Windows, Android, and Linux versions are free.

Current version Loading · Mac, Windows, Android, and Linux versions are free

First connection: import, choose a mode, verify

First, make sure you have a usable subscription or server details, then follow the steps in order. A successful import means the information was saved; it does not mean a connection has been established.

  1. Step 01 · Prepare connection details

    Add Server / Subscribe

    Get your subscription link from your service provider. In Home, open Add Server and import an existing subscription. To add a server manually, select the Type that matches the actual server details, then enter Host, Port, and authentication fields. Check for spaces before and after the link; after saving, verify the SERVER group and entry name. Do not mistake a configuration file URL for a server subscription.

  2. Step 02 · Choose how traffic is handled

    Global Routing

    For everyday rule-based use, select Config and confirm that the expected configuration is enabled. Proxy sends eligible traffic through the selected proxy; Direct uses a direct connection. These two modes are useful for comparison when troubleshooting. Mode and server are separate choices: changing the server does not automatically change the rules in use.

  3. Step 03 · Check the result

    Connection switch / Connectivity Test

    Select a server and turn on the connection switch. The first time, follow the system prompt to allow adding a VPN configuration. Then run Connectivity Test and visit the target you want to test; use Data and connection logs to verify the route. If it fails, check the local network, subscription validity, server parameters, and current mode in order. Change one item at a time to isolate the cause.

View the full guide →

Feature index

From connection settings to rule verification

The server determines where to connect, the configuration determines how traffic is routed, and diagnostic records help verify the actual result. Identify these three layers before making changes so you can troubleshoot without rebuilding all settings at once.

Rule: route traffic based on the first match

Edit Rule in Config to route traffic by domain, keyword, or destination network using PROXY, DIRECT, or REJECT. Rules are checked from top to bottom; the first match determines the policy. Put specific exceptions before broader rules and place FINAL at the end as a fallback. In this example, example.com and its subdomains use PROXY, while the local network range uses DIRECT. After saving and enabling the configuration, set Global Routing to Config and check the matching rule in connection logs. Do not rely only on whether a webpage opens to determine if routing is correct.

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY
See rule types, priority, and configuration structure →

Change configuration one layer at a time

First get an existing server working with a manual connection, then enable rule-based routing, and finally adjust On Demand and sync. This order helps separate parameter errors, rule errors, and automatic connection conditions. If an imported configuration changes DNS or other network settings, keep the original configuration for comparison. Do not make replacing the entire configuration your first troubleshooting step.

The same protocol name does not mean all parameters are interchangeable. Match ports, authentication methods, and transport settings against your existing server details. If only some entries fail after a subscription update, check those entries individually instead of deleting other working groups. Example domains in rules are for explaining matching behavior only; they are not usable server details.

2 ways to get it

Choose how to get Shadowrocket for your device

iPhone / iPad: $2.99 one-time in the App Store; Mac, Windows, Android, and Linux versions are free. Desktop and Android installers are available from this site's download page under /dl/. Check your system and processor before choosing a file.

iPhone / iPad

App Store $2.99 one-time · Free on other platforms

Check the icon, developer, and app ID on the App Store product page before purchasing. System requirements are as listed on the App Store page. Both devices share the same purchase record. When changing devices, first check whether the current store account is the one used for the original purchase. The download page also explains store availability and how to restore a purchase.

Mac

Free · Apple Silicon / Intel

Open About This Mac to check the processor, then choose the Apple Silicon or Intel version. Separate installers are provided for each. If the first launch says the developer cannot be verified, confirm the file came from this site, then follow the download page steps in Privacy & Security. Do not determine the source from the filename alone.

Windows

Free · 64-bit installer

Get the Windows version from the download page, then run the installer. If SmartScreen displays a warning, first check the download source. After confirming the file came from this site, select More info → Run anyway to continue. Once installed, import your existing server details and check the current network and configuration before connecting.

Android

Free · arm64 apk

Open this site's download page in your system browser to get the installer. In system settings, allow that browser to install unknown apps; you can revoke permission after installation if needed. If the in-app browser in WeChat cannot download the file, open the original page in your system browser. On the first connection, follow the system prompt to approve VPN permission.

Linux

Free · deb / rpm / AppImage

Choose deb, rpm, or AppImage for your distribution; there is no need to try every format. AppImage requires execute permission before its first run. The download page lists package installation methods and commands. Check your system architecture before running it. If a permission issue occurs, read the specific prompt before changing the file or system settings.

Installation permissions and system network handling can vary by platform. An existing subscription can provide connection details, but another device's connection status, system permissions, or local file paths should not be assumed to sync. After changing devices, complete all three steps: import, choose a mode, and verify.

See all platforms →
App verification and usage scope

Verify the app before configuring a connection

This is the official Shadowrocket website and manual. When checking the app, confirm the Shadowrocket product name, official icon, and store details instead of relying on similar names in search results.

  • Developer: Shadow Launch Technology Limited
  • App ID 932747118
  • iPhone / iPad $2.99 one-time · Free on other platforms

Check the developer, icon, and app ID together

On the App Store product page, check the developer, Shadow Launch Technology Limited, along with the official icon and app ID 932747118. The official icon is a rocket outlined in blue and purple on a white background; the icon shown in the page header is the same one. Similar search terms, icon colors, or names are no substitute for checking all three details. Open the full product page rather than relying on a short search result.

Store availability depends on account region

If the app does not appear in the mainland China App Store search results, first check the store country or region for your current Apple ID. Device language and store region are separate settings. Follow Apple's official process if changing your account region, and first address requirements such as account balance, existing subscriptions, and payment details. Availability, local currency pricing, and system requirements are as shown on the App Store page; changing your device language repeatedly is not a reliable way to check.

Purchase records and connection details are separate

The iPhone / iPad version costs $2.99 as a one-time App Store purchase, shared across both devices. The Mac, Windows, Android, and Linux versions are free. After reinstalling or changing devices, check your purchased items with the original purchase account before downloading again. Restoring the app does not guarantee that subscriptions, manually entered server details, and local configurations are restored too. Save recoverable configurations and existing subscription details separately before deleting the app.

A one-time app purchase is not a service plan

Purchasing the client grants the right to use the app; it does not include servers, data allowances, or a connection service. This site does not provide, sell, or recommend nodes or subscriptions. Get subscription links from your service provider; for manual setup, use server details you already have. Whether a connection succeeds also depends on your local network, server status, and authentication parameters. A successful app purchase does not mean every destination is reachable.

Subscription links may contain access credentials, so take care when copying, capturing, or sharing them. When requesting troubleshooting help, you can describe the platform, Global Routing mode, point of failure, and system prompt, but do not disclose a complete subscription, password, or authentication details. Example addresses such as example.com in rule examples explain syntax and matching only; do not import them as actual connection details.

Check update methods for each platform

Shadowrocket is a closed-source commercial app. Manage downloads and updates for the iPhone / iPad version through the App Store. Get Mac, Windows, Android, and Linux installers from this site's download page; installer addresses are under /dl/ on this site. Save your configuration before upgrading, then check the selected server, active configuration, and connection permissions. Follow the download page instructions for desktop or Android system warnings; do not leave system protection disabled long-term for a single installation.

For first-time use, start with a basic configuration you can verify, then add domain exceptions, direct routes for the local network, and on-demand conditions one at a time. When something goes wrong, identify whether it is an installation, subscription import, connection, or rule-matching issue, then check the relevant section. This layered approach makes it easier to preserve working settings and reproduce problems than changing protocols, DNS, and all rules at once.

Article highlights

Protocols, subscriptions, and traffic statistics

After your first connection, read further details as needed. Understand each field and the scope of its statistics before changing settings. Change one condition at a time and keep the original configuration for comparison.

View all articles →