Official Manual · All Platforms

Shadowrocket Download & Setup

A rule-based proxy client for all platforms: import your existing configuration, set up rule-based routing and test your connection. iPhone / iPad require a one-time $2.99 purchase on the App Store; Mac, Windows, Android and Linux versions are free.

Current version Loading · iPhone / iPad: $2.99 one-time; Mac, Windows, Android and Linux are free

  • iOS · iPadOS · macOS · Windows · Android · Linux
  • Two access tiers
  • App ID 932747118
  • Shadow Launch Technology Limited
  • Shadowsocks · VMess · VLESS · Trojan · WireGuard · Hysteria2

CAPABILITY / CONFIGURATION

Shadowrocket Features and Setup Sequence

First distinguish whether the server can connect from which route a request should take. The former depends on your existing server details and current network; the latter is determined by Global Routing and Config. The examples below use interface terms from iPhone / iPad. Start with what each feature does, then compare it with your settings. For other platforms, refer to the interface in the app.

Global Routing: Choose a connection mode

Open Global Routing from Home to choose between Config, Proxy and Direct. Config routes traffic according to the rules in the current configuration; Proxy sends intercepted connections through the selected proxy; Direct connects directly. After importing for the first time, use Proxy to check whether the server is available, then switch back to Config to check routing. After changing modes, run a new test request. Do not assume the rules are working just because an old page still opens.

Global Routing → Config / Proxy / Direct

From import to verification: Change one variable at a time

For your first setup, prepare your own subscription link or server details. Save them through Add Server, check the node type and required fields, then select an entry to connect. When the system first asks to add a VPN configuration, confirm that the request came from the Shadowrocket app you just opened, then follow the authorization prompt. A connected status does not mean every request uses a proxy; check the actual route with Global Routing.

To verify the setup, start with a specific access task, then review Connectivity Test, Data and related records. If Proxy works but Config does not, focus on the relationship between rules, DNS and policies. If both modes fail, first check the server details, service status and current network. Change one item at a time and keep the original value and test result. This makes the cause easier to identify than resetting everything at once.

For routine maintenance, follow this sequence: update your existing subscription, check the selected node, confirm the current configuration, and observe actual requests. Data is for monitoring usage on the client side; check your own service details for remaining service allowance. For step-by-step instructions, read Quick Start. For DNS, configuration editing and ongoing troubleshooting, read the Complete Manual.

PLATFORM / TWO ACCESS TIERS

Shadowrocket Downloads for All Platforms

iPhone / iPad require a one-time $2.99 purchase on the App Store; Mac, Windows, Android and Linux versions are free. Choose a device here; the download packages and system installation steps are on the download page. Desktop and Android packages are provided through this site's /dl/shadowrocket/ path. You do not need to guess a download address from a filename.

iPhone / iPad

Get the app from its App Store product page. Check the App Store page for system requirements. Before purchasing, verify the app ID and developer. Both devices share the purchase when using the same purchasing account.

App Store · Verify the product page and restore purchases

$2.99 one-time
Other platforms are free

Mac

Apple Silicon and Intel packages are available. Check your chip in About This Mac before choosing the corresponding option. Both architecture options are shown side by side on the download page.

Download from this site · Choose by chip

Free
Apple Silicon / Intel

Windows

Use the Windows 64-bit installer. After downloading, verify the file source and follow the download page instructions for system prompts. Add your existing connection details after the first launch.

Download from this site · Windows 64-bit

Free

Android

An arm64 package is available. Grant installation permission to the browser or file manager that starts the installation, then revoke it afterward if needed. The first connection also requires confirmation of the system VPN request.

Download from this site · Android arm64

Free

Linux

Choose deb, rpm or AppImage according to your distribution and package manager. Check which format suits your system before following the relevant commands. AppImage files require executable permission before use.

Download from this site · deb / rpm / AppImage

Free
Three package formats

Review system prompts before installing

Desktop and Android packages are not code-signed, so the system may block them on first launch. After confirming the file came from this site's download page, Windows users can choose “More info” in SmartScreen, then select “Run anyway.” If Mac reports that the developer cannot be verified, go to “System Settings → Privacy & Security” and choose “Open Anyway.” If the prompt differs, first check the relevant download page instructions rather than disabling every security option.

On Android, allow installation from the source you are using in the system setting “Install unknown apps.” On Linux, use the package manager or grant executable permission according to the package format. Installing the app and authorizing a VPN connection are separate steps; after installation, import your own configuration. For detailed steps, Mac file attribute instructions and Linux commands, see Installation and system prompts.

IDENTITY / PURCHASE / MAINTENANCE

Verify the App, Restore Purchases and Maintain It

Shadowrocket is a closed-source commercial app. This site is the official website and manual, with access information and operating instructions maintained here. Verify the app using product details rather than relying only on search ranking, similar names or icon colors.

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

App Store: Verify three details

On the iPhone / iPad App Store product page, check the name Shadowrocket, developer Shadow Launch Technology Limited and app ID 932747118, then compare the listing with the official icon shown at the top of this site. The app ID at the end of the product page URL helps distinguish listings with the same name. Seeing only a search result name or thumbnail is not enough to verify the app. Check the App Store page for system requirements, and confirm compatibility on your device before purchasing.

English interface terms such as Home, Config and Settings help locate features in the app; they should not be used alone to verify its identity. If the store listing has a different developer or app ID, stop the purchase process and reopen the product page from the download page. Get the desktop and Android versions from this site's download page, using only packages provided through this site's /dl/shadowrocket/ path.

Store visibility: Check the account's region

The app is generally not searchable in the mainland China App Store. If it does not appear in search, first check the store region for the Apple ID used for “Media & Purchases,” then review age restrictions, account status and device compatibility. The device's system language, physical location and store account region are separate settings. Changing the system language alone will not change which store content is visible.

If you need to change your account region, follow the official account settings process and check requirements for your balance, existing subscriptions and payment information. If you have a previous purchase, check your purchased items first. Being unable to open the product page does not mean the app has been removed from every region. For a detailed troubleshooting sequence, see App Store search troubleshooting checklist. Avoid repeated purchase attempts before checking your account details.

Two price tiers: App purchase and connection service are separate

On the US App Store, the iPhone / iPad version costs $2.99 as a one-time purchase. Other storefronts show local currency; the displayed price on the product page is the actual price. Mac, Windows, Android and Linux versions are free. iPhone and iPad share the purchase under the same purchasing account. When changing devices, first look up the original purchase rather than paying again just because the device type changed.

The client stores connection parameters, applies rules and displays connection records. Remote server availability, subscription validity and server-side usage measurement are separate matters. Updating a subscription reloads the contents of an existing link; it does not renew the service for you. If a connection fails, first distinguish a client configuration issue from a problem with your own service rather than treating the app purchase and connection service as the same thing.

Restore on a new device: Start with the original purchasing account

After changing iPhone / iPad devices or reinstalling the app, first confirm that you are signed in with the Apple ID used for the original purchase. Then find the purchased app in the App Store account page and download it again. The purchase can be restored under the same purchasing account without paying the app fee again. Mac, Windows, Android and Linux versions are free; download the package for the relevant platform again. Store listing names may vary with the system interface, so refer to the current account page.

Downloading the app again and restoring its configuration are separate tasks. Being able to download the app again does not mean locally stored servers, rules and preferences will be restored automatically. Before changing devices, organize a backup of your own configuration. After restoring, check the selected server, Global Routing and Config, then run a connection test. If you use iCloud, check the relevant sync status as well; signing in does not mean all content has been restored.

Updates and backups: Keep a working configuration

Manage app updates for iPhone / iPad through the App Store. For Mac, Windows, Android and Linux, download the package for the relevant platform again from this site's download page. Do not infer the current app version from an article's publication date; the dynamic version field on the page reads download information. Before updating, finish any important tasks and keep a verified working configuration. Afterward, check connection authorization and current settings again.

Subscription links, authentication parameters, configuration files and diagnostic records may contain private information. When asking for help, describe only the failing step, current mode, protocol type and prompt. Hide sensitive fields before sharing screenshots or records. Do not post a complete subscription link in a public discussion. Keep your own backups, especially before deleting node groups, replacing Config or removing duplicate subscriptions.

Selected FAQs

Connected, but a website still will not open. What should I check first?

Note the selected server and Global Routing, then check the request and matched rule separately. If Proxy works but Config does not, focus on rules and DNS. If both fail, check the server details and current network first. Follow the Complete Manual step by step instead of changing multiple settings at once.

Why did the list change after a subscription update, and why should I check my previous selection?

The remote subscription may add, remove or rename entries. After updating, check groups, the selected node and policy references in the configuration, then test a request again. Importing the same link repeatedly will not fix changes to its remote contents. See Managing multiple subscriptions for an organization sequence.

Is the entry with the lowest latency always best for the current task?

Not necessarily. The test method, current network and destination service all affect the result. Latency is one data point, not a measure of throughput or sustained connection performance. Compare results under the same conditions, then test with your own task. For more account, installation and connection questions, see the FAQ.

TECHNICAL NOTES

Shadowrocket Technical Notes

These three articles start with existing connection details and cover list management, test results and protocol fields. Choose one based on your current issue. You do not need to change the protocol, node and configuration all at once to troubleshoot a single problem.

Advanced

Managing Multiple Shadowrocket Subscriptions: Groups, Sorting, Deletion and Duplicate Cleanup

When using multiple existing subscriptions, first identify groups by source, then sort them and remove invalid entries. Learn what to check before deleting and how to review duplicate nodes and the current selection after an update, so you do not accidentally remove connection details that are still in use.

Read technical notes →
Getting Started

Choosing a Server in Shadowrocket: Latency Tests, Regions, Protocol Types and What Latency Cannot Tell You

Compare entries in your existing node list by test method, region and protocol type. Distinguish latency from real-world performance, compare under the same network conditions, and verify the result with a specific task such as web browsing or sustained transfers.

Read technical notes →
Protocols

Protocols Supported by Shadowrocket: A Quick Look at Shadowsocks, VMess, VLESS, Trojan, WireGuard and Hysteria2

Learn what Type does in Add Server, then check the address, port and authentication details required by each protocol. The article explains field entry using existing parameters, helping distinguish protocol types from transport settings and avoid connection issues caused by mismatched fields.

Read technical notes →