Official manual · App access and connection setup

Shadowrocket Guide and Troubleshooting

A cross-platform rules-based proxy client for importing existing servers or subscriptions and routing traffic by rules; iPhone / iPad: a one-time $2.99 App Store purchase; Mac, Windows, Android, and Linux versions: free.

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

View the first-connection guide

  • VLESS
  • Shadowsocks
  • Global Routing

For example, to proxy only a few sites, place specific DOMAIN-SUFFIX rules before broader rules in Config, then use FINAL,DIRECT at the end for unmatched requests. First create a connection to one destination that should use PROXY and another that should use DIRECT. A webpage loading successfully does not confirm which route it used. If the result differs from what you expect, check the active file, rule order, and domain in the actual request first.

Get Shadowrocket by device

iPhone / iPad: a one-time $2.99 App Store purchase. Mac (Apple Silicon or Intel), Windows, Android, and Linux versions are free; installers are available from this site's /dl/shadowrocket/ directory. Device cards prioritize the platform detected on your device. If you are preparing an installer for another device, choose its platform and architecture.

First connection: import, choose a mode, and test

The steps below use the iPhone / iPad interface as an example. Before starting, disconnect the client and open a page that normally works on the current network to confirm basic connectivity. Then prepare your own subscription link, server QR code, or details for manual entry, such as the protocol, host, and port. These are different ways to provide the same information; you do not need to add the same server more than once.

  1. Add existing details in Add Server

    Open Home and start the process from Add Server. If your provider gave you a subscription link, import it using Subscribe. For a server QR code, use Scan QR Code. If you only have text details, select Type first and fill in each field. Return to Home and confirm the new entry in the SERVER list, then select one server for the first test. Seeing a name in the list is not enough: if there are entries with the same name, open the details and check the protocol and address to avoid testing an old record by mistake.

  2. Choose a mode in Global Routing

    If you have a routing configuration ready to use, select Config and check the active file in Config. For a short-term proxy path check, use Proxy; to check access without a proxy, use Direct. This setting controls how traffic is handled; it does not replace an imported server or turn the connection on. For comparisons, keep the server and test destination fixed and change only the mode. When finished, switch back to the mode you normally use.

  3. Start the connection from Home and test an actual request

    Turn on the connection switch at the top of Home. When the system first asks to add a VPN configuration, confirm that the prompt was triggered by your action, then follow the system instructions. If the switch turns off immediately, check system permissions and any existing VPN status. If the connection stays on but access fails, first test a known working route, then check Connectivity Test, routing mode, and the current network. If only one domain fails, do not assume that all servers are affected.

When documenting an issue, note the connection switch state, network in use, Global Routing option, and affected destination. Change networks, servers, or configuration separately; retry the same action after each change to identify what affected the result. Before sharing troubleshooting notes, remove account details, subscription links, and server credentials.

Verify the app, purchase, and restore it

Shadowrocket is a closed-source commercial app. To verify the iPhone / iPad version, check the developer, icon, and app ID in the store listing. For installers on Mac, Windows, or Android, use the relevant platform section on this site's download page. These channels are for different devices; a phone store purchase record does not determine whether the app can be installed on a computer or Android device.

Check the App Store storefront and listing

Open the product page from this site's App Store access guide. Confirm that the developer is Shadow Launch Technology Limited, the page URL ends in id932747118, and the icon has a white background with a blue-purple outline. If the name or icon looks similar, do not skip checking the developer and app ID; search ranking does not verify a listing's source. Check the App Store page for system requirements and compatible devices.

If the listing does not appear in search or the product page says it is unavailable in the current storefront, first check the region of the account used for App Store purchases. Device language, time zone, and physical location do not determine the storefront region. Product availability and currency can differ between storefronts; use the page shown to the current account as the reference. If you need to change the account region, first check the displayed balance, subscriptions, and payment requirements, then follow the account settings instructions.

One purchase can be used on iPhone and iPad

The iPhone / iPad version is a one-time $2.99 purchase in the US App Store. The Mac (Apple Silicon and Intel), Windows, Android, and Linux versions are free. The purchase belongs to the account used for the store purchase, not the device where the app was first installed. On another iPhone or iPad that meets the system requirements, sign in with the same purchase account and find the app in your purchased items.

If the store shows a purchase button instead of a redownload option during reinstallation, do not buy the app again immediately. Check whether the current store account is the original purchase account, search for the app by name in purchased items, and confirm that the listing has the same app ID. Restoring a purchase and restoring local settings are separate tasks: after reinstalling the app, check Config, SERVER, and Global Routing. If your details are not restored, import your saved configuration or your own subscription again. See the guide to restoring a purchase for the steps.

Distinguish app updates from subscription refreshes

App updates for iPhone / iPad are provided by the App Store. To update the Mac, Windows, Android, or Linux version, return to this site's download page and select the same platform and an installer for your device's architecture. An app update changes the client; a subscription refresh updates server entries provided by your provider. Save your current configuration before updating. Afterward, check the selected entry, rules file, and mode before deciding whether to refresh a subscription, so you do not change multiple conditions at once.

Connection and network guides

If the connection switch is already on, the next step depends on the symptom: check rules if only some domains fail; distinguish DNS resolution from server reachability when lookups are unstable; if you have not completed the first connection, start with the VPN configuration prompt and the status in Home.