Shadowrocket Official Guide

ShadowrocketSetup & Downloads

A rule-based proxy client for all platforms for importing existing subscriptions and setting up rule-based routing. iPhone / iPad: $2.99 once on the App Store; Mac, Windows, Android, and Linux: free.

Current version · iPhone / iPad: $2.99 once on the App Store; Mac, Windows, Android, and Linux: free

Official Shadowrocket Home interface showing the connection switch, Global Routing, and SERVER group
Shadowrocket · Official Home interface

Shadowrocket

Check your device and installation method

iPhone / iPad: $2.99 once on the App Store; Mac, Windows, Android, and Linux: free. Desktop and Android packages are available from this site's download page under /dl/shadowrocket/. Buying the client does not include a service subscription. Before setup, have your existing subscription or server details ready.

iPhone / iPad

$2.99 once on the App Store. Use the same purchasing account to restore access on both devices. Check the App Store page for system requirements. On the product page, verify the developer and app ID before purchasing.

Mac

Free · Apple Silicon / Intel. In the Apple menu, open “About This Mac” to check the chip or processor name, then choose the matching installer. If macOS blocks the first launch, follow the “Privacy & Security” instructions on the download page.

Windows

Free. The download page provides a 64-bit installer. Confirm that the file is from this site before opening it. If SmartScreen appears, check the source first, then follow “More info → Run anyway” to continue.

Android

Free. The download page provides an arm64 package. If Android asks you to allow installation from unknown apps, grant the permission only to the browser used for this download. Review the permission in system settings after installation.

Linux

Free · deb / rpm / AppImage. Choose a package format that matches your distribution's package manager. AppImage files need execute permission before use. The download page lists the relevant commands and installation requirements; don't pass other formats directly to a package manager.

The five options above are versions of the same product for different platforms. When switching devices, check the installation format again. Whether an existing subscription works also depends on its contents, protocol parameters, and support in the current version on that platform. Installing the app does not configure a server; import your own details before connecting for the first time.

DOMAIN-SUFFIX

Rules, connection conditions, and configuration

First distinguish where a connection goes from which connections should use a proxy. Server details determine the available outbound connection, Global Routing determines how traffic is handled, and rules in Config determine the matching order. The sections below explain where to find settings for common tasks; the actual interface may vary by device.

Config matches rules in order

After selecting Config under Global Routing on Home, connections are handled according to the current configuration. DOMAIN-SUFFIX matches domain suffixes, GEOIP checks the region associated with the destination IP, and FINAL handles connections that did not match earlier rules. Rules are generally checked from top to bottom, so more specific conditions should come before broader ones. Understand the difference between PROXY, DIRECT, and REJECT results. A selected server alone does not guarantee that a request uses the proxy. After making changes, check the connection log to see which rule actually matched.

Global Routing and routing rules
DOMAIN-SUFFIX,example.com,PROXY
FINAL,DIRECT

Three Global Routing options

Choose Config for everyday rule-based routing, Proxy to temporarily check the proxy's outbound connection, or Direct to compare with a local direct connection. Proxy here is an interface option; PROXY in a rule is a processing result. After troubleshooting, restore the previous mode and confirm that the active configuration file and selected server have not also changed.

Subscription updates, configuration updates, and app updates are separate actions: a subscription update changes the server list, a configuration update may change rules and DNS settings, and an app update replaces the client. When something changes, identify which update occurred before testing again. Don't assume every issue means a “server needs refreshing.”

Subscribe

Three checks for your first connection

The steps below use the iPhone / iPad interface as a reference. First establish a connection you can verify, then configure automatic connections, refine rules, and sync settings. On other platforms, follow the options shown in the actual interface.

Add Server: import existing details

Open Add Server from Home. If you have a subscription, select Subscribe, paste the full URL, save, and update. If you have details for one server, choose its Type first, then enter Host, Port, and authentication parameters.

After saving, return to the SERVER group and confirm that the entry appears and is selected. The name is only a label; the protocol and connection fields determine how it connects. Don't rely on the display name to confirm an import.

Global Routing: choose how traffic is handled

Open Global Routing, select Config if you already have routing rules, then check which file is active in Config. For temporary troubleshooting, compare Proxy and Direct, but note the original selection.

If the same server behaves differently across websites, check rules and DNS before changing authentication details. When a rule specifies DIRECT, selecting a proxy server will not automatically route that request through PROXY.

Home: connect and verify

Return to Home and turn on the connection switch. On first use, follow the system prompt to approve the VPN configuration. Check the connection status, run Connectivity Test, and open a familiar webpage to verify access.

If the test and webpage results differ, keep the error message and check the local network, server reachability, DNS, and rules separately. Seeing the switch turned on does not verify that a real request succeeded.

Check that you have complete connection details first. The client does not include servers. This site does not provide, sell, or recommend servers or subscriptions; the guide explains how to use information you already have. If a subscription update fails, first check that the URL is complete and its access credentials are valid, then check whether the update request can reach the destination.

App Store

Verify the app, restore purchases, and understand usage

Shadowrocket is a closed-source commercial app. Verify the product using the developer name, official app icon, and app ID. Similar names, search ranking, and promotional descriptions are not substitutes for the product page.

  • Developer Shadow Launch Technology Limited
  • App ID 932747118
  • Two ways to get the app

Check each detail on the product page

Open the Shadowrocket product page in the iPhone / iPad App Store and verify that the developer is Shadow Launch Technology Limited, then check the official app icon. The app ID in the product page URL should be 932747118. The nickname “Shadowrocket” or a search result title alone cannot verify the app. Check the App Store page for system requirements, and confirm your device meets them before purchasing.

Desktop and Android users should choose their platform from this site's download page. Package URLs are under /dl/shadowrocket/. If a system security prompt appears on first launch, check the download source and file type, then follow the platform-specific steps on the download page. Disabling all system security protections should not be a standard installation step.

Store region affects app availability

App Store search results depend on the region of the account used for the store, not directly on the device language. If the app does not appear in the mainland China store, check the current account and “Country/Region” under “Media & Purchases” in system settings, and confirm which storefront is used to open the product page. Changing the device language does not change the storefront. Follow Apple's displayed requirements and prompts when changing an account's region.

If the product page opens but the download button is unavailable, check system compatibility, account prompts, network connection, and payment status in that order. Avoid repeatedly signing out or changing regions just to test. Reading the specific error message usually makes it easier to decide what to do next.

Purchases, device changes, and previously purchased apps

The iPhone / iPad version costs $2.99 once on the App Store. The same purchasing account can restore access on both devices; the Mac, Windows, Android, and Linux versions are free. Prices may appear in local currency on different storefronts. The product page and purchase confirmation show the final amount. A one-time client purchase covers how you get the app, not how long an external server is available.

When changing devices or reinstalling, sign in to the App Store with the original purchasing account, find Shadowrocket in your purchased apps, and download it again. If the page still shows a price, check the account, storefront, and original purchase history. Family Sharing availability depends on the terms shown on the product page and in Family settings at the time; an app installed on another device does not by itself confirm a purchase in your current account.

Manage the client and server service separately

Buying the client does not include a service subscription. The app reads configuration, establishes connections, and applies routing rules. Server addresses, subscription validity, and access credentials depend on the information you already have. The app can open normally even if a subscription has expired, and a successful subscription update does not mean every server is currently reachable. Check client settings and server details separately rather than treating them as one issue.

Manage iPhone / iPad app updates through the App Store. For other platforms, get updates from this site's download page. Before updating, keep a backup of any configuration you need. Afterward, check the selected server, Global Routing, and active file, then test the connection. Updating the app does not update a subscription, and restoring the app does not necessarily restore all local configuration.

Global Routing

Continue with a topic

After completing the basic steps, find an article for the issue you're seeing. Identifying whether the problem involves importing, mode selection, or DNS helps avoid unnecessary parameter changes.