Shadowrocket Official Site · Official Guide

Shadowrocket Setup Guide

Rule-based proxy client for multiple platforms: import an existing subscription and handle connections according to your configuration. iPhone / iPad: $2.99 one-time; Mac, Windows, Android and Linux versions are free.

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

GET SHADOWROCKET

2 access options

  • iPhone / iPad App Store, $2.99 one-time
  • Mac / Windows / Android / Linux Free
PROTOCOLS
  • Shadowsocks
  • VLESS
  • Hysteria2
Protocol parameters
GLOBAL ROUTING
  • Config
  • Proxy
  • Direct
  • Rule
Modes and match order

CAPABILITIES / CONFIGURATION

Rules, subscriptions and connection settings

First distinguish servers, configuration files and connection modes: a server determines where requests go, Config determines how rules are matched, and Global Routing determines whether those routing rules are used. The sections below explain each feature by what it operates on, so subscription updates are not confused with rule updates.

QUICK START / IPHONE & IPAD

First connection: import, choose a mode, verify

This preview uses iPhone / iPad interface terms and assumes you already have your own subscription or server information. First complete a manual connection that you can repeat. Then set up automatic updates, On Demand or configuration migration. This makes it easier to identify which layer is causing a problem.

  1. Add an existing server or subscription in Home

    First identify whether the details you received are for an individual server, a subscription link or a Config file. Import an existing subscription with Subscribe. For an individual server, select the correct Type in Add Server and enter Host, Port and authentication fields as provided. You can scan a QR code with Scan QR Code, but check the entry details after importing. Do not use an ordinary web address as a subscription URL or save a configuration file as a server entry.

    After saving, return to Home and check that a group or entry appears under SERVER. Select the server you want to use. If the list is empty, check that the link is complete, has no extra spaces and is reachable from the device. Do not add the same link repeatedly. Successful import only means the client read the information; it does not confirm that the server is currently available. Next, check the connection mode and test an actual request.

  2. Check Global Routing: Config, Proxy, Direct

    In Global Routing, the configuration, proxy and direct modes are Config, Proxy and Direct. For everyday rule-based handling, choose Config and make sure the expected file is selected on the Config page. To check briefly whether a problem comes from the rules, compare with Proxy or Direct. Proxy applies the proxy policy to requests managed by that mode; Direct connects directly. Neither mode proves that the rules are working correctly.

    Understand rule actions and rule conditions separately. DOMAIN-SUFFIX determines what to check; PROXY, DIRECT and REJECT determine what happens after a match. If a new rule has no effect, common causes include not using Config, editing a file that is not selected, or a broader rule above it matching first. Check these three points before changing the server or recreating a subscription, to keep the scope of changes small.

  3. Turn on the connection, then verify the request path

    After confirming the server and mode, turn on the connection switch at the top of Home. On first use, allow the system to add a VPN configuration when prompted. Once the system shows a connected status, open a page that normally works, then test a destination that should use the selected policy. Connectivity Test can provide clues about reachability, but its results are not the same as a complete visit to a website. Check actual requests and rule match logs together.

    If you cannot connect, check in this order: local network → server parameters → selected mode → rules and DNS. Temporarily disable automatic triggers and use one server and one configuration as a test baseline. If only some websites fail, focus on matching rules, domain resolution and relevant connection parameters. If all requests fail, first confirm that the device is online and the server is reachable. Recording what happens is more useful for finding the cause than repeatedly reinstalling.

Read the full tutorial →

OFFICIAL MANUAL / PURCHASE FACTS

App verification, pricing and purchase recovery

Shadowrocket is a closed-source commercial app. To verify the product, check the developer, official icon and app ID in the store. For desktop and Android installers, use this site's download page. Getting the client, managing configurations and using connection services you already have are separate matters and should be handled separately.

  • Developer Shadow Launch Technology Limited
  • App ID 932747118
  • iPhone / iPad: $2.99 one-time; other platforms are free

Check the developer, then the app ID

On the App Store product page, confirm the name is Shadowrocket, the developer is Shadow Launch Technology Limited and the icon matches the official icon shown on this site. The app ID in the product link should be 932747118. Similar names, icon colors or descriptions in search results are not enough to identify an app, and search ranking does not establish its identity. If any details do not match, return to the download page and open the product page again to verify.

The iPhone / iPad version costs $2.99 as a one-time App Store purchase. Mac, Windows, Android and Linux versions are free. Do not assume that a free store listing with the same name is the iPhone / iPad product described here. Check the price and developer together; the free access method for desktop and Android versions does not apply to store listings.

See app verification steps →

If Shadowrocket does not appear, check your store region

App Store visibility depends on the region of the account currently used with the App Store; it is not determined by system language, device location or browser language alone. If the app is unavailable in the mainland China store, repeatedly changing search terms will not resolve regional availability. Check which account is signed in to the App Store, then review its country or region in account settings. Decide whether to change regions based on your actual residence, payment method and the store's requirements.

Do not sign out of the iCloud account you use simply to find the app, and do not confuse the App Store sign-in with the account used for device syncing. If the store page opens but you cannot get the app, check payment prompts, system compatibility and account restrictions. For iPhone / iPad, check the App Store page for system requirements; do not rely only on a system version number in an older guide.

Read the App Store access guide →

Two price tiers and two access methods

The iPhone / iPad version costs $2.99 as a one-time App Store purchase, and both devices can use the same purchase record. Mac, Windows, Android and Linux versions are free. Other storefronts may display local currency; the amount charged is shown at checkout. A one-time purchase is how you get the client app; it does not change the usage period, traffic or service terms of a server you already have.

The two access methods also have different update paths: check for updates in the App Store on iPhone / iPad, and get the appropriate installer for desktop or Android from this site's download page. Keep a usable configuration before updating, then check the selected server, Global Routing and Config file afterward. The page reads the version dynamically, so you do not need to rely on an old number in an article to find an installer.

View pricing and access details →

Reinstalling on a new device and restoring a purchase

After changing or erasing an iPhone / iPad, look for Shadowrocket under “Purchased” in the App Store using the original purchase account. Redownloading with the same purchase record usually does not require another purchase. If the page still shows a price, check the account used to buy the app, the store region and the purchase record before paying again. A purchase record belongs to the store; it is separate from the server selected inside the client.

Reinstalling the app does not automatically restore its configuration. If the old device is still available, check iCloud sync and export important Config files separately. Keep subscription URLs and manually added server details safe as well. After restoring on a new device, confirm each item is present before allowing a system connection. Check the current App Store page and family settings for availability and terms of family sharing.

Read about reinstalling and restoring →

Desktop and Android: source, architecture and first launch

Get Shadowrocket installers for Mac, Windows, Android and Linux from this site's download page. Files are served through the /dl/shadowrocket/ path on this site. For Mac, choose Apple Silicon or Intel according to “About This Mac”; do not guess from the appearance or model name. On Linux, check which package format your distribution uses. If a downloaded file will not run, the installation method or executable permission may still need attention.

Installers are not code-signed, so the system may block them on first launch. After confirming the source, use “More info → Run anyway” for Windows SmartScreen, choose “Open Anyway” under “Privacy & Security” on Mac, or allow your current installation source to install unknown apps on Android. AppImage on Linux needs executable permission. More detailed prompts and commands are on the download page; do not follow them before confirming the file source.

See installation instructions for each system →

Back up configurations, subscriptions and diagnostics separately

Subscriptions provide a server list, Config stores rules and related settings, and Data and diagnostic logs help you review operation. Check each separately when backing up; exporting one configuration file does not mean all server credentials have been saved. Before editing or migrating, keep the usable state on the old device, then restore and verify items gradually in the new environment.

If a subscription update fails, first check that the existing link is complete and valid. For a connection failure, check server parameters and the network. If rules behave unexpectedly, check Config and match order. When describing a problem, you can include the system, steps, error message and checks already tried, but do not share subscription credentials, passwords or complete authentication links. Keeping notes organized by component helps prevent accidental deletion and duplicate setup.

Browse the FAQ by issue →

JOURNAL / PRACTICAL NOTES

Recent how-to guides

Browse by task: interface terminology identifies where to find controls, installation guides cover system prompts, and migration guides help preserve existing configurations before changing devices. Interface terms remain in English; the actual menu labels depend on the app version in use.

View all articles →