Official site & guide

ShadowrocketiPad User Guide

Shadowrocket is a cross-platform client with rule-based routing. Import an existing server or subscription, then use your configuration to decide how requests are handled.

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

  • Global Routing
  • On Demand
  • VLESS

Routing

Match domain suffixes

Choose how requests are handled by rule in Config.

Read the setup guide

App Store

Two ways to get the app

Verify app ID 932747118 on the store product page; installers for other platforms are provided on this site.

How to verify the app

01 Platforms

Get Shadowrocket for your device

Choose a device, then check the download option for its system and processor. iPhone / iPad: a one-time $2.99 App Store purchase; Mac / Windows / Android / Linux: free, with installers available on this site's download page.

iPhone / iPad

On the store product page, verify the developer, icon, and app ID before checking compatibility. Refer to the App Store page for system requirements. To use the app on another compatible device with the same purchase account, first check your purchased items.

One-time App Store purchase: $2.99

Mac

Open About This Mac to see whether your computer has Apple silicon or an Intel processor, then choose the matching DMG. The model name and appearance do not identify the processor; check again when switching computers.

Free · Apple silicon / Intel

Windows

The download page provides a 64-bit installer. Before downloading, check the system type in your device specifications. If Windows displays a warning, return to the download page to verify the file source, then read the relevant instructions for allowing it.

Free · 64-bit

Android

Choose the arm64 installer for your device architecture. If the in-app browser does not start the download, reopen this site's download page in your system browser. If Android requests permission, verify the source first, then see the download page for installation permission instructions.

Free · arm64

Linux

Choose deb or rpm according to your distribution's package manager, or see the AppImage option. Check your distribution and processor architecture first; the download page also explains how to grant execution permission to an AppImage.

Free · deb / rpm / AppImage

Desktop and Android installers are available at /dl/shadowrocket/ on this site. If you see a system prompt on first launch, confirm that you are in the section for your platform and have selected the correct architecture, then follow the installation guidance. Installing the app and configuring a connection are separate steps: you only need your own server details or subscription link after opening the app.

View all platforms

02 Capabilities

Connections, rules, and configuration

Server entries define connection destinations; Global Routing determines how requests are handled. Understand these two layers first, then check the interface options below. See the technical reference for protocol parameters and when to use them.

Routing

Use rules to decide how requests are handled

In Home, select Config under Global Routing to handle requests using the rules in the active configuration. Proxy and Direct set the handling mode to proxy or direct, respectively. To route a particular domain differently, check the matching conditions and rule order in Config, then review the final FINAL rule. If a request is routed unexpectedly, confirm the actual domain visited and the matching rule instead of relying only on the page name in the address bar.

DOMAIN-SUFFIX,example.com,PROXY FINAL,DIRECT

If general browsing and one app behave differently, first check the current Global Routing selection, then review the rules affecting that destination in Config. Adjust a rule for an individual destination only after confirming that the connection is stable and the correct configuration file is active.

View proxy mode details

03 Quick start

First setup and connection test

The steps below use the iPhone and iPad interface as examples. Prepare your own server details or subscription link, then connect manually once. Set up automatic connections only after confirming the basic configuration works.

  1. Add a server or subscription

    Open Home and go to Add Server. To add one server manually, select the Type that matches the server, then enter its Host, Port, and required protocol fields. For an existing subscription link, select Subscribe. After saving, return to SERVER, check that the entry appears, and select the entry you want to test.

    If saving succeeds but the list is empty, check whether the link is complete and the group is expanded. A visible entry only means the client read the configuration; use the next step and a connection test to confirm it works.

  2. Choose Global Routing

    To handle requests by rule, select Config and confirm the active configuration file. For troubleshooting, compare Proxy and Direct for the same destination. Use the same server, network, and destination so you can attribute any difference to the mode rather than another changed condition.

    If Proxy works but Config does not behave as expected, check whether a rule matches and whether an earlier rule takes precedence. If both modes fail, check the server address, port, and protocol parameters. Switch back to your intended mode when testing is complete.

  3. Connect and check the result

    Turn on the connection switch in Home. On first use, follow the system prompt to confirm adding the required VPN configuration, then return to the app and check the connection status. Run Connectivity Test, then visit a familiar destination to see whether the result matches the selected mode or rules.

    If the connection switch is on but a destination is unreachable, note the current mode, selected entry, and failure symptoms. Confirm that the system network itself works, then test one item at a time; do not change the server, network, and rules all at once. Enable On Demand or adjust automatic triggers only after validating the connection.

When troubleshooting, note whether the issue occurs during import, saving, connection, or actual access. Each stage requires different checks. Identifying where the failure occurs before changing settings is usually more effective than clearing the configuration and starting over.

View the full guide

04 Verification

Verify the app and restore a purchase

Verify the product identity in the store and the installer source on this site's download page. Updates and reinstallations also differ by platform.

  • Developer: Shadow Launch Technology Limited
  • App ID 932747118
  1. Check the icon, developer, and app ID

    On the App Store product page, verify three details: the product icon matches the official icon shown here, the developer is Shadow Launch Technology Limited, and the product page URL ends in id932747118. The white background and blue-purple outline help identify the icon, but a similar icon or name is not a substitute for checking the other two details.

    If you arrive from search results, open the product details before checking rather than relying on the thumbnail. If the product page is available, review compatibility before installing on your device. For iPhone / iPad system requirements, refer to the App Store page.

  2. If you cannot find it, check your App Store account region

    The App Store displays available apps according to the country or region of your account. Changing the system language, device region format, or current network does not change the account's store region. If the app does not appear in the mainland China store, open Media & Purchases for your current account in device settings and check its country or region, then consider any message shown on the product page.

    Being able to open the product page on the web does not mean the app is available for purchase in your account's store. If the product ID is correct but the store says it is unavailable in your region, follow the information shown by your current store. Search results with similar names are not the same product listing.

  3. Restore an existing purchase after changing devices or reinstalling

    Shadowrocket is closed-source commercial software. iPhone / iPad: a one-time $2.99 App Store purchase; outside the US, check the price shown in your store. Mac / Windows / Android / Linux: free. iPhone and iPad share the same App Store purchase record: sign in to the store with the original purchase account, find Shadowrocket in purchased items, and download it to a compatible device.

    If the download option is missing, check whether Media & Purchases is using the original purchase account, then review the current store and device compatibility. Restoring the app is different from restoring its configuration: while the old device is available, check your sync settings and save any server details and configuration files you need. App Store updates are also available in the App Store.

  4. Separate the app purchase from connection services

    An app purchase is not a connection plan. An App Store purchase record applies to the app; it does not create a server account or subscription link. This site does not provide, sell, or recommend nodes or subscriptions. If you already have a service provider, enter the configuration values they supplied. Reinstalling the app does not require you to obtain another connection service just to import it again.

    If the app opens but an existing subscription will not refresh, first check whether that subscription is still available. Connection failures and purchase records are separate issues: troubleshoot the former through the server and configuration, and check the latter through your App Store account and purchased items.

  5. Get updates for other platforms from this site's download page

    Installers for Mac, Windows, Android, and Linux are available at /dl/shadowrocket/ on this site. To update or reinstall, return to the all-platforms download page and choose an installer for your device. In particular, if switching from an Intel Mac to an Apple silicon model or moving between Linux distributions, select the matching file again rather than reusing an installer from the previous device.

    Before updating, note the configuration file and connection method you currently use. After updating, verify a known working connection before restoring other settings. If anything changes, this makes it easier to identify whether the cause is the app, configuration, or server.

05 Reading

Recent technical articles

Find guidance by issue: enter protocol parameters, restore an App Store purchase, or check whether background connections are being rebuilt frequently.