Shadowrocket Official Manual

ShadowrocketRule-Based Proxy User Guide

Shadowrocket is a cross-platform proxy client with multiple protocols and rule-based routing.

Current version v2.2.92 · iPhone / iPad: $2.99 one-time purchase on the App Store; Mac, Windows, Android, and Linux versions are free.

New to Shadowrocket? Follow the connection setup guide

ShadowsocksVMessVLESS TrojanHysteria2WireGuard

Downloads for all platforms

iPhone / iPad: $2.99 one-time purchase on the App Store. Mac (Apple Silicon and Intel), Windows, Android, and Linux versions are free. Choose your device, then check the system requirements, processor, or package format.

iPhone / iPad

$2.99 one-time purchase on the App Store. Check compatibility on the product page. To reinstall, use the original Apple Account and open your purchase history.

Mac

Free · Apple Silicon / Intel. Open About This Mac and match the download to the chip or processor listed there.

Windows

Free · x64. In Settings, open System → About and confirm that System type lists an x64-based processor, not just a 64-bit OS.

Android

Free · arm64. Confirm your device supports arm64 apps. If the download does not start in an in-app browser, open the link in your regular browser.

Linux

Free · deb / rpm / AppImage. Match the package to your distribution and processor architecture. Make the AppImage executable before opening it.

Rules & ConfigurationConnections & Diagnostics

Your subscription or server details determine which connections are available. The active configuration and Global Routing determine how requests are handled. A successful import doesn't mean a server is reachable, and turning the connection on doesn't mean every request goes through a proxy.

When adding a server manually, choose the matching Type—such as Shadowsocks, VMess, or VLESS—based on the details you have, then fill in the fields required by that protocol. Fields with similar names aren't interchangeable across protocols. The rule snippets below use example domains to illustrate matching behavior; they aren't server details you can import.

See the complete guide to rules and configuration →

First Connection: Import, Choose a Mode, Test

These steps use an iPhone / iPad as an example. Before you start, have your own subscription URL or the protocol, server address, port, and authentication details ready. With the connection switch off, open a website you can normally access as a baseline. If that test fails too, check the device's network before opening the client. Use a test destination you're authorized to access and whose normal behavior you know.

  1. Add your existing details in Home

    Open Add Server. If you have a subscription URL, choose Subscribe. If you have the details for a single server, select its Type first and enter each field separately; don't paste the address and port into the same field. After saving, return to the SERVER list, make sure the entry appears, and select the server you want to test. If the list is empty after import, first check that the URL is complete and the subscription is still active. Keep links containing authentication details on your own device; don't post them in public feedback.

  2. Select Config in Global Routing

    If you need different policies for different destinations, first check the active file in Config, then return to Home and set Global Routing to Config. Proxy and Direct can be used for comparison: Proxy tests the selected proxy route, while Direct checks what happens without that proxy. Note the original setting before switching. If the results differ, check the rule order in the active configuration. Don't mistake a comparison mode for a fixed routing configuration.

  3. Turn on the connection and test access

    Turn on the switch at the top of Home. When the system first asks to add a VPN configuration, confirm the request came from the Shadowrocket you're using, then follow the prompt. After connecting, check Connectivity Test, then open one destination expected to use a proxy and another expected to connect directly. If a destination fails, note the destination, mode, selected server, and what happened. Change only one thing before the next test so you can identify what fixed the issue instead of changing the server, DNS, and rules all at once.

Read the full setup guide → · Common connection issues

Verify the App and Check Purchase History

This is the Shadowrocket official website and manual. Shadowrocket is a closed-source commercial app. App Store purchase history, configuration files in the client, and connection details from a service provider are three separate things. Verify the app itself before buying. When switching devices, check separately whether you can redownload the app and whether your configuration is preserved.

Developer: Shadow Launch Technology Limited App ID: 932747118

Check the app ID first, then the developer and icon

Open the App Store product page from the download page. Check that the URL ends in id932747118, then verify that the listed developer is Shadow Launch Technology Limited. The icon should match the official icon shown at the top of this page: a white background with a blue-purple outline. App Store search may return similarly named apps, and their icons may look alike. Don't choose what to buy based only on search order or the icon. If any of these three details don't match, leave that listing and reopen the product page from the download page to check again.

If you search in the App Store on your device, check the developer on the listing's details page. To confirm the app ID, open the product page or copy its share link and check the number in the URL. A screenshot from a friend can help identify the app, but it can't confirm that you're viewing the same listing. Always verify the product page opened on your own device.

App Store availability depends on your account's storefront

Opening the US product page in a browser doesn't mean your device's App Store account is set to the US storefront. If the webpage shows the app but your device says it's unavailable in your country or region, first check the country or region of the purchasing account. There's no need to keep changing your device language or system time zone. The app isn't available in the mainland China storefront. If your account region has changed, follow Apple's account settings process and first check whether your balance, active subscriptions, Family Sharing, or other conditions affect the change.

The iPhone / iPad app is a one-time $2.99 purchase on the US App Store; prices and currencies may vary by storefront. Mac, Windows, Android, and Linux versions are free. Check the App Store product page for iPhone / iPad system requirements. If you plan to use the app on two devices, check compatibility for each one; being able to install it on one device doesn't mean the other meets the requirements.

After switching devices, check purchased apps before restoring your configuration

A one-time purchase on an App Store account can be used on compatible iPhone and iPad devices that meet the system requirements. To reinstall after switching or resetting a device, open Purchased in the App Store with the original purchasing account, find Shadowrocket, and download it again. If the product page shows a price instead of a redownload option, first check which account made the purchase and review the purchase history, then confirm availability in the current storefront. Don't pay again without checking.

Restoring from Purchased restores your entitlement to the app; it doesn't update server passwords or replace a configuration backup. If you can still use your old device, check which configuration is active and safely save any details you need to transfer. After installing on the new device, check the synced file contents or import your existing details again, then test a real connection from Home. Check for updates to the App Store version in the App Store.

Get free platform versions from this site's download page

Installers for Mac, Windows, Android, and Linux are distributed through this site's /dl/ path. To upgrade, return to the relevant platform card and select the package again rather than reusing an old saved link. Recheck the Mac processor, the Windows and Android architecture, and the Linux package format. Similar filenames don't mean packages are interchangeable. If you downloaded the wrong package, return to the download page and choose the right one; don't try to install it by renaming the file or running it repeatedly.

Save the configuration you're using before updating. If a system warning appears during first-time installation or launch, verify the file source, then use the installation instructions for your platform to decide whether to continue. On a device managed by your workplace or school, follow its device management policies. Don't change security settings for the entire device just to run one installer.

Technical Notes

Choose a guide based on the issue you're dealing with: first verify the app you obtained, then work out whether the traffic figures differ or the connection itself is unstable.

Getting the App

Several Shadowrocket listings in the App Store: verify the developer, icon, and app ID

In the App Store, check the developer name, Shadow Launch Technology Limited, the official icon, and app ID 932747118. Avoid apps with similar names. For Mac and Android, use only the installers provided on this site's download page.

For anyone opening an App Store listing from search results who hasn't yet confirmed it's the right app.

Usage Tips

Understanding Shadowrocket Data traffic statistics: server and app views explained

Learn what the upload, download, and total figures on the Data page measure; how to switch between server and app views; when the counters reset; and why they may differ from your carrier's usage figures.

Before comparing figures, confirm the time period covered. Traffic from the current test can't be compared directly with the total accumulated since the last reset.

Getting Started

Choosing a Shadowrocket server: latency tests, location, and protocol trade-offs

Learn how latency tests work and where they fall short, and how location and protocol features can affect your experience. A low latency figure doesn't always mean pages will load quickly; this guide offers practical ways to compare connections.

When comparing connections you already have, retest on the same device and network against the same destination. This helps avoid mistaking differences in test conditions for differences between servers.