Official manual · App Store listing

Shadowrocket
Configuration and connection guide

A rule-based proxy client for iPhone and iPad, available as a one-time purchase through the App Store. Import your existing server details and route traffic by rules.

  • Shadowsocks
  • VMess
  • Trojan
  • Global Routing

The abstract geometry above represents connections and routing, not the app interface. Refer to the tutorials and interface guide below for actual operation.

Features and navigation

Shadowrocket rule index

Before changing settings, distinguish servers, configuration files, and the system connection. Servers determine where requests are forwarded; Config determines which policy handles each request; the system VPN configuration routes eligible traffic into the app.

Match a target, then apply a policy

Rule-based routing sends different destinations to different policies. In Config, check which configuration is active, then review the entries under [Rule]. Rules are generally evaluated from top to bottom: put narrower conditions first, broader ones later, and use FINAL as the fallback. DOMAIN-SUFFIX matches a domain and its subdomains; IP-CIDR matches an IP range. PROXY, DIRECT, and REJECT send traffic through a proxy, connect directly, or block it. After making changes, check which rule matched the actual request—whether a page loads is not enough to confirm routing.

[Rule]
DOMAIN-SUFFIX,example.com,PROXY
IP-CIDR,192.168.0.0/16,DIRECT
FINAL,DIRECT

Choosing among the three Global Routing options

For everyday domain- or IP-based routing, confirm the configuration file first, then select Config. To check whether a problem is related to rules, you can temporarily compare Proxy and Direct after considering the impact, then restore the original setting. These are routing options, not server quality ratings. Changing modes will not fix an incorrect password, port, or TLS setting, and purchasing the app does not include network service.

In rule references, PROXY and DIRECT are configuration policy keywords; Proxy and Direct in the interface are option names. Keep their capitalization and context in mind so you do not confuse configuration syntax with interface controls.

Devices and the App Store

Getting Shadowrocket on iPhone and iPad

Shadowrocket is available only through the App Store. Open the product page and verify the app, then check device compatibility and payment details. Refer to the App Store listing for system requirements and purchase eligibility.

iPhone

Use your own Apple ID to find and purchase Shadowrocket in the App Store. After installation, prepare your existing subscription or server details, then approve the system VPN configuration when prompted during the first connection.

If you cannot find the app in the store, check which storefront your account uses and whether the product page is available there. Search results, your device’s system language, and the storefront region are different things; do not identify the app by its name in search results alone.

iPhone guide

iPad

You can check previous purchases in the App Store using the same Apple ID. Refer to the App Store listing for details on purchase eligibility across devices.

On a wider screen, lists and details may appear in a different layout, but you still need to check the selected server, Config, and connection status separately. Getting the app again does not necessarily restore subscriptions and configurations, so review each one before connecting.

iPad guide

Before using the app for the first time, confirm with your service provider that your existing details are still valid. A purchase record shows that you acquired the client; it does not tell you whether a server is reachable.

First-time setup

Import, choose a mode, and test the connection

Start with the fewest settings needed to establish a connection you can verify, then add your routing requirements one step at a time. Keep a checkpoint at each stage so you can identify where a problem occurs instead of repeatedly changing every option.

  1. 01 / Add Server

    Add an existing server or subscription

    Prepare your existing subscription link, QR code, or server details. In Add Server, choose the matching type, or use Scan QR Code to scan a QR code you already have. After importing, confirm that the entry name, protocol, and address match the original details, then select the server you want to test.

    Copy the entire subscription link, including all characters, and watch for extra spaces or line breaks. When entering details manually, check Port, authentication, and transport settings one by one. Do not infer other fields from the protocol name. A successful import only means the details were accepted; you still need to test the connection.

  2. 02 / Global Routing

    Confirm the active mode and configuration

    To route traffic by rules, select Config and confirm that the expected file is active. Start with rules for the specific destination, then check the FINAL fallback policy. If you are unsure what an existing configuration does, save a copy and review its purpose before making changes. Do not overwrite settings you rely on.

    If you only want to test a server, note the routing mode used for the test. Otherwise, a request may use DIRECT and make it appear that the server is working. Record the mode, server, and destination together so you can compare results.

  3. 03 / Connectivity Test

    Authorize the connection and check real requests

    Turn on the connection switch. The first time, the system will ask to add a VPN configuration. Confirm that you are setting up Shadowrocket, then follow the system prompts to authorize it. Run Connectivity Test and visit a specific destination. Check the connection records and changes in Data to assess the result.

    If the connection fails, first confirm that your current network works, then check the server details, system time, and which rule matched. A VPN status in the system does not mean every request is using a proxy. Verify a specific request rather than relying on a status icon alone.

View the full guide →

App identity and purchase details

Verify the app, then understand what the purchase covers

Shadowrocket Docs · Official Manual is the official Shadowrocket website and manual. It explains how to get the app, import existing details, and use rules. Shadowrocket is a closed-source commercial app; use its App Store product page to verify the app identity, price, compatibility, and purchase details.

  • App ID 932747118
  • Available on the App Store
  • One-time purchase

Verify the developer, icon, and app ID together

On the product page, check the name Shadowrocket and the developer, Shadow Launch Technology Limited, then verify the official icon and id932747118 in the link. The icon should match the official icon in this site’s header. The app name or its position in search results alone is not enough to confirm its identity; check the developer and app ID too.

The app ID is a fixed identifier in the product page URL, not an order number or server account. Check all three details before proceeding to payment to avoid mistaking another product for Shadowrocket. The page layout and the location of these details may vary, so refer to the current App Store page.

Store availability and account region

What you see in the App Store depends on the storefront used by your purchase account. Shadowrocket is not available in the mainland China storefront. If it does not appear in search, first check the country or region associated with your account, then review the product page. Using your device in Chinese, being in a particular location, or changing the system language does not indicate which storefront your account uses.

Your account region may affect payment methods, balance, and previous purchases; follow the information shown on your Apple Account page. Do not assume that missing search results mean your device has a problem, and do not change Shadowrocket settings to troubleshoot an App Store issue. Getting the app from the store and connecting through the app are separate steps.

Purchases, reinstalling, and moving to a new device

The one-time purchase covers use of the client. The US storefront lists it at around $2.99; prices appear in local currency in other storefronts, and the final amount is shown at checkout. Before using a previous purchase on iPhone or iPad, make sure you are signed in with the Apple ID used to buy it. Refer to the App Store listing for purchase eligibility and sharing terms.

If you reinstall the app or change devices, look for it in your App Store purchase history. Getting the app again and restoring server details are separate tasks: check existing subscriptions, manually added entries, configuration files, and settings individually. Before and after using iCloud sync, confirm what was actually transferred. Keep a recoverable copy of important configurations; purchase history is not a data backup.

App purchase ≠ network service plan

Payment for the app and your existing network service are managed separately. Buying Shadowrocket does not create a server, subscription, or authentication details. Before connecting, prepare your existing information and confirm that it is valid. This site does not provide, sell, or recommend servers or subscriptions; it explains how to import and use information you already have.

Likewise, a successful subscription update does not change the app’s purchase status, and an inactive server does not mean you need to buy the app again. First identify which layer is involved: the App Store handles purchases and app updates; your service provider’s details determine server settings and validity; Config and Global Routing determine how requests are handled.

More to read

Connection and settings guides

These three guides cover connection timeouts, background connections, and first-time authorization. Start by identifying where the problem occurs, then check each item in the same order to avoid masking the cause with unrelated settings.

View all articles →