Official Manualrouting & config

ShadowrocketSetup & Routing

Cross-platform rule-based proxy client. Import existing subscriptions and route traffic according to your configuration. iPhone / iPad: $2.99 one-time in the App Store; other platforms are free.

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

ConfigShadowsocksWireGuard

Get the app by device

get

Check your device first, then choose how to get the app. iPhone / iPad costs $2.99 once in the App Store; Mac, Windows, Android and Linux versions are free. Desktop and Android installation packages are available on this site's download page under /dl/shadowrocket/. The platform links prioritize your current device, while letting you select another device directly.

iPhone / iPad

App Store $2.99 once · Other platforms are free

Manage existing subscriptions, choose Global Routing and check connections on a phone or tablet. Both devices can restore the app using the same purchasing account. Check the App Store listing for system requirements. When connecting for the first time, allow the VPN configuration when prompted by the system, then return to Home to check the status.

See App Store instructions →

Mac

Free · Apple Silicon / Intel

Available for both Apple Silicon and Intel. Check your chip or processor in About This Mac, then choose the matching package on the download page; do not infer the hardware from the computer's appearance. If a developer verification prompt appears on first launch, confirm the file came from this site, then follow the download page's Privacy & Security instructions to allow it.

Choose a Mac version →

Windows

Free · 64-bit installer

Import existing server details and configuration files on your PC. If SmartScreen appears after downloading, verify the source, select More info, then select Run anyway. See the download page's installation section for full instructions. When diagnosing a connection, check the local network, server reachability and rule matches separately instead of changing several settings at once.

See Windows download instructions →

Android

Free · arm64 package

Use the arm64 package provided on this site. When Android asks for installation permission, enable Allow from this source only for the browser or file manager used for this download. You can turn it off after installation. If an in-app browser blocks the download, open the download page in your system browser and continue from there.

See Android download instructions →

Linux

Free · deb / rpm / AppImage

Choose a format based on your distribution's package management: use deb or rpm with the system package manager, or choose AppImage. AppImage requires execution permission before it can run. The download page lists installation commands and permission instructions. Keep a copy of the original file before importing a configuration to make differences easier to identify.

Choose a Linux package format →

See all platforms →If the system blocks installation, read the download page's instructions for allowing it.

Connection & rule configuration

rule-set

Top to bottom; stop at the first match

When Global Routing is set to Config, connections are handled by the rules in the active configuration file. DOMAIN-SUFFIX matches a domain and its subdomains; IP-CIDR applies to a specified address range. Put specific rules first and FINAL at the end. PROXY and DIRECT describe what happens after a match; they do not guarantee a successful connection. To troubleshoot, confirm the active configuration first, check rule order next, then observe the actual connection.

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

This is an example of rule syntax; example.com is not a service address. See rule and connection steps →

Verify the app & how to get it

verify
Developer Shadow Launch Technology Limited App ID 932747118 2 ways to get the app App Store purchase / site download
Official Shadowrocket app icon

Check the app name, icon and developer together

Open the product page in the App Store and verify the name Shadowrocket, the official icon shown here and the developer, Shadow Launch Technology Limited. Also confirm that the app ID in the product URL is 932747118. Search results may include similarly named apps, so do not rely on keywords or icon color alone. Check that the developer details and product ID match before purchasing and installing.

Shadowrocket is a closed-source commercial app. iPhone / iPad costs $2.99 once in the App Store; Mac, Windows, Android and Linux versions are free. Getting the app works differently by platform: App Store manages purchases on iPhone and iPad, while desktop and Android installation files are provided on this site's download page. Check the platform before applying a free download method intended for another device to an iPhone / iPad App Store purchase.

store / region

Store availability and account region

App Store availability depends on the storefront associated with the purchasing account. The app is currently unavailable in the mainland China storefront. If it does not appear in search, first check the account region used for Media & Purchases rather than repeatedly changing the device language. Open the Apple Account in system settings, go to Media & Purchases, then check Country/Region in account settings. Before changing regions, review the system guidance on balance, active subscriptions and payment methods.

After opening the product page, use the currency and price displayed by the current storefront for checkout. The listed price is $2.99 once in the US App Store for iPhone / iPad; Mac, Windows, Android and Linux versions are free. Check the App Store listing for system compatibility. If installation fails, first review the device system and store compatibility notices, then troubleshoot network or account issues.

See App Store and region details →
purchase / restore

Purchase history and restoring on a new device

iPhone and iPad can share app purchase history through the same purchasing account. When changing devices or reinstalling, first confirm that the App Store is signed in to the original purchasing account, then find Shadowrocket in purchased items. Restoring the app and restoring its configuration are separate tasks: you can get the app again, but existing subscription URLs, manually added servers and personal settings must be restored from your own backup or service details.

If the store shows a purchase button again, check the signed-in account, storefront and purchase history before considering another payment. Users on computers, Android or Linux can return to this site's download page and select the package for their platform. Keep a copy of your configuration before reinstalling, and note the active file and Global Routing mode to help restore your usual connection setup.

See how to restore a previous purchase →
client / service

App purchase ≠ connectivity service

The client imports server details, establishes connections and applies rules; connectivity services are provided by a service provider you already use or by your own server. Purchasing or downloading the app does not automatically add working servers to the list. Before getting started, prepare your own subscription URL or complete server details, including protocol, server address, port and any required authentication. Some protocols also require transport and TLS parameters.

This site does not provide, sell or recommend nodes or subscriptions; it explains how to import and use your existing configuration. Opening the client, reaching a server and accessing a destination website are separate checks. If a subscription expires or a remote service is unavailable, check the status of your own service; reinstalling the client does not resolve that. App and service charges should be understood and checked separately.

Read about the two price tiers and costs →
package / update

Download sources and future updates

Get installation files for Mac, Windows, Android and Linux from this site's download page. Their URLs are under /dl/shadowrocket/. Check your chip type for Mac and package format for Linux. If the system blocks installation, follow the instructions for that system on the download page. On macOS, check for Open Anyway under Privacy & Security; on Windows, see More info in SmartScreen; on Android, check permission for the current installation source.

App Store manages iPhone / iPad app updates. To update other platforms, return to this site's download page to check the current version and get the package for your device. Keep a copy of your configuration before updating, then check that the active server and configuration file are correct. Version details on the page are read dynamically from the download manifest. If they temporarily show Loading, refresh the download page later rather than relying on version details in an older article.

See installation permission steps for each system →

Before connecting, understand these three settings

before-connect

The server selected on Home determines which existing entry is used for the proxy connection. The active file in Config determines which rules are available. Global Routing determines whether those rules are applied. These settings work together but cannot replace one another. Seeing an entry in the subscription list only confirms that the information was imported; it does not mean the system connection is active or that a rule matched as expected.

Choose Config in Global Routing when connections should follow rules. Proxy sends eligible connections through the selected proxy and can be used as a comparison when troubleshooting; Direct connects directly. After changing modes, start a new test connection, as existing connections may not be rebuilt immediately. To verify the result, use a fixed destination on the same network so you can identify whether the difference comes from the mode, rules or server.

Follow this order from import to verification: prepare existing details, import a subscription or server, select an available entry, confirm the configuration and routing mode, enable the connection, then test access. If a step fails, note the message and check the related settings before continuing. Do not change DNS, protocol and rules all at once before confirming that the server is reachable. See the complete guide or look up field definitions in the glossary.

Common questions topic guides

field-notes

These three guides cover an empty subscription list, Global Routing modes and the two price tiers. Choose the topic that matches the issue, then check each item in order. Always use your own existing details for subscription URLs and server parameters.

See all articles →